Crear un playbook Ansible

Siga estos pasos requisitos previos y generales para crear su playbook de Ansible. Para obtener información detallada sobre cómo estructurar el playbook, consulte la documentación de Ansible o la creación de playbook.

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

Cree el inventario de recursos donde desea ejecutar el playbook Ansible. También puede utilizar las funciones incorporadas de Terraform en Schematics para suministrar los hosts de destino. Para obtener más información, consulte Despliegue de infraestructuras con espacios de trabajo de Schematics.
Cree su playbook Ansible. Utilice uno de los playbooks IBM para empezar o navegue por Ansible Galaxy para encontrar funciones y colecciones existentes. A continuación, puede hacer referencia a estos roles y colecciones en el playbook.
Cree un repositorio en GitHub o GitLab y cree la estructura de directorios y archivos del playbook Ansible. En función de si utiliza roles y colecciones de Ansible, esta estructura de directorios puede variar. Para encontrar una estructura de ejemplo, consulte este playbook de ejemplo.
Cargue el playbook Ansible, los módulos, los roles y las colecciones en el repositorio GitHub.
Cree una acción de Schematics.

Hacer referencia a las colecciones Ansible en el playbook

Las colecciones Ansible agrupan distintos recursos Ansible reutilizables, como playbooks, módulos y roles para que pueda instalarlos y utilizarlos en el playbook. Las colecciones se almacenan 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.

Examine Ansible Galaxy para encontrar la colección que desea utilizar en su libro de jugadas.
Cree un archivo requirements.yml donde especifique las colecciones que desea instalar de Ansible Galaxy. Para más información sobre cómo estructurar este archivo, consulte la documentación Ansible. En el ejemplo siguiente se utiliza la colección community.kubernetes.
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
Añada una carpeta collections al repositorio GitHub relativo al playbook y almacene el archivo requirements.yml en esta carpeta como se muestra en este ejemplo.
```
├── 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 Ansible

Preparar el playbook Ansible para ejecutarlo en Schematics

Para preparar el playbook Ansible para Schematics, revise las siguientes consideraciones.

El playbook Ansible se debe almacenar en un repositorio GitHub o GitLab.
Tiene limitaciones en cuanto a cómo especificar los hosts de destino para su inventario de recursos Ansible. Para obtener más información, consulte Creación de inventarios de recursos para acciones de Schematics.
Todos los playbooks deben ser compatibles para ejecutarlos con una versión Ansible que esté soportada en Schematics. Para buscar versiones soportadas, ejecute el mandato ibmcloud schematics version.
Opcionalmente, para explorar las funciones de playbook de Ansible en Schematics. Puede intentar utilizar uno de los playbooks deIBMproporcionados por Ansible.