Creazione di un playbook Ansible

Per creare il playbook Ansible da utilizzare con Schematics, seguire i seguenti prerequisiti e i passaggi generali.

Vuoi utilizzare i playbook Ansible esistenti per iniziare? Prova uno dei playbook Ansible forniti daIBM o sfoglia le raccolte e i ruoli Ansible esistenti in Ansible Galaxy

Preparare l'inventario delle risorse in cui si intende eseguire il playbook Ansible. È inoltre possibile utilizzare le funzionalità integrate di Terraform di Schematics per eseguire il provisioning degli host di destinazione. Per ulteriori informazioni, vedi Distribuzione dell'infrastruttura con gli spazi di lavoro Schematics.
Sviluppate il vostro libro di giochi Ansible. Utilizza uno dei playbook forniti da IBM oppure esplora i ruoli e le raccolte esistenti in Ansible Galaxy. Fare riferimento a questi ruoli e collezioni](/docs/schematics?topic=schematics-create-playbook#schematics-collections) nel playbook, se necessario.
Creare un repository GitHub o GitLab e organizzare il playbook Ansible, i moduli, i ruoli e le raccolte secondo la struttura di directory richiesta. Un esempio di struttura si trova in questo playbook di esempio.
Carica il playbook, i moduli, i ruoli e le raccolte Ansible nel tuo repository GitHub.
Creare un'azione Schematics utilizzando il playbook caricato.

Assicuratevi che il vostro playbook aderisca alla struttura necessaria e faccia riferimento a tutti i ruoli e le raccolte richiesti per un'esecuzione senza problemi in Schematics. Per ulteriori informazioni, consultare la documentazione Ansible o la creazione del playbook.

Riferimento alle raccolte Ansible nel playbook

Ansible le raccolte sono gruppi di risorse riutilizzabili di Ansible, come playbook, moduli e ruoli, che si possono installare e usare nel playbook. Le collezioni sono disponibili nel repository Ansible Galaxy.

Analogamente ai ruoliAnsible, le raccolte richiedono una struttura di cartella specifica nel tuo repository GitHub.

Per utilizzare le raccolte nel playbook Schematics, procedere come segue

Sfogliare Ansible Galaxy per trovare la raccolta che si desidera utilizzare nel playbook.
Creare un file requirements.yml per specificare le collezioni che si desidera installare da Ansible Galaxy. La struttura dei file dovrebbe seguire la documentazione Ansible. Ecco un esempio che utilizza la collezione community.kubernetes.
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
Aggiungere una cartella collections al repository GitHub, relativa al playbook, e inserire il file requirements.yml in questa cartella.
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
Fai riferimento a una risorsa della tua raccolta nel tuo playbook. Per ulteriori informazioni, consultare la documentazione Ansible. Assicuratevi che la struttura delle cartelle del vostro playbook sia conforme ai requisiti e che faccia correttamente riferimento alle raccolte per un'esecuzione perfetta in Schematics.

Preparazione del Playbook di Ansible per Schematics

Prima di eseguire il playbook Ansible in Schematics, considerate i seguenti punti:

Archiviare il playbook Ansible in un repository GitHub o GitLab.
Tenere presente le limitazioni quando si specificano gli host di destinazione per l'inventario delle risorse di Ansible. Per ulteriori informazioni, consultare le linee guida sulla creazione di inventari delle risorse per le azioni di Schematics.
Assicurarsi che i playbook siano compatibili con una versione di Ansible supportata in Schematics. Per verificare le versioni supportate, eseguire il comando ibmcloud schematics version il comando.
Facoltativamente, esplora le funzionalità del playbook Ansible in Schematics utilizzando uno dei playbook Ansible forniti da IBM.

Passi successivi

Dopo aver compreso i prerequisiti e le fasi di preparazione per il playbook Ansible, il passo successivo è la creazione di un'azione Schematics. Questo processo comporta la specificazione del playbook Ansible, la configurazione dell'inventario delle risorse e l'impostazione delle credenziali o delle variabili necessarie. Per procedere, seguire la guida alla creazione di un'azione Schematics.