Spec-Zone.ru › Ansible 2.7

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

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

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Описание

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

Требования

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

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
allow_empty_checksums
boolean
добавлен в 2.2
    Варианты:
  • нет ←
  • да
Разрешить использование пустых контрольных сумм для загружаемых ресурсов из небезопасных мест.
Используйте win_chocolatey_feature с именем allowEmptyChecksums для глобального управления этим параметром.
allow_prerelease
boolean
добавлен в 2.6
    Варианты:
  • нет ←
  • да
Разрешить установку предварительных версий пакетов.
Если состояние равно latest, будет установлена последняя предварительная версия пакета.
architecture
-
добавлен в 2.7
    Варианты:
  • по умолчанию ←
  • x86
Вынудить Chocolatey установить пакет определенной архитектуры процессора.
Установив x86, гарантируется, что Chocolatey установит пакет x86, даже если ОС имеет архитектуру x64.
force
boolean
    Варианты:
  • нет ←
  • да
Вынуждает установку пакета, даже если он уже установлен.
Использование force заставит Ansible всегда сообщать о внесении изменений.
ignore_checksums
boolean
добавлен в 2.2
    Варианты:
  • нет ←
  • да
Игнорировать контрольные суммы, предоставляемые пакетом.
Используйте win_chocolatey_feature с именем checksumFiles для глобального управления этим параметром.
ignore_dependencies
boolean
добавлен в 2.1
    Варианты:
  • нет ←
  • да
Игнорировать зависимости, устанавливать/обновлять только сам пакет.
install_args
string
добавлен в 2.1
Аргументы для передачи системному установщику.
Это аргументы, которые передаются непосредственно установщику пакета Chocolatey. Это, как правило, расширенный параметр.
name
list / обязательно
Имя(я) пакета(ов) для установки.
Установите значение all для выполнения действия со всеми установленными пакетами.
package_params
string
добавлен в 2.1
Параметры для передачи пакету.
Это параметры, специфичные для пакета Chocolatey, и они обычно документируются самим пакетом.
До Ansible 2.7 этот параметр был просто params.

псевдонимы: params
proxy_password
string
добавлен в 2.4
Пароль прокси-сервера, используемый для установки Chocolatey и пакета.
Это значение доступно в качестве аргумента командной строки, и любой привилегированный аккаунт может увидеть это значение при работе модуля с Chocolatey. Определите пароль на глобальном уровне конфигурации с помощью win_chocolatey_config с именем proxyPassword для избежания этого.
proxy_url
string
добавлен в 2.4
URL прокси-сервера, используемый для установки Chocolatey и пакета.
Используйте win_chocolatey_config с именем proxy для глобального управления этим параметром.
proxy_username
string
добавлен в 2.4
Имя пользователя прокси-сервера, используемый для установки Chocolatey и пакета.
До Ansible 2.7 пользователям с двойными кавычками " необходимо было экранировать их \ заранее. Это больше не требуется.
Используйте win_chocolatey_config с именем proxyUser для глобального управления этим параметром.
skip_scripts
boolean
добавлен в 2.4
    Варианты:
  • нет ←
  • да
Не запускать скрипты chocolateyInstall.ps1 или chocolateyUninstall.ps1 при установке пакета.
source
string
Укажите источник для получения пакета.
Используйте win_chocolatey_source для управления глобальными источниками.
Это значение может быть URL-адресом Chocolatey-фида, путем к папке, содержащей пакеты .nupkg, или именем источника, определенного с помощью win_chocolatey_source.
Это значение также используется, когда Chocolatey не установлен, в качестве расположения скрипта install.ps1. В этом случае поддерживаются только URL-адреса.
source_password
string
добавлен в 2.7
Пароль для source_username.
Это значение доступно в качестве аргумента командной строки, и любой привилегированный аккаунт может увидеть это значение при работе модуля с Chocolatey. Определите учетные данные с помощью источника с win_chocolatey_source для избежания этого.
source_username
string
добавлен в 2.7
Имя пользователя для использования с source при доступе к фиду, требующему аутентификацию.
Рекомендуется определять учетные данные в источнике с помощью win_chocolatey_source, а не передавать их для каждой задачи.
state
string
    Варианты:
  • absent
  • downgrade
  • latest
  • present ←
  • reinstalled
