Creación de inventarios de recursos para acciones de Schematics

Un inventario de recursos define un recurso o un grupo de recursos de IBM Cloud donde desea ejecutar playbooks Ansible, módulos o roles utilizando acciones de Schematics.

Puede especificar el inventario de recursos utilizando un archivo de inventario estático o recuperar dinámicamente los recursos de destino IBM Cloud de los espacios de trabajo Schematics.

Creación de archivos de inventario estáticos

Schematics admite la definición de archivos hosts.ini en los que se especifica un único host de destino o un grupo de hosts de destino utilizando su dirección IP. Puede asignar nombres a un grupo de hosts de destino, como por ejemplo [webserver], y utilizar este nombre en el playbook Ansible para indicar a Schematics dónde ejecutar las tareas del playbook.

Definición de hosts estáticos

Para conectarse a un host de destino a través de SSH, Ansible requiere un nombre de host que se pueda resolver mediante DNS o una dirección IP.

El uso típico de las acciones Schematics para configurar las VSI en IBM Cloud es a través de un host bastión. Consulte la documentación de acciones. El acceso a la interfaz de red privada de una VSI se realiza a través de un host bastión. Esto significa utilizar la dirección IP privada de los hosts para conectarse al host de destino, ya que DNS no anuncia los nombres de host privados en Schematics. Para los hosts privados, el inventario debe configurarse con una dirección IP y la dirección IP de un host bastión.

Los VSI con direcciones IP públicas y nombres de host DNS registrados públicamente pueden ser referenciados por nombres de host DNS completos.

El uso de nombres de host (formato abreviado) no está soportado.

Creación del archivo de host

Inicie sesión en la consolaIBM Cloud.
Haga clic en el icono de menú > Automatización de plataformas > Schematics > Ansible.
Haga clic en el nombre del libro de jugadas.
Haga clic en Inventario > Crear inventario.
Especifique un nombre para el inventario, verifique la ubicación y seleccione Resource group donde desea crear un inventario.
Seleccione la pestaña Definir manualmente.
En el campo Archivo, especifique los hosts de destino donde desea ejecutar el playbook Ansible. Asegúrese de especificar los hosts en una sintaxis de INI. Para ver una sintaxis de ejemplo, consulte Formato de archivo. Revise las limitaciones para asegurarse de que la definición de inventario está soportada en Schematics.
Pulse Crear inventario.
Siga los pasos para crear un Schematics acciones y utilizar el inventario de recursos que ha creado.

Formato del archivo

Revise el siguiente archivo hosts.ini de ejemplo para ver la estructura de la lista de inventario de host estático. Para obtener más información sobre las estructuras de archivos hosts.ini, consulte la documentación deAnsible.

Este ejemplo hace referencia a hosts accesibles públicamente a través del nombre de host y a hosts privados a través de la dirección IP.

mail.example.com

[webservers]
web1.mydomain.com
web2.mydomain.com

[dbservers]
172.16.5.9
172.16.5.10
172.16.5.11

[datacenters]
172.15.4.0

Limitaciones

Revise las siguientes limitaciones de los inventarios estáticos en Schematics:

Schematics solo da soporte a la sintaxis del archivo INI.
No se admiten variables en los archivos hosts.ini.
No se permite especificar grupos de host utilizando pares clave-valor en los archivos hosts.ini.
Debe actualizar manualmente el archivo hosts.ini si el nombre de host o la dirección IP de los hosts de destino cambian.
Cuando los hosts están protegidos por un host bastión y solo se puede acceder a ellos a través de una dirección IP privada, se debe especificar la dirección IP del host.
Cuando los hosts son accesibles a través de una dirección IP accesible públicamente y tienen un nombre DNS registrado, se puede hacer referencia al host mediante su nombre de host completo.
Todos los hosts de destino se deben configurar con la misma clave SSH pública. Si utiliza el archivo de inventario estático en la acción Schematics, puede especificar una clave SSH para autenticarse con todos los hosts de destino que se incluyen en el inventario de recursos. La clave SSH debe contener \n al final de los detalles clave en caso de llamadas de línea de mandatos o API. Para más información sobre claves SSH, consulte Añadir una clave SSH.

