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 |
| Вынудить 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, гарантируется, что пакет не установлен.При значении 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