win_chocolatey - Управление пакетами с помощью Chocolatey

Новая версия 1.9.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Управление пакетами с помощью Chocolatey (http://chocolatey.org/).
Если Chocolatey отсутствует в системе, модуль установит его.
Список пакетов можно найти на http://chocolatey.org/packages.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

chocolatey >= 0.10.5 (будет обновлен, если версия старее)

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allow_empty_checksums bool (добавлен в 2.2)	Варианты: нет ← да	Разрешить использование пустых контрольных сумм.
allow_prerelease bool (добавлен в 2.6)	Варианты: нет ← да	Разрешить установку предварительных версий пакетов. Если состояние `state` равно `latest`, будет установлена последняя предварительная версия пакета.
force bool	Варианты: нет ← да	Принудительная установка пакета (даже если он уже существует). Использование `force` заставит Ansible всегда сообщать о внесенных изменениях.
ignore_checksums bool (добавлен в 2.2)	Варианты: нет ← да	Игнорировать контрольные суммы.
ignore_dependencies bool (добавлен в 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 bool (добавлен в 2.4)	Варианты: нет ← да	Не запускать скрипты chocolateyInstall.ps1 или chocolateyUninstall.ps1.
source		Укажите источник, а не использовать репозиторий Chocolatey по умолчанию.
state	Варианты: отсутствует снижение последняя версия настоящий ← переустановлен	Состояние пакета в системе.
timeout (добавлен в 2.3)	По умолчанию: 2700	Время, предоставляемое Chocolatey для завершения перед отключением таймера. псевдонимы: execution_timeout
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:
  - procexp
  - putty
  - windirstat

- name: uninstall multiple packages
  win_chocolatey:
    name: '{{ item }}'
    state: absent
  with_items:
  - procexp
  - putty
  - 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

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
command str	changed	Полная команда, используемая в задаче Chocolatey. Пример: choco.exe install -r --no-progress -y sysinternals --timeout 2700 --failonunfound
rc int	changed	Код возврата из задачи Chocolatey.
stdout str	changed	Вывод stdout из задачи Chocolatey. Уровень подробности сообщений зависит от настроек подробности Ansible, см. примечания для получения дополнительных сведений. Пример: Chocolatey upgraded 1/1 packages.

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/win_chocolatey_module.html