Realice diversas operaciones relacionadas con roles y colecciones.

  • Sinopsis
  • Descripción
  • Opciones comunes

  • Comportamiento

    • colección

      • descarga de la colección
      • inicio de colección
      • construcción de colección
      • publicación de la colección
      • instalación de la colección
      • lista de colecciones
      • verificación de colección

    • papel

      • rol init
      • papel quitar
      • función borrar
      • lista de roles
      • búsqueda de roles
      • importación de roles
      • configuración de roles
      • información del rol
      • instalación de rol
  • Medio ambiente
  • Archivos
  • Autor
  • Licencia
  • Ver también

Sinopsis

usage: ansible-galaxy [-h][--version][-v] TYPE ...

Descripción

comando para administrar roles de Ansible en repositorios compartidos, cuyo valor predeterminado es Ansible Galaxy https://galaxy.ansible.com.

Opciones comunes

--version

muestra el número de versión del programa, la ubicación del archivo de configuración, la ruta de búsqueda del módulo configurado, la ubicación del módulo, la ubicación del ejecutable y la salida

-h, --help

mostrar este mensaje de ayuda y salir

-v, --verbose

modo detallado (-vvv para más, -vvvv para habilitar la depuración de la conexión)

Comportamiento

colección

Realiza la acción en una colección Ansible Galaxy. Debe combinarse con una acción adicional como init / install como se indica a continuación.

descarga de la colección

--clear-response-cache

Borre la memoria caché de respuesta del servidor existente.

--no-cache

No utilice la caché de respuesta del servidor.

--pre

Incluya versiones preliminares. Las versiones preliminares del control de versiones semántico se ignoran de forma predeterminada

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-n, --no-deps

No descargue las colecciones enumeradas como dependencias.

-p , --download-path

El directorio para descargar las colecciones.

-r , --requirements-file

Un archivo que contiene una lista de colecciones para descargar.

-s , --server

La URL del servidor de la API de Galaxy

inicio de colección

Crea el marco esqueleto de un rol o colección que cumple con el formato de metadatos de Galaxy. Requiere un rol o nombre de colección. El nombre de la colección debe tener el formato ..

--collection-skeleton

La ruta a un esqueleto de colección en el que debería basarse la nueva colección.

--init-path

La ruta en la que se creará la colección de esqueletos. El predeterminado es el directorio de trabajo actual.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-f, --force

Forzar la sobrescritura de un rol o colección existente

-s , --server

La URL del servidor de la API de Galaxy

construcción de colección

Cree un artefacto de colección de Ansible Galaxy que se pueda almacenar en un depósito central como Ansible Galaxy. De forma predeterminada, este comando se basa en el directorio de trabajo actual. Opcionalmente, puede pasar la ruta de entrada de la colección (donde el galaxy.yml archivo es).

--output-path

La ruta en la que se construyó la colección. El predeterminado es el directorio de trabajo actual.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-f, --force

Forzar la sobrescritura de un rol o colección existente

-s , --server

La URL del servidor de la API de Galaxy

publicación de la colección

Publica una colección en Ansible Galaxy. Requiere la ruta al tarball de la colección para publicar.

--import-timeout

El tiempo de espera a que finalice el proceso de importación de la colección.

--no-wait

No espere los resultados de la validación de la importación.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-s , --server

La URL del servidor de la API de Galaxy

instalación de la colección

--clear-response-cache

Borre la memoria caché de respuesta del servidor existente.

--force-with-deps

Forzar la sobrescritura de una colección existente y sus dependencias.

--no-cache

No utilice la caché de respuesta del servidor.

--pre

Incluya versiones preliminares. Las versiones preliminares del control de versiones semántico se ignoran de forma predeterminada

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-U, --upgrade

Actualice los artefactos de colección instalados. Esto también actualizará las dependencias a menos que se proporcione –no-deps

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-f, --force

Forzar la sobrescritura de un rol o colección existente

-i, --ignore-errors

Ignore los errores durante la instalación y continúe con la siguiente colección especificada. Esto no ignorará los errores de conflicto de dependencia.

-n, --no-deps

No descargue colecciones listadas como dependencias.

-p , --collections-path

La ruta al directorio que contiene sus colecciones.

-r , --requirements-file

Un archivo que contiene una lista de colecciones que se instalarán.

-s , --server

La URL del servidor de la API de Galaxy

lista de colecciones

Listar colecciones o roles instalados

--format

Formato para mostrar la lista de colecciones en.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-p, --collections-path

Uno o más directorios para buscar colecciones además de los COLLECTIONS_PATHS predeterminados. Separe varias rutas con ‘:’.

-s , --server

La URL del servidor de la API de Galaxy

verificación de colección

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-i, --ignore-errors

Ignore los errores durante la verificación y continúe con la siguiente colección especificada.

-p, --collections-path

Uno o más directorios para buscar colecciones además de los COLLECTIONS_PATHS predeterminados. Separe varias rutas con ‘:’.

-r , --requirements-file

Un archivo que contiene una lista de colecciones a verificar.

-s , --server

La URL del servidor de la API de Galaxy

papel

Realiza la acción en un rol de Ansible Galaxy. Debe combinarse con una acción adicional como eliminar / instalar / init como se indica a continuación.

rol init

