Creare un'azione utilizzando la Console

Crea un'azione " Schematics " e specifica il playbook " Ansible " che desideri eseguire sulle tue risorse Cloud.

1. Accedere alla console IBM Cloud.

2. Fare clic sull'icona del menu > Automazione della piattaforma Schematics > Ansible e spostarsi su Crea playbook.

   • Creare un libro di giochi.

     1. Inserire un nome di playbook e una descrizione per l'azione. Il nome può contenere fino a 128 caratteri e può includere caratteri alfanumerici, spazi, trattini e caratteri di sottolineatura.
     2. Inserire il repository GitHub o GitLab URL dove è memorizzato il playbook Ansible. Il file URL può puntare al ramo master, a qualsiasi altro ramo o a una sottodirectory. Se il repository memorizza più playbook, è necessario selezionare il playbook che si desidera eseguire. Un'azione di Schematics può puntare a un libro di giochi alla volta. Per eseguire più playbook, è necessario creare un'azione separata per ogni playbook.

     Se non avete un playbook, provate uno dei playbook di esempio.

     3. Facoltativo: inserire la Filiale (facoltativo) e la Cartella (facoltativo).
     4. Facoltativo: se desideri utilizzare un repository privato su GitHub, inserisci il tuo token di accesso personale. Il token di accesso personale viene utilizzato per l'autenticazione nel repository privato GitHub, al fine di accedere al playbook Ansible. Per ulteriori informazioni su come creare un token di accesso, vedere Creazione di un token di accesso personale per la CLI.

     Per ulteriori informazioni, consulta l'elenco delle estensioni di file consentite e bloccate per la clonazione dal repository Git. Per convalidare e clonare il modello in modo sicuro, puoi cliccare su " Open reference picker " per selezionare il tuo riferimento alla chiave Secrets Manager. Per ulteriori informazioni, consultare la sezione dedicata alla creazione di un'istanza di Secrets Manager.

   • Ulteriori informazioni

     1. Facoltativo: inserisci i tag che desideri aggiungere alla tua azione. I tag aiutano nella ricerca rapida della vostra azione.
     2. Seleziona il gruppo di risorse in cui desideri creare l'azione.
     3. Seleziona la posizione in cui desideri creare l'azione. La posizione determina dove viene eseguita l'azione e dove vengono memorizzati i dati relativi all'azione. È possibile scegliere una geografia, ad esempio Dallas, o Frankfurt. Se si seleziona una geografia, Schematics sceglie una sede all'interno di questa geografia in base alla disponibilità. Assicurarsi di poter memorizzare i dati dell'azione in questa posizione, poiché non è possibile modificarla dopo la creazione dell'azione. Per ulteriori informazioni, vedere Dove vengono memorizzate le informazioni? Assicurarsi che la posizione dell'azione sia indipendente dalla posizione della risorsa Cloud in cui si desidera eseguire il playbook Ansible.

   • Scegli un inventario È possibile definire i gruppi di host su cui si desidera eseguire il playbook " Ansible ".

     1. Fare clic su Crea inventario.

     2. Inserisci un nome per il tuo inventario.

     3. Scegliere il tipo di connessione SSH o WinRM a seconda dei requisiti dell'host remoto. L'impostazione predefinita è SSH.

        Il tipo di connessione supporta sia SSH che WinRM per la connessione a host remoti. Per SSH assicurarsi che sia configurato l'accesso all'host Bastion. WinRM è usato per connettersi con gli host remoti di Windows. Attualmente, WinRM supporta solo i sistemi Windows con il sito pubblico IPs e non supporta l'accesso all'host Bastion.

     4. Verificare il sito location e selezionare il sito Resource group in cui si desidera creare l'inventario.

     5. Fare clic su " Crea gruppo di host ".

     6. Immettere un nome per il gruppo di host e selezionare l'area di lavoro Schematics che ha eseguito il provisioning degli host di destinazione che si desidera aggiungere al gruppo di host.

     7. Facoltativo: Fare clic su Aggiungi query per aggiungere un'altra condizione alla query e limitare il numero di host di destinazione aggiunti al gruppo di host. Si può scegliere di identificare gli host usando il nome della risorsa o un tag. Per ulteriori informazioni, vedere le query di risorse supportate.

     8. Fare clic su Aggiungi un'altra condizione e ripetere i passaggi 6-8 per aggiungere altri gruppi di host.

     9. Facoltativo: Fare clic sulla scheda Definisci manualmente per definire gli host e i gruppi di host su cui opera il playbook.

     10. Inserire i dettagli dell'host utilizzando il formato file.ini nell'opzione File.

     11. Dall'elenco della tabella, selezionare i gruppi di host da includere nell'inventario delle risorse.

     12. Fare clic su Crea inventario per definire un file di inventario che definisce gli host e i gruppi di host su cui opera il playbook.

3. Dalla tabella dell'inventario delle risorse, selezionare un inventario di risorse esistente e fare clic sull'icona Modifica.

   • Fare clic su Gestisci credenziali per configurare le credenziali dell'inventario. Per ulteriori informazioni, vedere Gestione delle credenziali.
   • Fare clic su Gestisci variabili per configurare le variabili dell'inventario. Per ulteriori informazioni, vedere Gestione delle variabili.
   • Fare clic su Elimina per rimuovere l'inventario.

4. Fai clic su Crea. L'azione viene creata con lo stato Normal e si accede alla sezione Dettagli.

5. Fare clic su Controlla azione per verificare che le attività che si sta cercando di eseguire e le risorse siano collegate al playbook. È possibile monitorare la sezione Cronologia azioni per visualizzare i risultati nei registri. Questo controllo verifica che le attività che si sta cercando di eseguire e le risorse siano collegate correttamente al playbook.

   Non è possibile eliminare o interrompere un’attività in esecuzione dell’azione “ Schematics ”. Per modificare l'azione, attendere il completamento del lavoro e modificare le impostazioni, quindi fare nuovamente clic su Controlla azione o Esegui azione.

6. Fare clic su Esegui azione per eseguire l'azione. È possibile monitorare l'avanzamento di un'azione esaminando i registri nella pagina Lavori. Ogni 30 seconds i registri dei lavori vengono aggiornati automaticamente.

Creazione di un'azione tramite CLI

1. Dall'interfaccia CLI locale, impostare il plug-in Schematics.
2. Creare un'azione utilizzando il comando ibmcloud schematics action create.
3. Creare un inventario utilizzando il comando ibmcloud schematics inventory create.
4. Controllare i registri per verificare che la creazione sia avvenuta con successo.

Creazione di un'azione tramite API

1. Recuperare il token di accesso IAM e autenticarsi con Schematics.
2. Opzionale: Creare un'azione inviando una richiesta POST.
3. Creare un inventario inviando una richiesta POST.
4. Controllare lo stato della risposta per verificare che la creazione sia avvenuta con successo.