Creazione di cluster Satellite dalla console

Usare la console IBM Cloud per creare i cluster Red Hat OpenShift sull'infrastruttura Satellite.

D alla console, fare clic su Crea. Esamina quindi le seguenti sezioni per impostare il tuo cluster.

Infrastruttura

Seleziona Satellite.

Posizione

Seleziona il Gruppo di risorse e l'ubicazioneSatellite in cui vuoi creare il cluster.

Nelle ubicazioni abilitate a RHCOS, quando vuoi aggiungere i pool di nodi di lavoro al tuo cluster, puoi utilizzare gli host RHCOS o RHEL. Assicurati di collegare gli host al sistema operativo che vuoi utilizzare alla tua ubicazione prima di assegnarli a un pool di nodi di lavoro.

Topologia dell'infrastruttura

• Altamente disponibile: scegliere questa opzione per la maggior parte dei casi di utilizzo. Crea almeno 3 nodi di lavoro per l'alta disponibilità.

• Replica singola: i cluster a nodo singolo sono consigliati solo in circostanze specifiche e devono essere utilizzati solo in ubicazioni edge vincolate alle risorse che hanno più ubicazioni ridondanti che eseguono lo stesso carico di lavoro. Se stai eseguendo la tua infrastruttura Red Hat OpenShift on IBM Cloud su Satellite in un'ubicazione edge remota, con risorse limitate, come un piccolo data center in una torre mobile, l'esecuzione di un piano di dati con un piede più piccolo potrebbe essere utile per la tua configurazione. Mentre i cluster tipici di Red Hat OpenShift on IBM Cloud richiedono almeno tre nodi di lavoro per l'alta disponibilità, hai l'opzione di creare un cluster che esegue un singolo nodo di lavoro. I cluster a nodo singolo hanno diverse limitazioni e devono essere utilizzati solo in circostanze specifiche. I cluster a nodo singolo non dispongono di alta disponibilità. Eseguendo il provisioning di un cluster a nodo singolo, accetti di avere maggiori probabilità di riscontrare tempi di inattività e interruzioni nel tuo carico di lavoro. I cluster a nodo singolo devono essere eseguiti su un'ubicazione Satellite con CoreOS abilitato. Gli host del piano di controllo sulla tua ubicazione e l'host che assegni al tuo cluster a nodo singolo devono eseguire i sistemi operativi RHEL 8 o RHCOS. Supportato solo per cluster Satellite che eseguono la versione 4.11 o successive. Per ulteriori informazioni, consultare la sezione Limitazioni.

Pool di lavoro predefinito

Configura i dettagli per il pool di nodi di lavoro predefinito.

• Sistema operativo host: selezionare il sistema operativo degli host che si desidera utilizzare nel pool di nodi di lavoro predefinito del cluster. Nelle ubicazioni abilitate per Red Hat CoreOS, puoi utilizzare i tuoi host RHCOS o RHEL.

• Le zone del pool di lavoro che Satellite utilizza per assegnare uniformemente gli host tra le zone che rappresentano le zone nel tuo provider dell'infrastruttura sottostante. In genere, crea il pool di nodi di lavoro in 3 zone per l'alta disponibilità.

• vCPU, Memoria (GB) e numero di nodi worker per zona: Richiedere le risorse con cui si vuole creare il pool di worker. Satellite può assegnare automaticamente gli host disponibili al pool di worker per soddisfare la richiesta. In genere, seleziona almeno 1 nodo di lavoro per zona per un totale di 3 nodi di lavoro nel cluster.

Versione OpenShift

Selezionare la versione del cluster. Scegliere la versione predefinita oppure è possibile specificare una versione supportata diversa.

Licenza OPC (OpenShift Container Platform)

Tutti i cluster utente nella tua ubicazione Satellite sono installati con OpenShift Container Platform, che comporta un costo di licenza da Red Hat. Tuttavia, puoi portare la tua propria licenza OpenShift Container Platform per i cluster creati con la tua infrastruttura in loco o per i cluster creati in loco utilizzando IBM Cloud Paks. I cluster di servizi, che sono la piattaforma sottostante per tutti i servizi IBM Cloud vengono creati da servizi come Key Protect o IBM Cloud Object Storage e non richiedono una licenza.

• Applica la mia titolarità Cloud Pak: seleziona questa opzione per applicare la tua titolarità Cloud Pak al pool di nodi di lavoro predefinito. Le titole Cloud Pak vengono applicate a livello di pool di nodi di lavoro. Non superare la tua titolarità. Tieni presente che le tue titolarità OpenShift Container Platform possono essere utilizzate con altri provider cloud o in altri ambienti. Per evitare problemi di fatturazione in un secondo momento, assicurati di utilizzare solo ciò per cui disponi di titolarità. Ad esempio, potresti avere una titolarità per le licenze OCP per due nodi di lavoro di 4 CPU e 16 GB di memoria e crei questo pool di nodi di lavoro con due nodi di lavoro di 4 CPU e 16 GB di memoria. Hai esaurito il tuo diritto e non puoi utilizzare lo stesso diritto per altri gruppi di lavoratori, fornitori di servizi cloud o ambienti.