Creación dinámica de inventarios de recursos desde espacios de trabajo de Schematics

Puede crear dinámicamente su inventario de recursos a partir de los recursos en la nube que haya aprovisionado con los espacios de trabajo de Schematics.

Los inventarios de recursos dinámicos hacen referencia a los recursos de la nube que usted aprovisionó con los espacios de trabajo de Schematics. Para recuperar los recursos de la nube de sus espacios de trabajo, utilice consultas de recursos predefinidas. No es necesario realizar un seguimiento de las direcciones IP asignadas a los recursos de destino porque Schematics determina automáticamente los hosts de destino cuando utiliza este inventario en la acción Schematics.

Inicie sesión en la consolaIBM Cloud.
Haga clic en el icono de menú > Automatización de plataformas > Schematics > Ansible.
Haga clic en el nombre del libro de jugadas.
Haga clic en Inventario > Crear inventario.
Especifique un nombre para el inventario, verifique la ubicación y seleccione Resource group donde desea crear un inventario.
Seleccione el separador Grupos de hosts.
Pulse Crear grupo de host.
Especifique un nombre para el grupo de hosts y seleccione el espacio de trabajo de Schematics que ha suministrado los hosts de destino que desea añadir al grupo de hosts.
Opcional: Pulse Añadir consulta para añadir otra condición a la consulta y limitar el número de hosts de destino que se añaden al grupo de hosts. Puede elegir identificar los hosts utilizando el nombre de recurso o una etiqueta. Para obtener más información, consulte consultas de recursos soportadas.
Repita los pasos 5-8 para añadir más grupos de hosts.
En la lista de tabla, seleccione los grupos de host que desea incluir en el inventario de recursos.
Pulse Crear inventario.
Siga los pasos para crear las acciones de Schematics y utilice el inventario de recursos que ha creado.

Consultas de recursos soportadas

Consulta de recursos
Consulta soportada	Descripción
Nombre del espacio de trabajo	Selecciona todos los recursos de la nube de un espacio de trabajo específico
Nombre de espacio de trabajo y nombre de recurso	Seleccionar un recurso específico de un espacio de trabajo específico utilizando el nombre de recurso. Para seleccionar varios recursos del mismo espacio de trabajo, puede añadir varias consultas de este tipo.
Nombre y etiqueta de espacio de trabajo	Seleccionar un recurso específico de un espacio de trabajo específico utilizando etiquetas. Las etiquetas se añaden al recurso al crear el espacio de trabajo y suministrar el recurso. Para seleccionar varios recursos con distintas etiquetas del mismo espacio de trabajo, puede añadir varias consultas de este tipo.

Limitaciones

Revise las siguientes limitaciones de los inventarios dinámicos en Schematics:

Puede elegir entre las consultas soportadas para seleccionar las instancias de servidor virtual de destino que se deben incluir en el inventario de recursos.
Schematics recupera la dirección IP de un Virtual Servers for VPC de destino y añade la dirección IP al inventario de recursos. Si el destino Virtual Servers for VPC tiene una dirección IP pública, se utiliza la dirección IP pública para el inventario de recursos. Si no hay ninguna dirección IP pública, se utiliza la dirección IP privada para el inventario de recursos.
Todos los hosts de destino se deben configurar con la misma clave SSH pública. Si utiliza el archivo de inventario estático en la acción Schematics, puede especificar una clave SSH para autenticarse con todos los hosts de destino que se incluyen en el inventario de recursos. La clave SSH debe contener \n al final de los detalles clave en caso de llamadas de línea de mandatos o API. Para más información sobre claves SSH, consulte Añadir una clave SSH.