Creazione di configurazioni Satellite dalla console

Per distribuire un'applicazione di esempio, vedi Distribuzione delle risorse Kubernetes ai cluster con Satellite Config.

Per creare la tua configurazione personalizzata, utilizza l'IU Satellite e attieniti alla seguente procedura.

1. Accedi alla IU di configurazioneSatellite con le tue credenziali IBM Cloud.

2. Fare clic su Crea configurazione.

3. Nella pagina Sfoglia modelli, selezionare il modello Caricamento diretto.

4. Nella pagina Configurazione, specificare il nome della configurazione e l'ubicazione dei dati.

5. Nella pagina Versione, specificare la descrizione e il nome della versione. Quindi caricare un file esistente o utilizzare l'editor YAML per incollare il contenuto del file.

6. Nella pagina Sottoscrizione, specifica il nome della sottoscrizione, la versione della sottoscrizione e il gruppo di cluster a cui distribuire.

7. Nella pagina Riepilogo, confermare che le informazioni visualizzate siano corrette e fare clic su Completa.

Creazione di configurazioni Satellite dalla CLI

Utilizza il plugin CLI per i comandi Satellite per creare una configurazione e caricare la definizione della risorsa Kubernetes che vuoi distribuire ai tuoi cluster.

Per creare la configurazione:

1. Configura i tuoi cluster da utilizzare con Satellite Config. Questa configurazione include la creazione di un gruppo di cluster e la concessione dell'accesso di configurazione Satellite ai tuoi cluster.

2. Aggiungere cluster al proprio gruppo di cluster. I cluster possono essere eseguiti nella tua ubicazione o in IBM Cloud.

   1. Elencare i cluster registrati con il componente di configurazione Satellite e annotarne l'ID.

      ibmcloud sat cluster ls
      

   2. Aggiungere il cluster al proprio gruppo di cluster.

      ibmcloud sat group attach --cluster <cluster_ID> --group <cluster_group_name>
      

   3. Verificare che il cluster sia stato aggiunto correttamente al proprio gruppo di cluster.

      ibmcloud sat group get --group <cluster_group_name>
      

3. Crea una configurazione Satellite.

   ibmcloud sat config create --name <config_name> [--data-location <location>] [-q]
   

   Descrizione dei componenti di questo comando

   Componente	Descrizione
   --name <config_name>	Immettere il nome della configurazione Satellite.
   --data-location <location>	Immetti l'ubicazione per memorizzare le tue configurazioni Satellite, ad esempio us-east. Satellite sono definizioni della risorsa Kubernetes, come ConfigMaps, classi di archiviazione o segreti distribuiti ai cluster nella tua ubicazione tramite le sottoscrizioni. Se --data-location non è specificato, le configurazioni vengono memorizzate in us-east per impostazione predefinita. Queste ubicazioni sono i bucket IBM Cloud Object Storage di proprietà di IBM e sono pre - forniti per ogni regione. Per ulteriori informazioni su come vengono archiviati i tuoi dati, vedi Come vengono archiviate, sottoposte a backup e crittografate le mie informazioni?. Per un elenco di ubicazioni, vedi Ubicazioni supportate.
   -q	Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

   Output di esempio

   Creating configuration...
   OK
   Configuration <config_name> was successfully created with ID 116fffde-0835-467c-8987-67dd42e4e393.
   

4. Crea una Sottoscrizione per il tuo gruppo di cluster nella configurazione Satellite. Dopo che hai creato la sottoscrizione, Satellite Config scarica automaticamente il file di risorsa Kubernetes per la versione che hai specificato e inizia ad applicarlo su tutti i cluster che appartengono al gruppo di cluster. Il completamento di questo processo richiede alcuni minuti. Inoltre, le informazioni su tutte le risorse Kubernetes che crei vengono inviate nuovamente dai tuoi cluster alla configurazione Satellite e possono essere riesaminate nel dashboard Satellite Risorse cluster. Esaminare le opzioni del comando eseguendo ibmcloud sat subscription create.

   ibmcloud sat subscription create --group <cluster_group_name> --config <config_name_or_ID> --name <subscription_name> --version <version_name_or_ID>
   

   Descrizione dei componenti di questo comando

   Componente	Descrizione
   --group <cluster_group_name>	Immetti il nome del gruppo di cluster in cui vuoi distribuire le tue risorse Kubernetes.
   --config <config_name_or_ID>	Immetti il nome o ID della configurazione Satellite che hai creato in precedenza.
   --name <subscription_name>	Immettere un nome per la sottoscrizione Satellite.
   --version <version_name_or_ID>	Immetti il nome o l'ID della definizione della risorsa Kubernetes che hai aggiunto come versione alla tua configurazione. Per elencare le versioni disponibili, eseguire ibmcloud sat config get --config <config_name_or_ID>

   Output di esempio

   Creating subscription...
   OK
   Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.
   

5. Segui il passo 5 in Creazione delle configurazioni Satellite dalla console per esaminare lo stato di rollout delle tue risorse Kubernetes.

Aggiornamento della configurazione Satellite dalla console

Utilizza la console Satellite per caricare un nuovo file di versione e modificare la sottoscrizione per utilizzarlo.

