win_chocolatey - Управление пакетами с помощью Chocolatey
Новое в версии 1.9.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Управление пакетами с помощью Chocolatey (http://chocolatey.org/).
- Если Chocolatey отсутствует в системе, модуль установит его.
- Список пакетов можно найти по адресу http://chocolatey.org/packages.
Требования (к хосту, на котором выполняется модуль)
- chocolatey >= 0.10.5 (будет обновлён, если версия старше)
Параметры
| параметр | обязательно | значение по умолчанию | выбор | примечания |
|---|---|---|---|---|
| allow_empty_checksums (добавлено в 2.2)
| нет | нет |
| Разрешить использование пустых контрольных сумм. |
| force | нет | нет |
| Принудительная установка пакета (даже если он уже существует). Использование force заставит Ansible всегда сообщать о внесённых изменениях. |
| ignore_checksums (добавлено в 2.2)
| нет | нет |
| Игнорировать контрольные суммы. |
| ignore_dependencies (добавлено в 2.1)
| нет | нет |
| Игнорировать зависимости, устанавливать/обновлять только сам пакет. |
| install_args (добавлено в 2.1)
| нет | Аргументы для передачи в системный установщик. | ||
| name | да | Имя устанавливаемого пакета. Это должно быть имя одного пакета. | ||
| params (добавлено в 2.1)
| нет | Параметры для передачи пакету | ||
| proxy_password (добавлено в 2.4)
| нет | Пароль прокси, используемый для установки Chocolatey и пакета. См. примечания в proxy_username при работе с двойными кавычками в пароле. | ||
| proxy_url (добавлено в 2.4)
| нет | URL прокси, используемый для установки Chocolatey и пакета. | ||
| proxy_username (добавлено в 2.4)
| нет | Имя пользователя прокси, используемый для установки Chocolatey и пакета. При работе с именем пользователя, содержащим символы двойных кавычек ", их необходимо экранировать \ заранее. Смотрите примеры для получения более подробной информации. | ||
| skip_scripts (добавлено в 2.4)
| нет | нет |
| Не запускать скрипты chocolateyInstall.ps1 или chocolateyUninstall.ps1. |
| source | нет | Укажите источник вместо использования стандартного хранилища Chocolatey. | ||
| state | нет | present |
| Состояние пакета в системе. |
| timeout (добавлено в 2.3)
| нет | 2700 | Время ожидания завершения работы Chocolatey до истечения срока. псевдонимы: execution_timeout | |
| upgrade | нет | нет |
| Если пакет уже установлен, попытаться обновить его до последней версии или до указанной. Начиная с Ansible v2.3, это устарело, установите параметр state в latest, чтобы получить тот же результат. |
| version | нет | Конкретная версия пакета для установки. Игнорируется, когда state установлено в absent. |
Примеры
- name: Install git
win_chocolatey:
name: git
state: present
- name: Upgrade installed packages
win_chocolatey:
name: all
state: latest
- name: Install notepadplusplus version 6.6
win_chocolatey:
name: notepadplusplus.install
version: '6.6'
- name: Install git from specified repository
win_chocolatey:
name: git
source: https://someserver/api/v2/
- name: Uninstall git
win_chocolatey:
name: git
state: absent
- name: Install multiple packages
win_chocolatey:
name: '{{ item }}'
state: present
with_items:
- pscx
- windirstat
- name: uninstall multiple packages
win_chocolatey:
name: '{{ item }}'
state: absent
with_items:
- pscx
- windirstat
- name: Install curl using proxy
win_chocolatey:
name: curl
proxy_url: http://proxy-server:8080/
proxy_username: joe
proxy_password: p@ssw0rd
- name: Install curl with proxy credentials that contain quotes
win_chocolatey:
name: curl
proxy_url: http://proxy-server:8080/
proxy_username: user with \"escaped\" double quotes
proxy_password: pass with \"escaped\" double quotes
- name: Install a package that requires 'become'
win_chocolatey:
name: officepro2013
become: yes
become_user: Administrator
become_method: runas
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| choco_bootstrap_output | УСТАРЕЛО, будет удалено в 2.6, используйте stdout вместо этого. | изменилось, задача choco вернула ошибку | строка | Chocolatey обновил 1/1 пакетов. |
| choco_error_cmd | УСТАРЕЛО, будет удалено в 2.6, используйте command вместо этого. | изменилось, задача choco вернула ошибку | строка | choco.exe install -r --no-progress -y sysinternals --timeout 2700 --failonunfound |
| choco_error_log | УСТАРЕЛО, будет удалено в 2.6, используйте stdout вместо этого. | изменилось, задача choco вернула ошибку | строка | sysinternals не установлен. Пакет не найден в указанном источнике. |
| command | Полная команда, используемая в задаче chocolatey. | изменилось | строка | choco.exe install -r --no-progress -y sysinternals --timeout 2700 --failonunfound |
| rc | Код возврата задачи chocolatey. | изменилось | целое число | 0 |
| stdout | stdout от задачи chocolatey. Уровень детализации сообщений зависит от уровня подробности Ansible, см. примечания для получения более подробной информации. | изменилось | строка | Chocolatey обновил 1/1 пакетов. |
Примечания
Примечание
- Укажите значение параметра
versionв виде строки (например,'6.1'), иначе оно будет рассматриваться как число с плавающей точкой и в зависимости от локали может стать6,1, что приведёт к ошибке. - При использовании уровня подробности 2 или меньше (
-vv) выводstdoutбудет ограничен. - При использовании уровня подробности 4 (
-vvvv) выводstdoutбудет более подробным. - При использовании уровня подробности 5 (
-vvvvv) выводstdoutбудет включать отладочную информацию. - Этот модуль установит или обновит Chocolatey при необходимости.
- Некоторые пакеты требуют интерактивного входа пользователя для установки. Вы можете использовать (
become) для достижения этого. - Даже если вы подключаетесь как локальный администратор, использование (
become) для перехода в режим администратора предоставит вам интерактивный вход пользователя, смотрите примеры ниже. - Используйте (win_hotfix) для установки исправлений вместо (win_chocolatey), так как (win_hotfix) избегает использования wusa.exe, который нельзя запускать удалённо.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет иметь обратную совместимость.
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочтите Справочную информацию по сообществу и участию в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_chocolatey_module.html