Состояние пакета в системе.
При значении absent, гарантируется, что пакет не установлен.
При значении present, гарантируется, что пакет установлен.
При значении downgrade, Chocolatey может понизить версию пакета, если version старше установленной версии.
При значении latest, гарантируется, что пакет установлен на последнюю доступную версию.
При значении reinstalled, пакет будет удален и переустановлен.
timeout
integer
добавлен в 2.3
Значение по умолчанию:
2700
Время, отводимое Chocolatey на завершение работы перед отключением из-за истечения времени ожидания.

псевдонимы: execution_timeout
validate_certs
boolean
добавлен в 2.7
    Варианты:
  • нет
  • да ←
Используется при загрузке скрипта установки Chocolatey, если Chocolatey еще не установлен. Это не влияет на процесс установки пакета Chocolatey.
При значении no, сертификаты SSL не будут проверяться.
Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверенных сертификатов.
version
string
Укажите конкретную версию пакета для установки.
Игнорируется, когда state задано на absent.

Примечания

Примечание

  • Укажите значение параметра version в виде строки (например, '6.1'), иначе оно рассматривается как число с плавающей точкой, и в зависимости от региональных настроек может быть интерпретировано как 6,1, что приведёт к ошибке.
  • При использовании уровня подробности 2 или меньше (-vv) вывод stdout будет ограничен.
  • При использовании уровня подробности 4 (-vvvv) вывод stdout будет более подробным.
  • При использовании уровня подробности 5 (-vvvvv) вывод stdout будет включать отладочную информацию.
  • Этот модуль будет устанавливать или обновлять Chocolatey при необходимости.
  • Некоторые пакеты, такие как исправления или обновления, требуют интерактивного входа пользователя для установки. Для этого можно использовать (become) , см. Понимание повышения привилегий.
  • Даже если вы подключаетесь как локальный администратор, использование (become) для повышения до администратора обеспечит интерактивный вход пользователя, см. примеры ниже.
  • Если (become) недоступно, используйте (win_hotfix) для установки исправлений вместо (win_chocolatey), так как (win_hotfix) избегает использования wusa.exe, которое не может быть запущено без (become).

Примеры

- 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 notepadplusplus 32 bit version
  win_chocolatey:
    name: notepadplusplus
    architecture: x86

- name: Install git from specified repository
  win_chocolatey:
    name: git
    source: https://someserver/api/v2/

- name: Install git from a pre configured source (win_chocolatey_source)
  win_chocolatey:
    name: git
    source: internal_repo

- name: ensure Chocolatey itself is installed and use internal repo as source
  win_chocolatey:
    name: chocolatey
    source: http://someserver/chocolatey

- name: Uninstall git
  win_chocolatey:
    name: git
    state: absent

- name: Install multiple packages
  win_chocolatey:
    name:
    - procexp
    - putty
    - windirstat
    state: present

- name: Install multiple packages sequentially
  win_chocolatey:
    name: '{{ item }}'
    state: present
  with_items:
  - procexp
  - putty
  - windirstat

- name: uninstall multiple packages
  win_chocolatey:
    name:
    - procexp
    - putty
    - windirstat
    state: absent

- name: Install curl using proxy
  win_chocolatey:
    name: curl
    proxy_url: http://proxy-server:8080/
    proxy_username: joe
    proxy_password: p@ssw0rd

- name: Install a package that requires 'become'
  win_chocolatey:
    name: officepro2013
  become: yes
  become_user: Administrator
  become_method: runas

Значения возврата

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

Ключ Возвращаемое значение Описание
command
строка
изменённое
Полная команда, используемая в задаче chocolatey.

Пример:
choco.exe install -r --no-progress -y sysinternals --timeout 2700 --failonunfound
rc
целое число
всегда
Код возврата из задачи chocolatey.

stdout
строка
изменённое
Вывод stdout из задачи chocolatey. Уровень подробности сообщений зависит от настроек подробности Ansible, см. примечания для получения дополнительной информации.

Пример:
Chocolatey upgraded 1/1 packages.


Статус

  • Интерфейс этого модуля не гарантирует обратной совместимости. [превью]
  • Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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

Подсказка

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

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

Spec-Zone.ru

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