Creazione di inventari di risorse per le azioni Schematics

Un inventario di risorse definisce una singola risorsa IBM Cloud o un gruppo di risorse in cui si desidera eseguire Ansible playbook, moduli o ruoli utilizzando le azioni Schematics.

Puoi specificare il tuo inventario di risorse utilizzando un file di inventario statico o richiamare dinamicamente le risorse di destinazione IBM Cloud dagli spazi di lavoro Schematics.

Creazione di file di inventario statico

Schematics supporta la definizione dei file hosts.ini in cui specifichi un singolo host di destinazione o un gruppo di host di destinazione utilizzando il relativo indirizzo IP. Puoi assegnare i nomi a un gruppo di host di destinazione, come [webserver], e utilizzare questo nome nel playbook Ansible per indicare a Schematics dove eseguire le attività del playbook.

Definizione di host statici

Per connettersi a un host di destinazione tramite SSH, Ansible richiede un nome host risolvibile DNS o un indirizzo IP.

L'utilizzo tipico delle azioni Schematics per configurare le VSI su IBM Cloud è tramite un host bastion. Vedi documentazione delle azioni. L'accesso all'interfaccia di rete privata di una VSI avviene tramite un host bastion. Ciò significa utilizzare l'indirizzo IP privato degli host per la connessione all'host di destinazione, poiché i nomi host privati non vengono pubblicizzati dal DNS in Schematics. Per gli host privati, l'inventario deve essere configurato con un indirizzo IP e l'indirizzo IP di un host bastion.

Le VSI con indirizzi IP pubblici e nomi host DNS registrati pubblicamente possono essere indicati da nomi host DNS completi.

L'utilizzo dei nomi host (in formato breve) non è supportato.

Creazione del file host

Accedere alla consoleIBM Cloud.
Fare clic sull'icona del menu > Automazione della piattaforma > Schematics > Ansible.
Fare clic sul nome della playbook.
Fare clic su Inventario > Crea inventario.
Immettere un nome per l'inventario, verificare l'ubicazione e selezionare il Resource group in cui si desidera creare un inventario.
Selezionare la scheda Definisci manualmente.
Nel campo File, immettere gli host di destinazione in cui si desidera eseguire il playbook Ansible. Assicurarsi di specificare gli host in una sintassi INI. Per una sintassi di esempio, consultare Formato file. Esamina le limitazioni per assicurarti che la tua definizione di inventario sia supportata in Schematics.
Fare clic su Crea inventario.
Segui la procedura per creare un'azione Schematics e utilizza l'inventario delle risorse che hai creato.

Formato file

Esaminare il seguente file hosts.ini di esempio per visualizzare la struttura dell'elenco di inventario host statico. Per ulteriori informazioni sulle strutture dei file hosts.ini, consultare la documentazioneAnsible.

Questo esempio fa riferimento agli host accessibili pubblicamente tramite il nome host e agli host privati tramite l'indirizzo IP.

mail.example.com

[webservers]
web1.mydomain.com
web2.mydomain.com

[dbservers]
172.16.5.9
172.16.5.10
172.16.5.11

[datacenters]
172.15.4.0

Limitazioni

Esamina le seguenti limitazioni dei file di inventario statici in Schematics:

Schematics supporta solo la sintassi del file INI.
Le variabili non sono supportate nei file hosts.ini.
La specifica di gruppi host utilizzando coppie chiave - valore nei file hosts.ini non è supportata.
È necessario aggiornare manualmente il file hosts.ini se il nome host o l'indirizzo IP degli host di destinazione cambiano.
Quando gli host sono protetti da un host bastion e accessibili solo tramite l'indirizzo IP privato, è necessario specificare l'indirizzo IP dell'host.
Quando gli host sono accessibili tramite un indirizzo IP accessibile pubblicamente e hanno un nome DNS registrato, è possibile fare riferimento all'host tramite il suo nome host completo.
Tutti gli host di destinazione devono essere configurati con la stessa chiave SSH pubblica. Quando utilizzi il file di inventario statico nella tua azione Schematics, puoi specificare una chiave SSH per l'autenticazione con tutti gli host di destinazione inclusi nell'inventario delle risorse. La chiave SSH deve contenere \n alla fine dei dettagli della chiave in caso di chiamate della riga di comando o API. Per ulteriori informazioni sulle chiavi SSH, vedi Aggiunta di una chiave SSH.

