Nota

Este complemento es parte del colección awx.awx (versión 17.0.1).

Para instalarlo usa: ansible-galaxy collection install awx.awx.

Para usarlo en un libro de jugadas, especifique: awx.awx.tower.

  • Sinopsis
  • Parámetros
  • notas
  • Ejemplos

Sinopsis

  • Lee inventarios de Ansible Tower.
  • Admite la lectura de la configuración tanto del archivo de configuración YAML como de las variables de entorno.
  • Si lee desde el archivo YAML, el nombre del archivo debe terminar con tower.(yml|yaml) o tower_inventory.(yml|yaml), la ruta en el comando sería /path/to/tower_inventory.(yml|yaml). Si faltan algunos argumentos en el archivo de configuración, este complemento intentará completar los argumentos faltantes leyendo las variables de entorno.
  • Si lee configuraciones de variables de entorno, la ruta en el comando debe ser @tower_inventory.

Parámetros

Parámetro Opciones/Predeterminados Configuración Comentarios
anfitriónstring entorno:TOWER_HOST La dirección de red de su host Ansible Tower.
incluir_metadatosbooleano
    Opciones:

  • no
Realice solicitudes adicionales para proporcionar metadatos sobre el host de Ansible Tower de origen a todas las variables del grupo.
inventario_idcrudo / requerido env:TOWER_INVENTARIO El ID del inventario de Ansible Tower que desea importar. Puede ser el inventario principal key o su URL con nombre slug.Primary key los valores se aceptarán como cadenas o números enteros, y los slug de URL deben ser cadenas. Los slug de URL con nombre siguen la sintaxis de “nombre_inventario++nombre_organización”.
oauth_tokenstring entorno:TOWER_OAUTH_TOKEN El token Tower OAuth que se va a usar.
clavestring entorno:TOWER_PASSWORD La contraseña de su usuario de Ansible Tower.
nombre de usuariostring env:TOWER_NOMBRE DE USUARIO El usuario que planea usar para acceder a los inventarios en Ansible Tower.
verificar_sslbooleano
    Opciones:

  • no
entorno:TOWER_VERIFY_SSL Especifique si Ansible debe verificar el certificado SSL del host de Ansible Tower. El valor predeterminado es Verdadero, pero esto lo maneja el código module_utils compartido
alias: validar_certs

notas

Nota

  • Si no archivo de configuración se proporciona, intentaremos utilizar los valores predeterminados de la biblioteca tower-cli para encontrar la información de su host Tower.
  • archivo de configuración debe contener la configuración de la torre en el siguiente formato host=nombre de host nombre de usuario=nombre de usuario contraseña=contraseña

Ejemplos

# Before you execute the following commands, you should make sure this file is in your plugin path,# and you enabled this plugin.# Example for using tower_inventory.yml fileplugin: awx.awx.tower
host: your_ansible_tower_server_network_address
username: your_ansible_tower_username
password: your_ansible_tower_password
inventory_id: the_ID_of_targeted_ansible_tower_inventory
# Then you can run the following command.# If some of the arguments are missing, Ansible will attempt to read them from environment variables.# ansible-inventory -i /path/to/tower_inventory.yml --list# Example for reading from environment variables:# Set environment variables:# export TOWER_HOST=YOUR_TOWER_HOST_ADDRESS# export TOWER_USERNAME=YOUR_TOWER_USERNAME# export TOWER_PASSWORD=YOUR_TOWER_PASSWORD# export TOWER_INVENTORY=THE_ID_OF_TARGETED_INVENTORY# Read the inventory specified in TOWER_INVENTORY from Ansible Tower, and list them.# The inventory path must always be @tower_inventory if you are reading all settings from environment variables.# ansible-inventory -i @tower_inventory --list

Autores

  • Mateo Jones (@matburt)
  • Yunfan Zhang (@YunfanZhang42)