Installazione con il componente aggiuntivo GKE
Questa pagina descrive come installare Config Connector su un cluster Google Kubernetes Engine (GKE) utilizzando il componente aggiuntivo GKE.
Per informazioni dettagliate su ogni opzione di installazione con i relativi vantaggi e svantaggi, consulta Scelta di un tipo di installazione.
Devi installare Config Connector manualmente anziché utilizzare il componente aggiuntivo. Il componente aggiuntivo è legato alla versione secondaria GKE del cluster e può essere in ritardo rispetto alle ultime release di Config Connector di 12 mesi o più. Se utilizzi già il componente aggiuntivo, puoi passare a un'installazione manuale.
Prima di iniziare
Prima di iniziare, assicurati di aver eseguito le seguenti attività:
- Abilita l'API Google Kubernetes Engine. Abilita l'API Google Kubernetes Engine
- Per utilizzare Google Cloud CLI per questa attività,
installala e poi
inizializza
gcloud CLI. Se hai già installato gcloud CLI, scarica l'ultima
versione eseguendo il comando
gcloud components update. Le versioni precedenti di gcloud CLI potrebbero non supportare l'esecuzione dei comandi in questo documento.
Seleziona o crea un progetto Google Cloud in cui installare Config Connector.
Se in precedenza hai installato manualmente Config Connector, disinstallalo prima di installare il componente aggiuntivo Config Connector:
Installazione del componente aggiuntivo Config Connector
Puoi utilizzare il componente aggiuntivo Config Connector creando un nuovo cluster GKE o abilitandolo su un cluster esistente. Dopo aver installato il componente aggiuntivo Config Connector, configura l'installazione di Config Connector con i tuoi service account Google e i tuoi spazi dei nomi.
Requisiti
Il componente aggiuntivo Config Connector ha i seguenti requisiti:
Devi utilizzare una versione di GKE:
- 1.15.11-gke.5 e versioni successive
- 1.16.8-gke.8 e versioni successive
- 1.17.4-gke.5 e versioni successive
Devi abilitare un pool di identità del workload e Kubernetes Engine Monitoring sui cluster in cui abiliti Config Connector.
Configurazione di un cluster GKE
Puoi utilizzare il componente aggiuntivo Config Connector su un cluster nuovo o esistente.
Creazione di un nuovo cluster con il componente aggiuntivo Config Connector abilitato
Puoi creare un cluster GKE utilizzando gcloud CLI o la consoleGoogle Cloud .
gcloud
Per creare un cluster con Google Cloud CLI, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--release-channel CHANNEL \
--addons ConfigConnector \
--workload-pool=PROJECT_ID.svc.id.goog \
--logging=SYSTEM \
--monitoring=SYSTEM
Sostituisci quanto segue:
- CLUSTER_NAME con il nome del tuo cluster GKE.
- CHANNEL con un canale di rilascio GKE, sono supportati
rapideregular. - PROJECT_ID con l'ID progetto Google Cloud .
Console Google Cloud
Per creare un cluster con la console Google Cloud , segui questi passaggi:
Nella console Google Cloud , vai alla pagina Crea un cluster Kubernetes.
Nella sezione Impostazioni di base del cluster, specifica un nome e una località per il cluster.
Nel riquadro di navigazione, fai clic su Impostazioni avanzate.
Nella riga Workload Identity, fai clic su edit Modifica configurazione, seleziona la casella di controllo Abilita Workload Identity e poi fai clic su Salva.
Nella riga Config Connector, seleziona la casella di controllo Abilitazione rapida.
(Facoltativo) Configura il resto del cluster in base alle tue esigenze.
Fai clic su Crea.
Dopo aver creato il cluster, vai a Creazione di un'identità.
Abilitazione del componente aggiuntivo Config Connector su un cluster esistente
Puoi abilitare il componente aggiuntivo Config Connector su un cluster GKE esistente con gcloud o con la console Google Cloud .
Prerequisiti
L'abilitazione del componente aggiuntivo Config Connector su un cluster esistente prevede i seguenti prerequisiti:
- Devi avere un cluster che soddisfi i requisiti per il componente aggiuntivo Config Connector.
Configura Workload Identity Federation for GKE sul cluster in cui vuoi installare Config Connector.
Per abilitare Workload Identity Federation for GKE per un pool di nodi, utilizza lo strumento a riga di comando gcloud:
gcloud container node-pools update NODE_POOL \
--workload-metadata=GKE_METADATA \
--cluster CLUSTER_NAME
Sostituisci quanto segue:
- NODE_POOL con il nome del tuo pool di nodi
- CLUSTER_NAME con il nome del tuo cluster
Abilitazione del componente aggiuntivo Config Connector
Puoi abilitare il componente aggiuntivo Config Connector in un cluster GKE esistente con Google Cloud CLI o la console Google Cloud .
gcloud
Per abilitare il componente aggiuntivo Config Connector in un cluster GKE esistente, utilizza Google Cloud CLI:
gcloud container clusters update CLUSTER_NAME \
--update-addons ConfigConnector=ENABLED
Sostituisci CLUSTER_NAME con il nome del tuo cluster GKE.
Console Google Cloud
Visita il menu Google Kubernetes Engine nella console Google Cloud .
Seleziona il cluster su cui vuoi installare Config Connector. Viene visualizzata la pagina Dettagli cluster.
Nella sezione Funzionalità, individua la riga Config Connector e fai clic su Modifica.
Seleziona la casella di controllo Abilita Config Connector e fai clic su Salva modifiche per aggiornare il cluster.
Crea un'identità
Config Connector crea e gestisce le risorse Google Cloud eseguendo l'autenticazione con un account di servizio Identity and Access Management (IAM) e utilizzando Workload Identity Federation for GKE per associare i service account IAM ai service account Kubernetes.
Config Connector non gestisce alcuna risorsa finché non configuri la modalità con spazio dei nomi o la modalità cluster. Per la maggior parte dei casi d'uso, devi utilizzare la modalità con spazio dei nomi. Segui i passaggi per la modalità che scegli:
- Per utilizzare la modalità con spazi dei nomi, salta questa sezione e la sezione Configurazione di Config Connector. Il componente aggiuntivo ha già installato l'operatore e creato un oggetto
ConfigConnectorin modalità con namespace. Per ogni spazio dei nomi, completa i passaggi descritti in Installa Config Connector in modalità con spazi dei nomi, quindi torna a Specifica dove creare le risorse. - Per utilizzare la modalità cluster, completa i passaggi descritti in questa sezione e nella sezione Configurazione di Config Connector. Devi completare questi passaggi una sola volta per ogni cluster.
Per creare l'identità, completa i seguenti passaggi:
Crea un account di servizio IAM. Se vuoi utilizzare un account di servizio esistente, puoi utilizzarlo e saltare questo passaggio:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAMESostituisci SERVICE_ACCOUNT_NAME con un nome per il account di servizio.
Per saperne di più sulla creazione dei service account, consulta Creazione e gestione dei service account.
Concedi al account di servizio IAM autorizzazioni elevate per il tuo progetto:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/editor"Sostituisci PROJECT_ID con l'ID progetto.
Crea un'associazione dei criteri IAM tra il account di servizio IAM e il account di servizio Kubernetes predefinito eseguito da Config Connector:
gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --member="serviceAccount:PROJECT_ID.svc.id.goog[cnrm-system/cnrm-controller-manager]" \ --role="roles/iam.workloadIdentityUser"
Configurazione di Config Connector
Per completare l'installazione, crea un file di configurazione per
la CustomResource
ConfigConnector,
quindi applicalo utilizzando il comando kubectl apply. L'operatore Config Connector installa le CRD delle risorseGoogle Cloud e i componenti Config Connector nel cluster.
Per configurare l'operatore in modalità cluster, completa i seguenti passaggi:
-
Copia il seguente file YAML in un file denominato
configconnector.yaml: Sostituisci quanto segue:# configconnector.yaml apiVersion: core.cnrm.cloud.google.com/v1beta1 kind: ConfigConnector metadata: # the name is restricted to ensure that there is only one # ConfigConnector resource installed in your cluster name: configconnector.core.cnrm.cloud.google.com spec: mode: cluster googleServiceAccount: "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" # Setting `stateIntoSpec` to `Absent` is recommended. It means setting `cnrm.cloud.google.com/state-into-spec` # annotation to `absent` for all Config Connector resources created in the cluster in the future. # It prevents Config Connector from populating unspecified fields into the spec. stateIntoSpec: Absent
SERVICE_ACCOUNT_NAMEcon il nome del tuo account di servizio.PROJECT_IDcon l'ID progetto.
-
Applica la configurazione al cluster con
kubectl apply:kubectl apply -f configconnector.yaml
Specifica dove creare le risorse
Config Connector può organizzare le risorse per progetto, cartella o organizzazione, proprio come faresti con Google Cloud.
Prima di creare risorse con Config Connector, devi configurare dove crearle. Per determinare dove creare la risorsa, Config Connector utilizza un'annotazione nella configurazione della risorsa o in uno spazio dei nomi esistente. Per saperne di più, consulta Organizzazione delle risorse.
Se non hai uno spazio dei nomi per questo scopo, creane uno conkubectl.
kubectl create namespace NAMESPACE
Sostituisci NAMESPACE con il nome del tuo spazio dei nomi. Ad esempio:
config-connector.
Seleziona una scheda per scegliere dove vuoi che Config Connector crei le risorse.
Progetto
Per creare risorse in un determinato progetto, esegui questo comando:
kubectl annotate namespace \ NAMESPACE cnrm.cloud.google.com/project-id=PROJECT_ID
Sostituisci quanto segue:
NAMESPACEcon il nome dello spazio dei nomi.PROJECT_IDcon l'ID progetto Google Cloud .
Cartella
Per creare risorse in una determinata cartella, esegui questo comando:
kubectl annotate namespace \ NAMESPACE cnrm.cloud.google.com/folder-id=FOLDER_ID
Sostituisci quanto segue:
NAMESPACEcon il nome dello spazio dei nomi.FOLDER_IDcon l'ID della cartella Google Cloud .
Organizzazione
Per creare risorse in una determinata organizzazione, esegui questo comando:
kubectl annotate namespace \ NAMESPACE cnrm.cloud.google.com/organization-id=ORGANIZATION_ID
Sostituisci quanto segue:
NAMESPACEcon il nome dello spazio dei nomi.ORGANIZATION_IDcon l'ID organizzazione Google Cloud .
Quando annoti lo spazio dei nomi, Config Connector crea le risorse nel progetto, nella cartella o nell'organizzazione corrispondente. Per scoprire di più su come Config Connector utilizza gli spazi dei nomi Kubernetes, consulta Spazi dei nomi Kubernetes e progetti Google Cloud .
Verifica dell'installazione
Config Connector esegue tutti i suoi componenti in uno spazio dei nomi denominato cnrm-system.
Puoi verificare che i pod siano pronti eseguendo questo comando:
kubectl wait -n cnrm-system \
--for=condition=Ready pod --all
Se Config Connector è installato correttamente, l'output è simile al seguente:
pod/cnrm-controller-manager-0 condition met
Upgrade di Config Connector
Gli upgrade al componente aggiuntivo Config Connector del cluster sono gestiti da Google Cloud.
Le risorse nel cluster vengono conservate ogni volta che viene eseguito un upgrade.
Scopri come Google Cloud gestisce gli upgrade del componente aggiuntivo Config Connector o vai direttamente a come ottenere l'ultima versione di Config Connector.
In che modo Google Cloud gestisce gli upgrade del componente aggiuntivo Config Connector
La versione di Config Connector che riceve un cluster GKE dipende interamente dalla versione secondaria di GKE del cluster. Ad esempio:
| Versione secondaria di GKE | Versione di Config Connector |
|---|---|
| 1,20 | 1.69.0 |
| 1,21 | 1.69.0 |
| 1,22 | 1.71.0 |
| 1,23 | 1.82.0 |
| 1,24 | 1.89.0 |
Man mano che le versioni vengono qualificate, Google Cloud rimappa le versioni secondarie GKE più recenti a una versione di Config Connector appena rilasciata. Questo viene fatto per tutte le versioni secondarie di GKE che sono abbastanza recenti da non essere disponibili nei canali di rilascio Regular o Stable.
Poiché la versione di Config Connector che un cluster riceve dipende dalla versione secondaria di GKE del cluster, esistono due casi in cui il componente aggiuntivo Config Connector di un cluster viene aggiornato automaticamente da Google Cloud:
Viene eseguito l'upgrade del cluster a una nuova versione secondaria di GKE mappata a una versione più recente di Config Connector.
Il cluster utilizza una versione secondaria di GKE abbastanza recente da non essere disponibile nei canali di rilascio Regular o Stable eGoogle Cloud rimappa la versione secondaria di GKE a una nuova versione di Config Connector.
Quando Google Cloud rimappa una versione secondaria di GKE ed esegue l'upgrade dei cluster esistenti a una nuova versione di Config Connector, si dice che "implementa una nuova versione di Config Connector" per quella versione secondaria di GKE.
Google Cloud non implementa nuove versioni di Config Connector nelle versioni secondarie di GKE abbastanza datate da essere disponibili nei canali di rilascio Rapido o Stabile per motivi di stabilità, ad eccezione di situazioni di emergenza in cui è stato rilevato un problema diffuso.
Come ottenere l'ultima versione di Config Connector
Per assicurarti di avere la versione più aggiornata di Config Connector, ti consigliamo di installare Config Connector ed eseguire l'upgrade manualmente. L'installazione manuale consente di controllare direttamente la versione e di utilizzare le funzionalità e le correzioni più recenti non appena sono disponibili.
Per passare dal componente aggiuntivo Config Connector all'installazione manuale, segui le istruzioni per passare dal componente aggiuntivo Config Connector all'installazione manuale.
Il componente aggiuntivo è legato alla versione secondaria di GKE del cluster e può essere in ritardo rispetto alle ultime release di Config Connector di 12 mesi o più. Sebbene Config Controller sia più aggiornato del componente aggiuntivo, può comunque essere in ritardo rispetto all'ultima versione rispetto all'installazione manuale.
Disinstallazione di Config Connector
Per disinstallare Config Connector, completa i seguenti passaggi:
Utilizza
kubectl deleteper rimuovere i CRD di Config Connector insieme ai componenti del controller:kubectl delete ConfigConnector configconnector.core.cnrm.cloud.google.com --wait=trueDisabilita il componente aggiuntivo Config Connector nel tuo cluster utilizzando gcloud CLI o la console Google Cloud :
gcloud
Per disattivare il componente aggiuntivo Config Connector con
gcloud, esegui questo comando:gcloud container clusters update CLUSTER_NAME --update-addons ConfigConnector=DISABLEDSostituisci CLUSTER_NAME con il nome del cluster in cui è installato il componente aggiuntivo Config Connector.
console Cloud
Per disattivare il componente aggiuntivo Config Connector dalla console Google Cloud , segui questi passaggi.
Vai alla pagina Cluster di Google Kubernetes Engine nella console Google Cloud e seleziona il cluster che vuoi aggiornare.
Fai clic su Modifica. Viene visualizzata la schermata Modifica cluster.
Fai clic su Componenti aggiuntivi.
Seleziona Config Connector e scegli Disattivato.
Fai clic su Salva per aggiornare il cluster.
Passaggi successivi
- Inizia a utilizzare Config Connector.
- Scopri come risolvere i problemi di Config Connector.