Creación de una acción mediante la consola

Crea una acción « Schematics » y especifica el playbook « Ansible » que deseas ejecutar en tus recursos de Cloud.

1. Inicie sesión en la consola IBM Cloud.

2. Haga clic en el icono Menú > Automatización de la plataforma > Schematics > Ansible y vaya a Crear playbook.

   • Crear un libro de jugadas.

     1. Introduzca un Nombre de libro de jugadas y una Descripción para su acción. El nombre puede tener hasta 128 caracteres de longitud y puede incluir caracteres alfanuméricos, espacios, guiones y signos de subrayado.
     2. Especifique el URL del repositorio de GitHub o GitLab donde está almacenado el playbook de Ansible. El URL puede apuntar a la rama maestra, a cualquier otra rama o a un subdirectorio. Si el repositorio almacena varios playbooks, debe seleccionar el playbook que desea ejecutar. Una acción de Schematics solo puede apuntar a un playbook a la vez. Para ejecutar varios playbooks, debe crear una acción independiente para cada playbook.

     Si no tienes un manual de estrategias, prueba con uno de tus manuales de estrategias de ejemplo.

     3. Opcional: introduzca la Sucursal (opcional) y la Carpeta (opcional).
     4. Opcional: si desea utilizar un repositorio de GitHub privado, especifique su señal de acceso personal. La señal de acceso personal se utiliza para autenticar el repositorio de GitHub privado para acceder a playbook de Ansible. Para obtener más información sobre cómo crear un token de acceso, consulta la sección « Creación de un token de acceso personal para la CLI ».

     Para obtener más información, consulta las extensiones de archivo permitidas y bloqueadas para la clonación desde el repositorio Git. Para validar y clonar la plantilla de forma segura, puedes hacer clic en « Open reference picker » para seleccionar tu clave de referencia de Secrets Manager. Para obtener más información, consulta la sección « Creación de una instancia de Secrets Manager ».

   • Información adicional

     1. Opcional: especifique las Etiquetas que desea añadir a la acción. Las etiquetas te ayudan a realizar búsquedas rápidas de tus acciones.
     2. Seleccione el Grupo de recursos donde desea crear la acción.
     3. Seleccione la Ubicación donde desea crear la acción. La ubicación determina dónde se ejecuta la acción y se guardan los datos de la acción. Puede elegir una geografía, como Dallas, o Frankfurt. Si selecciona una geografía, Schematics decide una ubicación dentro de esta geografía según de la disponibilidad. Asegúrese de que puede almacenar los datos de acción en esta ubicación ya que no podrá cambiar la ubicación una vez creada la acción. Para más información, consulte ¿Dónde se almacena la información? Asegúrate de que la ubicación de tu acción sea independiente de la ubicación del recurso en la nube en el que quieras ejecutar tu playbook de « Ansible ».

   • Elegir un inventario Puedes definir los grupos de hosts en los que deseas ejecutar tu playbook de « Ansible ».

     1. Pulse Crear inventario.

     2. Introduce un nombre para tu inventario.

     3. Elija el tipo de conexión como SSH o WinRM dependiendo de los requisitos de su host remoto. El valor predeterminado es SSH.

        El tipo de conexión admite tanto SSH como WinRM para conectarse a hosts remotos. Para SSH asegúrese de que el acceso al host Bastion está configurado. WinRM se utiliza para conectar con hosts remotos Windows. Actualmente, WinRM solo es compatible con el sistema Windows a través de la dirección pública IPs y no admite el acceso mediante un servidor bastión.

     4. Verifique su location y seleccione el Resource group donde desea crear el inventario.

     5. Pulse Crear grupo de host.

     6. 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.

     7. 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.

     8. Haga clic en Añadir otra condición y repita los pasos 6-8 para añadir más grupos de hosts.

     9. Opcional: Haga clic en la pestaña Definir manualmente para definir los hosts y el grupo de hosts en los que opera su libro de jugadas.

     10. Introduzca los detalles del host utilizando el formato de archivo.ini en la opción Archivo.

     11. En la lista de tabla, seleccione los grupos de host que desea incluir en el inventario de recursos.

     12. Haga clic en Crear inventario para definir un archivo de inventario que defina los hosts y el grupo de hosts sobre los que opera su libro de jugadas.

3. En la tabla de inventario de recursos, seleccione un inventario de recursos existente y haga clic en el icono Editar.

   • Haga clic en Gestionar credenciales para configurar las credenciales de inventario. Para más información, consulte Gestión de credenciales.
   • Haga clic en Gestionar variables para configurar las variables de inventario. Para más información, consulte Gestión de variables.
   • Haga clic en Borrar para eliminar el inventario.

4. Pulse Crear. Tu acción se ha creado con el estado « Normal » y se te redirige a la sección « Detalles ».

5. Haga clic en Comprobar acción para verificar que las tareas que intenta ejecutar y sus recursos están vinculados a su libro de jugadas. Puede supervisar la sección Historial de acciones para ver los resultados en los registros. Esta comprobación verifica que las tareas que está intentando ejecutar y sus recursos están correctamente vinculados a su libro de jugadas.

   No puede suprimir ni detener un trabajo en ejecución de la acción Schematics. Para modificar la acción, espera a que finalice el proceso, cambia la configuración y, a continuación, vuelve a hacer clic en « Comprobar acción » o « Ejecutar acción ».

6. Pulse Ejecutar acción para ejecutar la acción. Puede supervisar el progreso de una acción revisando los registros de la página Trabajos. Los registros de trabajos se renuevan automáticamente cada 30 seconds.

Creación de una acción mediante CLI

1. Desde su interfaz CLI local, configure el complemento Schematics.
2. Crea una acción utilizando el comando ibmcloud schematics action create.
3. Cree un inventario utilizando el comando ibmcloud schematics inventory create.
4. Compruebe los registros para verificar que la creación se ha realizado correctamente.

Creación de una acción mediante API

1. Recupere su token de acceso IAM y autentifíquese con Schematics.
2. Opcional: Cree una acción enviando una solicitud POST.
3. Cree un inventario enviando una solicitud POST.
4. Comprueba el estado de la respuesta para verificar que la creación se ha realizado correctamente.