Crea el marco esqueleto de un rol o colección que cumple con el formato de metadatos de Galaxy. Requiere un rol o nombre de colección. El nombre de la colección debe tener el formato ..

--init-path

La ruta en la que se creará el rol de esqueleto. El predeterminado es el directorio de trabajo actual.

--offline

No consulte la API de Galaxy al crear roles

--role-skeleton

El camino hacia un esqueleto de roles en el que debería basarse el nuevo rol.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

--type

Inicialice utilizando un tipo de rol alternativo. Los tipos válidos incluyen: ‘contenedor’, ‘apb’ y ‘red’.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-f, --force

Forzar la sobrescritura de un rol o colección existente

-s , --server

La URL del servidor de la API de Galaxy

rol quitar

elimina la lista de roles pasados ​​como argumentos del sistema local.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-p, --roles-path

La ruta al directorio que contiene sus roles. El valor predeterminado es el primero que se puede escribir configurado a través de DEFAULT_ROLES_PATH: ~ / .ansible / roles: / usr / share / ansible / roles: / etc / ansible / roles

-s , --server

La URL del servidor de la API de Galaxy

función borrar

Elimina un rol de Ansible Galaxy.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-s , --server

La URL del servidor de la API de Galaxy

lista de roles

Listar colecciones o roles instalados

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-p, --roles-path

La ruta al directorio que contiene sus roles. El valor predeterminado es el primero que se puede escribir configurado a través de DEFAULT_ROLES_PATH: ~ / .ansible / roles: / usr / share / ansible / roles: / etc / ansible / roles

-s , --server

La URL del servidor de la API de Galaxy

búsqueda de roles

busca roles en el servidor Ansible Galaxy

--author

Nombre de usuario de GitHub

--galaxy-tags

lista de etiquetas de galaxias por las que filtrar

--platforms

lista de plataformas de SO para filtrar por

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-s , --server

La URL del servidor de la API de Galaxy

importación de roles

utilizado para importar un rol en Ansible Galaxy

--branch

El nombre de una sucursal que se va a importar. Por defecto es la rama predeterminada del repositorio (generalmente maestra)

--no-wait

No espere los resultados de la importación.

--role-name

El nombre que debe tener el rol, si es diferente al nombre del repositorio

--status

Verifique el estado de la solicitud de importación más reciente para github_user / github_repo dado.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-s , --server

La URL del servidor de la API de Galaxy

configuración de roles

Configure una integración de Github o Travis para los roles de Ansible Galaxy

--list

Enumere todas sus integraciones.

--remove

Elimine la integración que coincida con el valor de ID proporcionado. Utilice –list para ver los valores de ID.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-p, --roles-path

La ruta al directorio que contiene sus roles. El valor predeterminado es el primero que se puede escribir configurado a través de DEFAULT_ROLES_PATH: ~ / .ansible / roles: / usr / share / ansible / roles: / etc / ansible / roles

-s , --server

La URL del servidor de la API de Galaxy

información del rol

imprime información detallada sobre una función instalada, así como información disponible en la API de galaxy.

--offline

No consulte la API de Galaxy al crear roles

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-p, --roles-path

La ruta al directorio que contiene sus roles. El valor predeterminado es el primero que se puede escribir configurado a través de DEFAULT_ROLES_PATH: ~ / .ansible / roles: / usr / share / ansible / roles: / etc / ansible / roles

-s , --server

La URL del servidor de la API de Galaxy

papel Instalar en pc

--force-with-deps

Forzar la sobrescritura de un rol existente y sus dependencias.

--token , --api-key

La clave API de Ansible Galaxy que se puede encontrar en https://galaxy.ansible.com/me/preferences.

-c, --ignore-certs

Ignore los errores de validación del certificado SSL.

-f, --force

Forzar la sobrescritura de un rol o colección existente

-g, --keep-scm-meta

Utilice tar en lugar de la opción de archivo scm al empaquetar el rol.

-i, --ignore-errors

Ignore los errores y continúe con el siguiente rol especificado.

-n, --no-deps

No descargue roles listados como dependencias.

-p, --roles-path

La ruta al directorio que contiene sus roles. El valor predeterminado es el primero que se puede escribir configurado a través de DEFAULT_ROLES_PATH: ~ / .ansible / roles: / usr / share / ansible / roles: / etc / ansible / roles

-r , --role-file

Un archivo que contiene una lista de roles que se instalarán.

-s , --server

La URL del servidor de la API de Galaxy

Medio ambiente

Se pueden especificar las siguientes variables de entorno.

ANSIBLE_CONFIG – Anular el archivo de configuración ansible predeterminado

Hay muchos más disponibles para la mayoría de las opciones en ansible.cfg

Archivos

/etc/ansible/ansible.cfg – Archivo de configuración, utilizado si está presente

~/.ansible.cfg – Archivo de configuración de usuario, anula la configuración predeterminada si está presente

Autor

Ansible fue escrito originalmente por Michael DeHaan.

Ver el AUTHORS archivo para obtener una lista completa de contribuyentes.

Licencia

Ansible se publica bajo los términos de la licencia GPLv3 +.

Ver también

ansible (1), ansible-config (1), consola ansible (1), ansible-doc (1), ansible-galaxy (1), ansible-inventario (1), ansible-playbook (1), ansible-pull (1), bóveda-ansible (1),