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	absent downgrade latest present ← reinstalled	Состояние пакета в системе.
timeout (добавлен в 2.3)	По умолчанию: 2700	Время, отводимое для завершения работы Chocolatey, прежде чем произойдёт таймаут. алиасы: execution_timeout
upgrade	Варианты: нет ← да	Если пакет уже установлен, попытаться обновить его до последней версии или до указанной версии. С версии Ansible v2.3 это устарело, установите параметр `state` в `latest`, чтобы получить тот же результат.
version		Указать конкретную версию пакета для установки. Игнорируется, когда `state` установлено в `absent`.

Примечания

Примечание

Укажите значение параметра 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, которое нельзя запустить удалённо.

Примеры

- 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
    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 str	изменено, задача choco вернула ошибку	УСТАРЕЛО, будет удалено в 2.6, используйте stdout вместо этого. Пример: Chocolatey upgraded 1/1 packages.
choco_error_cmd str	изменено, задача choco вернула ошибку	УСТАРЕЛО, будет удалено в 2.6, используйте command вместо этого. Пример: choco.exe install -r --no-progress -y sysinternals --timeout 2700 --failonunfound
choco_error_log str	изменено, задача choco вернула ошибку	УСТАРЕЛО, будет удалено в 2.6, используйте stdout вместо этого. Пример: sysinternals not installed. The package was not found with the source(s) listed
command str	изменено	Полная команда, используемая в задаче Chocolatey. Пример: choco.exe install -r --no-progress -y sysinternals --timeout 2700 --failonunfound
rc int	изменено	Код возврата из задачи Chocolatey.
stdout str	изменено	stdout из задачи Chocolatey. Уровень подробности сообщений зависит от настроек уровня подробности Ansible, см. заметки для получения дополнительных сведений. Пример: Chocolatey upgraded 1/1 packages.

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.

Автор

Trond Hindenes (@trondhindenes)
Peter Mounce (@petemounce)
Pepe Barbe (@elventear)
Adam Keech (@smadam813)
Pierre Templier (@ptemplier)

Подсказка

Если вы заметили какие-либо проблемы в данной документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_chocolatey_module.html