• Acquista una licenza: acquista una nuova licenza OpenShift Container Platform per il pool di nodi di lavoro predefinito. Questa opzione viene applicata a livello di pool di lavoro. Quando crei ulteriori pool di nodi di lavoro, devi acquistare ulteriori licenze.

• Gestisci con Red Hat OpenShift Cluster Manager: specifica una titolarità OCP esistente per i nodi di lavoro in questo cluster fornendo il tuo segreto di pull dell'account Red Hat® come un file o in formato JSON non elaborato. Il cluster utilizza anche questo segreto di pull per scaricare immagini Red Hat OpenShift dal proprio account Red Hat. Questa opzione viene applicata a livello di cluster.

Satellite

Decidere se abilitare l'accesso amministratore del cluster per la configurazione Satellite. Se non concedi l'accesso alla configurazione Satellite, non puoi utilizzare in seguito la funzionalità di configurazione Satellite per visualizzare o distribuire le risorse Kubernetes per i tuoi cluster. Se desideri abilitare l'accesso in un secondo momento, puoi creare ruoli RBAC personalizzati per la configurazione di Satellite.

Crittografia

Abilita la crittografia dei dati con un KMS (key management service) per crittografare i segreti e altre informazioni sensibili nel tuo cluster. Puoi anche abilitare KMS in un secondo momento.

Gestione dei segreti in entrata

IBM Cloud Secrets Manager gestisce centralmente i certificati del dominio secondario Ingress e altri segreti nel tuo cluster. Puoi scegliere di registrare un'istanza Secrets Manager nel tuo cluster durante il processo di creazione del cluster. È anche possibile specificare un gruppo di segreti che è possibile utilizzare per controllare l'accesso ai segreti nel cluster. Entrambe queste opzioni possono essere configurate o modificate dopo aver creato il cluster.

Dettagli cluster

Fornisci un nome al tuo cluster e immetti qualsiasi tagIBM Cloud che vuoi associare alla tua risorsa cloud. Il nome del cluster deve iniziare con una lettera, può contenere lettere, numeri e trattini (-), e deve avere una lunghezza massima di 35 caratteri.

Se non ci sono host disponibili e corrispondenti nella posizione Satellite, il cluster viene comunque creato ma entra in uno stato di Attenzione. Collegare gli host alla posizione Satellite in modo che gli host possano essere assegnati come nodi lavoratori al pool di lavoratori. Se gli host non sono stati assegnati automaticamente, è possibile anche assegnarli manualmente assegnare gli host Satellite al cluster. Assicurati di assegnare gli host come nodi di lavoro in ogni zona del pool di nodi di lavoro predefinito.

Se gli host di localizzazione dispongono solo di connettività di rete privata o se si utilizzano gli host Amazon Web Services, Google Cloud Platform o Microsoft Azure, è necessario essere connessi alla rete privata degli host, ad esempio tramite accesso VPN, per connettersi al cluster e accedere alla console web Red Hat OpenShift. In alternativa, se i tuoi host hanno la connettività di rete pubblica, puoi verificare l'accesso al tuo cluster modificando i record DNS del tuo cluster e della tua ubicazione in modo da utilizzare gli indirizzi IP pubblici dei tuoi host.

Attendi che il tuo cluster raggiunga lo stato Normale, quindi accedi al tuo cluster per accedere alla console web Red Hat OpenShift o per eseguire comandi oc e kubectl dalla CLI. Se hai abilitato l'accesso alla configurazione Satellite, devi completare questo passo per sincronizzare le autorizzazioni.

Creazione di cluster Satellite da CLI

Utilizzare la CLI di Satellite per creare i cluster di Red Hat OpenShift sull'infrastruttura di Satellite.

Prima di iniziare, installa il plug-in della CLISatellite.

1. Completare i passi prerequisiti.

2. Verifica che la tua ubicazione sia in uno stato Normale. L'ubicazione è in uno stato Normale quando hai creato correttamente il piano di controllo Satellite e tutti gli host che utilizzi per il piano di controllo sono in uno stato integro.

   ibmcloud sat location ls
   

   Output di esempio

   Retrieving locations...
   OK
   Name         ID                     Status            Ready   Created      Hosts (used/total)   Managed From   
   mylocation   brhtfum2015a6mgqj16g   normal            yes     4 days ago   3 / 6                Dallas   
   