1. Dal menu azioni di una configurazione, fare clic su Aggiungi versione.
   1. Immettere un nome e una descrizione facoltativa per la propria versione.
   2. Carica un file YAML della risorsa Kubernetes o utilizza l'editor per immettere direttamente la definizione della tua risorsa Kubernetes. Assicurati di specificare lo spazio dei nomi Kubernetes in cui vuoi che venga distribuita la tua risorsa. Se non si specifica uno spazio dei nomi, la risorsa viene distribuita allo spazio dei nomi razeedeploy per impostazione predefinita.
   3. Facoltativo: per visualizzare le risorse dopo che sono state create nel cluster tramite il dashboard di configurazione Satellite, aggiungi l'etichetta razee/watch-resource=lite alla sezione metadata.labels del tuo file YAML oppure scegli un'altra opzione per visualizzare le tue risorse distribuite, come l'aggiunta di una ConfigMap al tuo cluster.
   4. Fai clic su Add per aggiungere la definizione della risorsa Kubernetes come versione alla tua configurazione.
2. Crea una sottoscrizione per il tuo gruppo di cluster. La sottoscrizione definisce quale configurazione Satellite distribuire le risorse Kubernetes nei cluster.
   1. Selezionare la configurazione creata per visualizzare i dettagli di configurazione.
   2. Fai clic su Crea sottoscrizione.
   3. Immettere un nome per la sottoscrizione e selezionare il nome della versione e il gruppo di cluster creato in precedenza.
   4. Fare clic su Crea per creare la sottoscrizione.
3. Seleziona la tua sottoscrizione per visualizzare i relativi dettagli e lo stato di rollout della distribuzione della tua risorsa Kubernetes. Se si verificano errori durante la distribuzione, ad esempio file YAML con errori di formattazione o valori di versione API non supportati, è possibile visualizzare il messaggio di errore nella colonna Messaggio dei dettagli della sottoscrizione.

(DA AGGIORNARE CON NUOVI COMANDI:) Aggiornamento della configurazione Satellite con la CLI

Utilizza il plugin CLI per i comandi Satellite per caricare un nuovo file di versione e modificare la tua sottoscrizione per utilizzarlo.

1. Crea una Versione caricando un file di risorsa Kubernetes nella tua configurazione. Assicurati di specificare lo spazio dei nomi Kubernetes in cui vuoi che venga distribuita la tua risorsa. Se non si specifica uno spazio dei nomi, la risorsa viene distribuita allo spazio dei nomi razeedeploy per impostazione predefinita. Esaminare le opzioni del comando eseguendo ibmcloud sat config version create.

   Per visualizzare le risorse dopo che sono state create nel cluster tramite il dashboard di configurazione Satellite, aggiungi l'etichetta razee/watch-resource=lite alla sezione metadata.labels del tuo file YAML oppure scegli un'altra opzione per visualizzare le tue risorse distribuite, come ad esempio l'aggiunta di una ConfigMap al tuo cluster.

   ibmcloud sat config version create --name <version_name> --config <config_name_or_ID> --file-format yaml --read-config <file_path>
   

   Descrizione dei componenti di questo comando

   Componente	Descrizione
   --name <version_name>	Immettere un nome per la versione di configurazione.
   --config <config_name_or_ID>	Immetti il nome o ID della configurazione Satellite che hai creato in precedenza.
   --read-config <file_path>	Immetti il percorso del file relativo al file di risorsa Kubernetes sulla macchina locale.

   Output di esempio

   Creating configuration version...
   OK
   Configuration Version <version_name> was successfully created with ID ad5ae7a9-4f74-486c-816a-32de98de00df.
   

2. Crea una Sottoscrizione per il tuo gruppo di cluster nella configurazione Satellite. Dopo che hai creato la sottoscrizione, Satellite Config scarica automaticamente il file di risorsa Kubernetes per la versione che hai specificato e inizia ad applicarlo su tutti i cluster che appartengono al gruppo di cluster. Il completamento di questo processo richiede alcuni minuti. Inoltre, le informazioni su tutte le risorse Kubernetes che crei vengono inviate nuovamente dai tuoi cluster alla configurazione Satellite e possono essere riesaminate nel dashboard Satellite Risorse cluster. Esaminare le opzioni del comando eseguendo ibmcloud sat subscription create.

   ibmcloud sat subscription create --group <cluster_group_name> --config <config_name_or_ID> --name <subscription_name> --version <version_name_or_ID>
   

   Descrizione dei componenti di questo comando

   Componente	Descrizione
   --group <cluster_group_name>	Immetti il nome del gruppo di cluster in cui vuoi distribuire le tue risorse Kubernetes.
   --config <config_name_or_ID>	Immetti il nome o ID della configurazione Satellite che hai creato in precedenza.
   --name <subscription_name>	Immettere un nome per la sottoscrizione Satellite.
   --version <version_name_or_ID>	Immetti il nome o l'ID della definizione della risorsa Kubernetes che hai aggiunto come versione alla tua configurazione. Per elencare le versioni disponibili, eseguire ibmcloud sat config get --config <config_name_or_ID>

   Output di esempio

   Creating subscription...
   OK
   Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.
   

3. Segui il passo 5 in Creazione delle configurazioni Satellite dalla console per esaminare lo stato di rollout delle tue risorse Kubernetes.