Nuestro team de especialistas luego de muchos días de investigación y de juntar de información, obtuvieron la solución, nuestro deseo es que te sea de gran utilidad para tu trabajo.
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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
) losstdout
la salida estará restringida. Cuando se usa verbosidad 4 (-vvvv
) losstdout
la salida será más detallada. Cuando se usa verbosidad 5 (-vvvvv
) losstdout
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, utilicebecome
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 usarwusa.exe
que no se puede ejecutar sinbecome
.
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 usarwusa.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)