3. Crea un cluster Red Hat OpenShift nell'ubicazione Satellite. Quando crei il cluster, il master cluster viene creato automaticamente sul tuo piano di controllo Satellite.

   • Per assicurarti che gli host vengano assegnati automaticamente come nodi di lavoro nel pool di nodi di lavoro predefinito del tuo cluster, specifica le etichette degli host nelle opzioni --host-label e specifica il numero di nodi di lavoro per zona nell'opzione --workers.
   • Per abilitare l'accesso di amministratore del cluster per la configurazione Satellite, includere l'opzione --enable-admin-agent. Se non concedi l'accesso alla configurazione Satellite, non puoi utilizzare in seguito la funzionalità di configurazione Satellite per visualizzare o distribuire le risorse Kubernetes per i tuoi cluster. Se vuoi abilitare l'accesso in un secondo momento, puoi creare ruoli RBAC personalizzati per Satellite Config.
   • Per ulteriori informazioni sulle opzioni di questo comando, vedi la documentazione di riferimento CLI.
   • È possibile creare un cluster a nodo singolo includendo l'opzione --infrastructure-topology e specificando il valore single-replica quando si crea un cluster Satellite nella CLI. Se questa opzione non è inclusa, il cluster viene fornito con la configurazione altamente disponibile di tre nodi di lavoro per impostazione predefinita.
   • Per ottenere la tua licenza OCP, assicurati di includere il tuo Red Hat pull secret per autorizzare il cluster ad eseguire OCP, caricando il pull secret nella console o includendo l'opzione --pull-secret in ibmcloud oc cluster create satellite comando.
   • Per applicare la tua titolarità Cloud Pak, assicurati di includere l'opzione --entitlement ocp_entitled.

--operating-system RHEL_9_64|REDHAT_8_64|RHCOS

Facoltativo. Il sistema operativo dei nodi di lavoro nel tuo cluster. Per un elenco dei sistemi operativi disponibili per versione del cluster, consultare le informazioni sulla versione di Red Hat OpenShift on IBM Cloud. Se non viene specificata alcuna opzione, viene utilizzato il sistema operativo predefinito che corrisponde alla versione del cluster.

Comando cluster create di esempio.

ibmcloud oc cluster create satellite --location LOCATION --name NAME --pull-secret SECRET --version 4.21_openshift [--enable-admin-agent] [--host-label LABEL ...] [--operating-system SYSTEM] [--pod-subnet SUBNET] [-q] [--service-subnet SUBNET] [--workers WORKERS-PER-ZONE] [--zone ZONE] [--entitlement ENTITLEMENT]

Comando cluster create di esempio che utilizza host RHCOS e applica una licenza --pull-secret.

ibmcloud oc cluster create satellite --location LOCATION --name CLUSTER_NAME --pull-secret SECRET --version VERSION --enable-admin-agent --operating-system RHCOS

Output di esempio

Creating cluster...
OK
Cluster created with ID brkhsd220b6ktv7sjl50

4. Attendi che il cluster raggiunga lo stato Warning. Lo stato Warning indica che il master del cluster è stato distribuito completamente, ma non è stato possibile rilevare alcun nodo di lavoro nel cluster.

   ibmcloud oc cluster ls
   

   Output di esempio

   OK
   Name                ID                     State     Created          Workers   Location           Version                 Resource Group Name   Provider   
   satcluster          brkhsd220b6ktv7sjl50   warning   12 minutes ago   0         mylocation         4.5.23_1525_openshift   Default               satellite  
   

5. Assicurati che gli host siano assegnati come nodi di lavoro al cluster.

   • Assegnazione automatica: se hai incluso --host-labels quando hai creato il cluster e hai degli host disponibili con le etichette corrispondenti nella tua ubicazione Satellite, i nodi di lavoro vengono automaticamente assegnati al cluster. Se non hai alcun host disponibile e corrispondente, il cluster viene ancora creato ma passa allo stato Avvertenza. Collega gli host alla tua ubicazione Satellite in modo che gli host possano essere assegnati come nodi di lavoro al pool di nodi di lavoro. Se gli host non vengono assegnati automaticamente, puoi anche assegnare manualmente gli host Satellite al tuo cluster.
   • Assegnazione manuale: assegna gli host Satellite al tuo cluster. Una volta avviato correttamente, gli host fungono da nodi di lavoro del cluster per l'esecuzione dei carichi di lavo Red Hat OpenShift. Generalmente, assegna almeno 3 host come nodi di lavoro nel tuo cluster.

6. Verifica che il tuo cluster raggiunga uno stato normale.

   ibmcloud oc cluster ls
   

   Output di esempio

   OK
   Name         ID                     State    Created        Workers   Location     Version                 Resource Group Name   Provider   
   satcluster   brkhsd220b6ktv7sjl50   normal   2 hours ago    3         mylocation   4.3.23_1525_openshift   Default               satellite   
   

7. Accedi al tuo cluster per eseguire i comandi oc e kubectl o accedi alla console web Red Hat OpenShift. Se hai abilitato l'accesso alla configurazione Satellite, devi completare questo passo per sincronizzare le autorizzazioni.

Se gli host di localizzazione dispongono solo di connettività di rete privata o se si utilizzano gli host Amazon Web Services, Google Cloud Platform o Microsoft Azure, è necessario essere connessi alla rete privata degli host, ad esempio tramite accesso VPN, per connettersi al cluster e accedere alla console web Red Hat OpenShift. In alternativa, se i tuoi host hanno la connettività di rete pubblica, puoi verificare l'accesso al tuo cluster modificando i record DNS del tuo cluster e della tua ubicazione in modo da utilizzare gli indirizzi IP pubblici dei tuoi host.