Creazione dinamica degli inventari delle risorse dagli spazi di lavoro Schematics

Puoi creare in modo dinamico il tuo inventario delle risorse dalle risorse cloud che hai fornito con gli spazi di lavoro di Schematics.

Inventari dinamici delle risorse: riferimenti alle risorse cloud che hai fornito con gli spazi di lavoro di Schematics. Per recuperare le risorse cloud dalle aree di lavoro, utilizzare le query predefinite per le risorse. Non è necessario tenere traccia degli indirizzi IP assegnati alle risorse di destinazione, poiché l' Schematics e determina automaticamente gli host di destinazione quando si utilizza questo inventario nell'azione " Schematics ".

Accedere alla consoleIBM Cloud.
Fare clic sull'icona del menu > Automazione della piattaforma > Schematics > Ansible.
Fare clic sul nome della playbook.
Fare clic su Inventario > Crea inventario.
Immettere un nome per l'inventario, verificare l'ubicazione e selezionare il Resource group in cui si desidera creare un inventario.
Selezionare la scheda Gruppi host.
Fare clic su Crea gruppo host.
Immettere un nome per il gruppo di host e selezionare lo spazio di lavoro Schematics che ha fornito gli host di destinazione che si desidera aggiungere al gruppo di host.
Facoltativo: fai clic su Aggiungi query per aggiungere un'altra condizione alla tua query e limitare il numero di host di destinazione che vengono aggiunti al tuo gruppo di host. È possibile scegliere di identificare gli host utilizzando il nome della risorsa o una tag. Per ulteriori informazioni, consultare Query di risorse supportate.
Ripetere i punti 5-8 per aggiungere altri gruppi di host.
Dall'elenco di tabelle, selezionare i gruppi host che si desidera inserire nell'inventario delle risorse.
Fare clic su Crea inventario.
Seguire passi per creare le azioni Schematics e utilizzare l'inventario di risorse creato.

Query di risorse supportate

Query delle risorse
Query supportata	Descrizione
Nome area di lavoro	Seleziona tutte le risorse cloud da un'area di lavoro specifica.
Nome spazio di lavoro E nome risorsa	Selezionare una specifica risorsa da uno specifico spazio di lavoro utilizzando il nome risorsa. Per selezionare più risorse dallo stesso spazio di lavoro, è possibile aggiungere più query di questo tipo.
Nome spazio di lavoro AND tag	Selezionare una specifica risorsa da un determinato spazio di lavoro utilizzando le tag. Le tag vengono aggiunte alla risorsa quando si crea lo spazio di lavoro e si esegue il provisioning della risorsa. Per selezionare più risorse con tag differenti dallo stesso spazio di lavoro, è possibile aggiungere più query di questo tipo.

Limitazioni

Controlla le seguenti limitazioni degli inventari dinamici in Schematics:

Puoi scegliere tra le interrogazioni supportate per selezionare le istanze del server virtuale di destinazione da includere nel tuo inventario di risorse.
Schematics richiama l'indirizzo IP di una destinazione Virtual Servers for VPCe aggiunge l'indirizzo IP all'inventario delle risorse. Se la destinazione Virtual Servers for VPC ha un indirizzo IP pubblico, l'indirizzo IP pubblico viene utilizzato per l'inventario delle risorse. Se non è presente alcun indirizzo IP pubblico, l'indirizzo IP privato viene utilizzato per l'inventario delle risorse.
Tutti gli host di destinazione devono essere configurati con la stessa chiave SSH pubblica. Quando utilizzi il file di inventario statico nella tua azione Schematics, puoi specificare una chiave SSH per l'autenticazione con tutti gli host di destinazione inclusi nell'inventario delle risorse. La chiave SSH deve contenere \n alla fine dei dettagli della chiave in caso di chiamate della riga di comando o API. Per ulteriori informazioni sulle chiavi SSH, vedi Aggiunta di una chiave SSH.