Nota

Este complemento es parte del colección chocolatey.chocolatey (versión 1.0.2).

Para instalarlo use: ansible-galaxy collection install chocolatey.chocolatey.

Para usarlo en un libro de jugadas, especifique: chocolatey.chocolatey.win_chocolatey.

Nuevo en la versión 1.9: de chocolate a chocolate.

  • Sinopsis
  • Requisitos
  • Parámetros
  • Notas
  • Ver también
  • Ejemplos de
  • Valores devueltos

Sinopsis

  • Gestione paquetes con Chocolatey.
  • Si Chocolatey no está en el sistema, el módulo lo instalará.

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

  • chocolateado> = 0.10.5 (se actualizará si es más antiguo)

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
allow_empty_checksumsbooleano añadido en 2.2 de chocolatey.chocolatey
    Opciones:

  • no
Permitir que se utilicen sumas de comprobación vacías para los recursos descargados desde ubicaciones no seguras. win_chocolatey_feature con el nombre allowEmptyChecksums para controlar esta opción globalmente.
allow_multiplebooleano añadido en 2.8 de chocolatey.chocolatey
    Opciones:

  • no
Permitir la instalación de varios paquetes cuando versión Tener varios paquetes en diferentes versiones puede causar problemas si el paquete no es compatible con esto. Úselo bajo su propio riesgo.
allow_prereleasebooleano agregado en 2.6 de chocolatey.chocolatey
    Opciones:

  • no
Permita la instalación de paquetes preliminares. estado es latest, se instalará el último paquete de versión preliminar.
arquitecturacuerda añadido en 2,7 de chocolatey.chocolatey
    Opciones:

  • defecto
  • x86
Obligar a Chocolatey a instalar el paquete de una arquitectura de proceso específica. x86, se asegurará de que Chocolatey instale el paquete x86 incluso en un sistema operativo x64 bit.
fuerzabooleano
    Opciones:

  • no
Fuerza la instalación de un paquete, incluso si ya está instalado. fuerza hará que Ansible siempre informe que se realizó un cambio.
ignore_checksumsbooleano agregado en 2.2 de chocolatey.chocolatey
    Opciones:

  • no
Ignore las sumas de comprobación proporcionadas por el paquete. win_chocolatey_feature con el nombre checksumFiles para controlar esta opción globalmente.
ignore_dependenciasbooleano añadido en 2.1 de chocolatey.chocolatey
    Opciones:

  • no
Ignore las dependencias, solo instale / actualice el paquete en sí.
install_argscuerda agregado en 2.1 de chocolatey.chocolatey Argumentos para pasar al instalador nativo Estos son argumentos que se pasan directamente al instalador que ejecuta el paquete Chocolatey, esta es generalmente una opción avanzada.
nombrelista / elementos = cadena / requerido Nombre de los paquetes que se instalarán. all para ejecutar la acción en todos los paquetes instalados.
override_argsbooleano añadido en 2.10 de chocolatey.chocolatey
    Opciones:

  • no
Anula los argumentos del instalador nativo con los argumentos proporcionados por el usuario. Deben usarse los argumentos de instalación exclusivamente sin agregar los argumentos pasados ​​del paquete actual.
package_paramscuerda añadido en 2.1 de chocolatey.chocolatey Parámetros para pasar al paquete. Estos son parámetros específicos del paquete Chocolatey y generalmente están documentados por el propio paquete. Antes de Ansible 2.7, esta opción solo era params.
alias: params
clavadobooleano añadido en 2.8 de chocolatey.chocolatey
    Opciones:

  • no
Ya sea para fijar el paquete Chocolatey o no. Si se omite, no se realizan comprobaciones en los pines del paquete. Anclará / desanclará la versión específica si versión Se fija la última versión de un paquete si yes, versión no está configurado y no existe ningún pin. Desanclará todas las versiones de un paquete si no y versión no está configurado Esto se ignora cuando state=absent.
proxy_passwordcuerda agregado en 2.4 de chocolatey.chocolatey Contraseña de proxy utilizada para instalar Chocolatey y el paquete. Este valor se expone como un argumento de comando y cualquier cuenta privilegiada puede ver este valor cuando el módulo está ejecutando Chocolatey, defina la contraseña en el nivel de configuración global con win_chocolatey_config con nombre proxyPassword para evitar esto.
proxy_urlcuerda agregado en 2.4 de chocolatey.chocolatey URL de proxy utilizada para instalar chocolatey y el paquete. win_chocolatey_config con el nombre proxy para controlar esta opción globalmente.
proxy_usernamecuerda agregado en 2.4 de chocolatey.chocolatey Nombre de usuario proxy utilizado para instalar Chocolatey y el paquete. Antes de Ansible 2.7, los usuarios con comillas dobles " necesitaría ser escapado con antemano. Esto ya no es necesario. win_chocolatey_config con el nombre proxyUser para controlar esta opción globalmente.
skip_scriptsbooleano agregado en 2.4 de chocolatey.chocolatey
    Opciones:

  • no
