Crear un playbook Ansible

Para crear su playbook Ansible para su uso con Schematics, siga estos requisitos previos y los pasos generales.

¿Desea utilizar los playbooks Ansible existentes para empezar? Pruebe uno de los playbooks Ansible proporcionados IBM o explore las colecciones y roles Ansible existentes en Ansible Galaxy.

Prepare su inventario de recursos donde pretende ejecutar su libro de jugadas Ansible. También puede utilizar las capacidades Terraform integradas en Schematics para aprovisionar hosts de destino. Para obtener más información, consulte Despliegue de infraestructuras con espacios de trabajo de Schematics.
Desarrolle su libro de jugadas Ansible. Utilice uno de los manuales de procedimientos proporcionados por IBM o explore los roles y colecciones existentes en Ansible Galaxy. Haga referencia a estas funciones y colecciones](/docs/schematics?topic=schematics-create-playbook#schematics-collections) en su libro de jugadas según sea necesario.
Establezca un repositorio GitHub o GitLab, y organice su playbook Ansible, módulos, roles y colecciones de acuerdo a la estructura de directorios requerida. Puede encontrar un ejemplo de estructura en este ejemplo de libro de jugadas.
Cargue el playbook Ansible, los módulos, los roles y las colecciones en el repositorio GitHub.
Cree una acción Schematics utilizando el libro de jugadas cargado.

Asegúrese de que su libro de jugadas se adhiere a la estructura necesaria y hace referencia a todas las funciones y colecciones necesarias para una ejecución sin problemas en Schematics. Para más información, consulte la documentación de Ansible o la creación de playbooks.

Hacer referencia a las colecciones Ansible en el playbook

Ansible las colecciones son grupos de recursos reutilizables de Ansible, como playbooks, módulos y roles, que puedes instalar y utilizar en tu playbook. Las colecciones están disponibles en el repositorio Ansible Galaxy.

De forma similar a los roles Ansible, las colecciones requieren una estructura de carpetas específica en el repositorio GitHub.

Siga estos pasos para utilizar colecciones en su playbook Schematics

Navegue por Ansible Galaxy para encontrar la colección que desea utilizar en su libro de jugadas.
Cree un archivo requirements.yml para especificar las colecciones que desea instalar desde Ansible Galaxy. La estructura de los archivos debe seguir la documentación de Ansible. He aquí un ejemplo utilizando la colección community.kubernetes.
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
Añada una carpeta collections a su repositorio GitHub, relativa a su playbook, y coloque el archivo requirements.yml dentro de esta carpeta.
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
Haga referencia a un recurso de la colección en el playbook. Para más información, consulte la documentación de Ansible. Asegúrese de que la estructura de carpetas de su libro de jugadas cumple los requisitos y hace referencia correctamente a las colecciones para una ejecución perfecta en Schematics.

Prepare su Ansible Playbook para Schematics

Antes de ejecutar su playbook Ansible en Schematics, tenga en cuenta los siguientes puntos:

Almacene su playbook Ansible en un repositorio GitHub o GitLab.
Tenga en cuenta las limitaciones a la hora de especificar hosts de destino para su inventario de recursos Ansible. Para más información, consulte las directrices sobre Creación de inventarios de recursos para acciones Schematics.
Asegúrese de que sus playbooks son compatibles con una versión de Ansible soportada en Schematics. Para comprobar las versiones compatibles, ejecute el comando ibmcloud schematics version comando.
Opcionalmente, explore las capacidades de los playbooks Ansible en Schematics utilizando uno de los playbooks Ansible proporcionados por IBM.

Próximos pasos

Después de comprender los requisitos previos y los pasos de preparación para su playbook Ansible, el siguiente paso es crear una acción Schematics. Este proceso implica especificar su playbook Ansible, configurar el inventario de recursos y establecer las credenciales o variables necesarias. Siga la guía de creación de una acción Schematics para proceder.