Spec-Zone.ru › Ansible 2.4

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
  • absent
  • downgrade
  • latest
  • present
  • reinstalled
Состояние пакета в системе.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API