No corra chocolateyInstall.ps1 o chocolateyUninstall.ps1 scripts al instalar un paquete.
fuentecuerda Especifique la fuente desde la que recuperar el paquete. win_chocolatey_source para administrar fuentes globales. Este valor puede ser la URL de un feed Chocolatey, una ruta a una carpeta que contiene .nupkg paquetes o el nombre de una fuente definida por win_chocolatey_source.Este valor también se usa cuando Chocolatey no está instalado como la ubicación del script install.ps1 y solo admite URL para este caso.
source_passwordcuerda añadido en 2,7 de chocolatey.chocolatey La contraseña para source_username.Este valor se expone como un argumento de comando y cualquier cuenta privilegiada puede ver este valor cuando el módulo está ejecutando Chocolatey, defina las credenciales con una fuente con win_chocolatey_source para evitar esto.
source_usernamecuerda añadido en 2,7 de chocolatey.chocolatey Un nombre de usuario para usar con fuente al acceder a un feed que requiere autenticación. Se recomienda que defina las credenciales en una fuente con win_chocolatey_source en lugar de pasarlo por tarea.
estadocuerda
    Opciones:

  • ausente
  • degradar
  • más reciente
  • regalo
  • reinstalado
Estado del paquete en el sistema. absent, se asegurará de que el paquete no esté instalado. present, se asegurará de que el paquete esté instalado. downgrade, permitirá a Chocolatey degradar un paquete si versión es anterior a la versión instalada. latest, se asegurará de que el paquete se instale con la última versión disponible. reinstalled, desinstalará y reinstalará el paquete.
se acabó el tiempoentero agregado en 2.3 de chocolatey.chocolatey Defecto:
2700
El tiempo para dejar que el chocolate termine antes de que se agote el tiempo.
alias: execution_timeout
validate_certsbooleano añadido en 2,7 de chocolatey.chocolatey
    Opciones:

  • no
Se usa al descargar el script de instalación de Chocolatey si Chocolatey aún no está instalado, esto no afecta el proceso de instalación del paquete de Chocolatey. no, no se validarán certificados SSL. Esto solo debe usarse en sitios controlados personalmente que utilicen un certificado autofirmado.
versióncuerda Versión específica del paquete que se instalará. estado se establece en absent, desinstalará la versión específica; de lo contrario, se eliminarán todas las versiones de ese paquete. Si se instala una versión diferente del paquete, estado debe ser latest o fuerza ajustado a yes para instalar la versión deseada. Proporcionar como una cadena (p. ej. '6.1'), de lo contrario, se considera un número de punto flotante y, dependiendo de la configuración regional, podría convertirse en 6,1, lo que provocará una falla. nombre se establece en chocolatey y Chocolatey no está instalado en el host, esta será la versión de Chocolatey que esté instalada. También puede configurar el chocolateyVersion entorno var.

Notas

Nota

  • Este módulo instalará o actualizará Chocolatey cuando sea necesario.
  • Cuando se usa verbosidad 2 o menos (-vv) los stdout la salida estará restringida. Cuando se usa verbosidad 4 (-vvvv) los stdout la salida será más detallada. Cuando se usa verbosidad 5 (-vvvvv) los stdout la salida incluirá la salida de depuración.
  • Algunos paquetes, como revisiones o actualizaciones, necesitan un inicio de sesión de usuario interactivo para poder instalarse. Puedes usar become para lograr esto, mira Conviértete y Windows. Incluso si se conecta como administrador local, utilice become convertirse en administrador le dará un inicio de sesión de usuario interactivo, vea los ejemplos a continuación.
  • Si become no está disponible, use win_hotfix para instalar revisiones en lugar de win_chocolatey como win_hotfix evita usar wusa.exe que no se puede ejecutar sin become.

Ver también

Ver también

win_chocolatey_config

La documentación oficial sobre el win_chocolatey_config módulo.

win_chocolatey_facts

La documentación oficial sobre el win_chocolatey_facts módulo.

win_chocolatey_feature

La documentación oficial sobre el win_chocolatey_feature módulo.

win_chocolatey_source

La documentación oficial sobre el win_chocolatey_source módulo.

win_feature

La documentación oficial sobre el win_feature módulo.

win_hotfix

Usar cuando become no está disponible, para evitar usar wusa.exe.

win_package

La documentación oficial sobre el win_package módulo.

win_updates

La documentación oficial sobre el win_updates módulo.

Sitio web de Chocolatey

Más información sobre la herramienta Chocolatey.

Paquetes de chocolate

Una descripción general de los paquetes Chocolatey disponibles.

Conviértete y Windows

Algunos paquetes, como revisiones o actualizaciones, necesitan un inicio de sesión de usuario interactivo para poder instalarse. Puedes usar become lograr esto.

Ejemplos de

-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
  loop:- 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:[email protected]-name: Install a package that requires 'become'
  win_chocolatey:name: officepro2013
  become: yes
  become_user: Administrator
  become_method: runas

-name: install and pin Notepad++ at 7.6.3
  win_chocolatey:name: notepadplusplus
    version: 7.6.3
    pinned: yes
    state: present

-name: remove all pins for Notepad++ on all versions
  win_chocolatey:name: notepadplusplus
    pinned: no
    state: present

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Llave Devuelto Descripción
mandocuerda cambió El comando completo utilizado en la tarea chocolateada.
Muestra:choco.exe install -r –no-progress -y sysinternals –timeout 2700 –failonunfound
rcentero siempre El código de retorno de la tarea chocolateada.
stdoutcuerda cambió El stdout de la tarea chocolatada. El nivel de verbosidad de los mensajes se ve afectado por la configuración de verbosidad de Ansible; consulte las notas para obtener más detalles.
Muestra:Paquetes 1/1 mejorados con chocolate.

Autores

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