Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Crea un HCP cluster ROSA con utilizzando ROSA CLI
Le sezioni seguenti descrivono come iniziare a utilizzare i ROSA piani di controllo ospitati (ROSAconHCP) utilizzando AWS STS e il ROSA CLI. Per i passaggi per creare un HCP cluster ROSA con Terraform, consulta la documentazione di Red Hat
Il ROSA CLIutilizza auto
mode o manual
mode per creare il IAM risorse e configurazione OpenID Connect (OIDC) necessarie per creare un ROSA
cluster. auto
la modalità crea automaticamente il necessario IAM ruoli, politiche e OIDC provider. manual
mode emette il AWS CLI comandi necessari per creare il IAM risorse manualmente. Utilizzando la manual
modalità, è possibile rivedere i dati generati AWS CLI comandi prima di eseguirli manualmente. Con manual
mode, puoi anche passare i comandi a un altro amministratore o gruppo dell'organizzazione in modo che possa creare le risorse.
Le procedure descritte in questo documento utilizzano la auto
modalità di ROSA CLIper creare il necessario IAM risorse e OIDC configurazione per ROSA withHCP. Per altre opzioni per iniziare, consultaInizia con ROSA.
Prerequisiti
Completa le azioni preliminari elencate inConfigurazione per l'uso ROSA.
Crea Amazon VPC architecture
La procedura seguente crea Amazon VPC architettura che può essere utilizzata per ospitare un cluster. Tutti cluster le risorse sono ospitate nella sottorete privata. La sottorete pubblica indirizza il traffico in uscita dalla sottorete privata attraverso un NAT gateway verso la rete Internet pubblica. Questo esempio utilizza il blocco per CIDR 10.0.0.0/16
Amazon VPC. Tuttavia, puoi scegliere un CIDR blocco diverso. Per ulteriori informazioni, vedi VPCdimensionamento.
Importante
Se Amazon VPC i requisiti non sono soddisfatti, la creazione del cluster non riesce.
Crea il file richiesto IAM ruoli e configurazione OpenID Connect
Prima di creare un HCP cluster ROSA with, è necessario creare il necessario IAM ruoli e politiche e la configurazione OpenID Connect (OIDC). Per ulteriori informazioni sull' IAM ruoli e politiche per ROSA withHCP, vediAWS politiche gestite per ROSA.
Questa procedura utilizza la auto
modalità di ROSA CLIper creare automaticamente la OIDC configurazione necessaria per creare un HCP cluster ROSA with.
-
Crea il richiesto IAM ruoli e politiche dell'account. Il
--force-policy-creation
parametro aggiorna tutti i ruoli e le politiche esistenti presenti. Se non sono presenti ruoli e politiche, il comando crea invece queste risorse.rosa create account-roles --force-policy-creation
Nota
Se il token di accesso offline è scaduto, ROSA CLIemette un messaggio di errore che indica che il token di autorizzazione deve essere aggiornato. Per la procedura di risoluzione dei problemi, consulta. Risolvi i problemi relativi ai token di ROSA CLI accesso offline scaduti
-
Crea la configurazione OpenID Connect (OIDC) che abilita l'autenticazione degli utenti nel cluster. Questa configurazione è registrata per essere utilizzata con OpenShift Cluster Manager (OCM).
rosa create oidc-config --mode=auto
-
Copia l'ID di OIDC configurazione fornito nel ROSA CLIuscita. L'ID di OIDC configurazione deve essere fornito in seguito per creare il HCP cluster ROSA with.
-
Per verificare le OIDC configurazioni disponibili per i cluster associati all'organizzazione degli utenti, esegui il comando seguente.
rosa list oidc-config
-
Crea il file richiesto IAM ruoli dell'operatore, sostituiti
<OIDC_CONFIG_ID>
con l'ID di OIDC configurazione copiato in precedenza.Importante
È necessario fornire un prefisso in
<PREFIX_NAME>
quando si creano i ruoli Operator. In caso contrario, si verificherà un errore.rosa create operator-roles --prefix <PREFIX_NAME> --oidc-config-id <OIDC_CONFIG_ID> --hosted-cp
-
Per verificare il IAM i ruoli operatore sono stati creati, esegui il comando seguente:
rosa list operator-roles
Crea un HCP cluster ROSA with usando il ROSA CLIe AWS STS
Puoi creare ROSA un HCP cluster utilizzo di AWS Security Token Service (AWS STS) e la auto
modalità fornita in ROSA CLI. Hai la possibilità di creare un cluster con un ingresso pubblico API e un ingresso privatoAPI.
È possibile creare un cluster con una singola zona di disponibilità (Single-AZ) o più zone di disponibilità (Multi-AZ). In entrambi i casi, il CIDR valore della macchina deve corrispondere al valore VPC del CIDR tuo.
La procedura seguente utilizza il rosa create cluster --hosted-cp
comando per creare un Single-AZ con ROSA HCP cluster. Per creare un Multi-AZ cluster, specifica multi-az
nel comando e nella sottorete privata IDs per ogni sottorete privata in cui desiderate effettuare la distribuzione.
-
Crea un HCP cluster ROSA with con uno dei seguenti comandi.
-
Crea un HCP cluster ROSA with con un public API e un Ingress, specificando il nome del cluster, il prefisso del ruolo dell'operatore, l'ID di OIDC configurazione e la sottorete pubblica e privata. IDs
rosa create cluster --cluster-name=<CLUSTER_NAME> --sts --mode=auto --hosted-cp --operator-roles-prefix <OPERATOR_ROLE_PREFIX> --oidc-config-id <OIDC_CONFIG_ID> --subnet-ids=<PUBLIC_SUBNET_ID>,<PRIVATE_SUBNET_ID>
-
Crea un HCP cluster ROSA with con un cluster privato API e Ingress, specificando il nome del cluster, il prefisso del ruolo dell'operatore, l'ID di configurazione e la sottorete privata. OIDC IDs
rosa create cluster --private --cluster-name=<CLUSTER_NAME> --sts --mode=auto --hosted-cp --subnet-ids=<PRIVATE_SUBNET_ID>
-
-
Controlla lo stato del tuo cluster.
rosa describe cluster -c <CLUSTER_NAME>
Nota
Se il processo di creazione fallisce o il
State
campo non diventa pronto dopo 10 minuti, consultaRisoluzione dei problemi.Per contattare Supporto o il supporto Red Hat per ricevere assistenza, consultaOttenere ROSA assistenza.
-
Monitora lo stato di avanzamento del cluster creazione guardando i log dell' OpenShift installatore.
rosa logs install -c <CLUSTER_NAME> --watch
Configura un provider di identità e concedi cluster accedi
ROSA include un OAuth server integrato. Dopo il tuo cluster è stato creato, è necessario configurarlo OAuth per utilizzare un provider di identità. Puoi quindi aggiungere utenti al tuo provider di identità configurato per concedere loro l'accesso al tuo cluster. È possibile concedere tali utenti cluster-admin
o dedicated-admin
autorizzazioni in base alle esigenze.
Puoi configurare diversi tipi di provider di identità per ROSA cluster. I tipi supportati includono GitHub Enterprise GitHub GitLab, GoogleLDAP, OpenID Connect e provider di HTPasswd identità.
Importante
Il provider di HTPasswd identità è incluso solo per consentire la creazione di un singolo utente amministratore statico. HTPasswdnon è supportato come provider di identità di uso generico per ROSA.
La procedura seguente configura un provider di GitHub identità come esempio. Per istruzioni su come configurare ciascuno dei tipi di provider di identità supportati, vedere Configurazione dei provider di identità per AWS STS
-
Vai su github.com
e accedi al tuo account. GitHub -
Se non disponi di un' GitHub organizzazione da utilizzare per la fornitura di identità per il tuo cluster, creane uno. Per ulteriori informazioni, consulta i passaggi indicati nella GitHub documentazione
. -
Utilizzo di ROSA CLI, configura un provider di identità per il tuo cluster.
rosa create idp --cluster=<CLUSTER_NAME> --interactive
-
Segui le istruzioni di configurazione nell'output per limitare cluster accesso ai membri della tua GitHub organizzazione.
I: Interactive mode enabled. Any optional fields can be left empty and a default will be selected. ? Type of identity provider: github ? Identity provider name: github-1 ? Restrict to members of: organizations ? GitHub organizations: <GITHUB_ORG_NAME> ? To use GitHub as an identity provider, you must first register the application: - Open the following URL: https://github.com/organizations/<GITHUB_ORG_NAME>/settings/applications/new?oauth_application%5Bcallback_url%5D=https%3A%2F%2Foauth-openshift.apps.<CLUSTER_NAME>/<RANDOM_STRING>.p1.openshiftapps.com%2Foauth2callback%2Fgithub-1&oauth_application%5Bname%5D=<CLUSTER_NAME>&oauth_application%5Burl%5D=https%3A%2F%2Fconsole-openshift-console.apps.<CLUSTER_NAME>/<RANDOM_STRING>.p1.openshiftapps.com - Click on 'Register application' ...
-
Apri il file URL nell'output, sostituendolo
<GITHUB_ORG_NAME>
con il nome della tua GitHub organizzazione. -
Nella pagina GitHub web, scegli Registra applicazione per registrare una nuova OAuth applicazione nella tua GitHub organizzazione.
-
Utilizza le informazioni della GitHub OAuth pagina per compilare i prompt
rosa create idp
interattivi rimanenti eseguendo il comando seguente. Sostituisci<GITHUB_CLIENT_ID>
e<GITHUB_CLIENT_SECRET>
con le credenziali dell'applicazione. GitHub OAuth... ? Client ID: <GITHUB_CLIENT_ID> ? Client Secret: [? for help] <GITHUB_CLIENT_SECRET> ? GitHub Enterprise Hostname (optional): ? Mapping method: claim I: Configuring IDP for cluster '<CLUSTER_NAME>' I: Identity Provider 'github-1' has been created. It will take up to 1 minute for this configuration to be enabled. To add cluster administrators, see 'rosa grant user --help'. To login into the console, open https://console-openshift-console.apps.<CLUSTER_NAME>.<RANDOM_STRING>.p1.openshiftapps.com and click on github-1.
Nota
Potrebbero essere necessari circa due minuti prima che la configurazione del provider di identità diventi attiva. Se hai configurato un
cluster-admin
utente, puoi correreoc get pods -n openshift-authentication --watch
a guardare i OAuth pod ridistribuirsi con la configurazione aggiornata. -
Verifica che il provider di identità sia configurato correttamente.
rosa list idps --cluster=<CLUSTER_NAME>
Concedi all'utente l'accesso a cluster
Puoi concedere a un utente l'accesso a cluster aggiungendoli al provider di identità configurato.
La procedura seguente aggiunge un utente a un' GitHub organizzazione configurata per il provisioning delle identità al cluster.
-
Vai su github.com
e accedi al tuo account. GitHub -
Invita gli utenti che lo richiedono cluster accesso alla tua GitHub organizzazione. Per ulteriori informazioni, vedi Invitare gli utenti a entrare a far parte della tua organizzazione
nella GitHub documentazione.
Configura le cluster-admin
autorizzazioni
-
Concedi le
cluster-admin
autorizzazioni eseguendo il comando seguente. Sostituisci<IDP_USER_NAME>
e<CLUSTER_NAME>
con il nome utente e del cluster.rosa grant user cluster-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifica che l'utente sia elencato come membro del
cluster-admins
gruppo.rosa list users --cluster=<CLUSTER_NAME>
Configura le dedicated-admin
autorizzazioni
-
Concedi le
dedicated-admin
autorizzazioni utilizzando il seguente comando. Sostituisci<IDP_USER_NAME>
e<CLUSTER_NAME>
con il tuo utente e cluster nome eseguendo il comando seguente.rosa grant user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifica che l'utente sia elencato come membro del
cluster-admins
gruppo.rosa list users --cluster=<CLUSTER_NAME>
Accedere a cluster tramite la console Red Hat Hybrid Cloud
Accedi al tuo cluster tramite la Red Hat Hybrid Cloud Console.
-
Procurati la console URL per cluster usando il seguente comando. Sostituisci
<CLUSTER_NAME>
con il nome del tuo cluster.rosa describe cluster -c <CLUSTER_NAME> | grep Console
-
Vai alla console URL nell'output e accedi.
Nella finestra di dialogo Accedi con..., scegli il nome del provider di identità e completa tutte le richieste di autorizzazione presentate dal provider.
Distribuisci un'applicazione dal Developer Catalog
Dalla Red Hat Hybrid Cloud Console, puoi implementare un'applicazione di test del Developer Catalog ed esporla con un percorso.
-
Accedi a Red Hat Hybrid Cloud Console
e scegli il cluster in cui vuoi implementare l'app. -
Nella pagina del cluster, scegli Open console.
-
Nella prospettiva dell'amministratore, scegli Home > Progetti > Crea progetto.
-
Immettete un nome per il progetto e, facoltativamente, aggiungete un nome visualizzato e una descrizione.
-
Scegli Crea per creare il progetto.
-
Passa alla prospettiva dello sviluppatore e scegli +Aggiungi. Assicurati che il progetto selezionato sia quello appena creato.
-
Nella finestra di dialogo Developer Catalog, scegli Tutti i servizi.
-
Nella pagina del catalogo per sviluppatori, scegliete Lingue > JavaScriptdal menu.
-
Scegliete Node.js, quindi scegliete Crea applicazione per aprire la pagina Crea applicazione Source-to-Image.
Nota
Potrebbe essere necessario scegliere Cancella tutti i filtri per visualizzare l'opzione Node.js.
-
Nella sezione Git, scegli Try Sample.
-
Nel campo Nome, aggiungi un nome univoco.
-
Scegli Create (Crea) .
Nota
La distribuzione della nuova applicazione richiede diversi minuti.
-
Una volta completata la distribuzione, scegli il percorso URL per l'applicazione.
Si apre una nuova scheda nel browser con un messaggio simile al seguente.
Welcome to your Node.js application on OpenShift
-
(Facoltativo) Eliminare l'applicazione e ripulire le risorse:
-
Nella prospettiva dell'amministratore, scegliete Home > Progetti.
-
Apri il menu delle azioni per il tuo progetto e scegli Elimina progetto.
-
Revoca le cluster-admin
autorizzazioni a un utente
-
Revoca le
cluster-admin
autorizzazioni utilizzando il seguente comando. Sostituisci<IDP_USER_NAME>
e<CLUSTER_NAME>
con il tuo utente e cluster nome.rosa revoke user cluster-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifica che l'utente non sia elencato come membro del
cluster-admins
gruppo.rosa list users --cluster=<CLUSTER_NAME>
Revoca le dedicated-admin
autorizzazioni a un utente
-
Revoca le
dedicated-admin
autorizzazioni utilizzando il seguente comando. Sostituisci<IDP_USER_NAME>
e<CLUSTER_NAME>
con il tuo utente e cluster nome.rosa revoke user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifica che l'utente non sia elencato come membro del
dedicated-admins
gruppo.rosa list users --cluster=<CLUSTER_NAME>
Revoca l'accesso utente a cluster
Puoi revocare cluster accedere a un utente del provider di identità rimuovendolo dal provider di identità configurato.
Puoi configurare diversi tipi di provider di identità per i tuoi cluster. La seguente procedura revoca cluster accesso per un membro di un' GitHub organizzazione.
-
Vai su github.com
e accedi al tuo account. GitHub -
Rimuovi l'utente dalla tua organizzazione. GitHub Per ulteriori informazioni, consulta Rimuovere un membro dall'organizzazione
nella GitHub documentazione.
Eliminare un cluster e AWS STS risorse
Puoi utilizzare il plugin ROSA CLIeliminare un cluster che usa AWS Security Token Service (AWS STS). Puoi anche usare il ROSA CLIper eliminare il IAM ruoli e OIDC provider creati da ROSA. Per eliminare il IAM politiche create da ROSA, è possibile utilizzare il IAM console.
Nota
IAM ruoli e politiche creati da ROSA potrebbe essere usato da altri ROSA cluster nello stesso account.
-
Elimina le foto o i video cluster e guarda i log. Sostituisci
<CLUSTER_NAME>
con il nome o l'ID del tuo cluster.rosa delete cluster --cluster=<CLUSTER_NAME> --watch
Importante
Devi aspettare il cluster da eliminare completamente prima di rimuovere il IAM ruoli, politiche e OIDC provider. I IAM ruoli dell'account sono necessari per eliminare le risorse create dal programma di installazione. I IAM ruoli degli operatori sono necessari per ripulire le risorse create dagli OpenShift operatori. Gli operatori utilizzano il OIDC provider per l'autenticazione.
-
Eliminare il OIDC provider che cluster gli operatori utilizzano per autenticarsi eseguendo il comando seguente.
rosa delete oidc-provider -c <CLUSTER_ID> --mode auto
-
Eliminare l'operatore specifico del cluster IAM ruoli.
rosa delete operator-roles -c <CLUSTER_ID> --mode auto
-
Eliminare i IAM ruoli dell'account utilizzando il seguente comando. Sostituisci
<PREFIX>
con il prefisso dei IAM ruoli dell'account da eliminare. Se hai specificato un prefisso personalizzato durante la creazione dei IAM ruoli dell'account, specifica il prefisso predefinitoManagedOpenShift
.rosa delete account-roles --prefix <PREFIX> --mode auto
-
Elimina le foto o i video IAM politiche create da ROSA.
-
Effettua il login a IAM console
. -
Nel menu a sinistra in Gestione degli accessi, scegli Politiche.
-
Seleziona la politica che desideri eliminare e scegli Azioni > Elimina.
-
Inserisci il nome della politica e scegli Elimina.
-
Ripeti questo passaggio per eliminare ciascuna delle IAM politiche per cluster.
-