Questa pagina è stata tradotta dall'API Cloud Translation.

Installa Config Connector in modalità con spazio dei nomi

Questa pagina spiega come installare Config Connector in modalità con spazio dei nomi.

L'installazione in modalità con spazio dei nomi è un'estensione di Config Connector dell'installazione. La modalità con pacing dei nomi supporta la gestione di più progetti, ciascuna con la propria identità Google Cloud.

Prima di iniziare

Prima di configurare Config Connector per l'esecuzione in modalità con spazio dei nomi, assicurati di avere installato Config Connector.

Configura Config Connector per l'esecuzione in modalità con spazi dei nomi

Per attivare la modalità con spazio dei nomi, completa i seguenti passaggi:

Copia il seguente manifest YAML in un file denominato configconnector.yaml:

apiVersion: core.cnrm.cloud.google.com/v1beta1
kind: ConfigConnector
metadata:
  # the name is restricted to ensure that there is only ConfigConnector resource installed in your cluster
  name: configconnector.core.cnrm.cloud.google.com
spec:
  mode: namespaced
  stateIntoSpec: Absent

Applica la configurazione al cluster con kubectl apply:
```
kubectl apply -f configconnector.yaml
```

Configura Config Connector per gestire le risorse negli spazi dei nomi

Nelle sezioni seguenti, il progetto Google Cloud in cui installi Config Connector è noto come progetto host o HOST_PROJECT_ID. Gli altri progetti in cui gestisci le risorse sono noti come progetti gestiti o MANAGED_PROJECT_ID. Potrebbe trattarsi dello stesso progetto se intendi utilizzare Config Connector solo per creare risorse Google Cloud nello stesso progetto del tuo cluster.

Creazione di uno spazio dei nomi

Puoi saltare questo passaggio se hai già uno spazio dei nomi da utilizzare per organizzare dell'accesso a specifiche risorse Google Cloud.

Utilizza kubectl per creare un nuovo spazio dei nomi eseguendo il seguente comando:

kubectl create namespace NAMESPACE

Sostituisci NAMESPACE con un nome per lo spazio dei nomi.

Creazione di un'identità

Crea un account di servizio Identity and Access Management (IAM) e crea un'associazione tra Account di servizio IAM e servizio Kubernetes di Config Connector :

Crea un account di servizio IAM. Se disponi di un account puoi utilizzarlo anziché crearne uno nuovo. Utilizza gcloud per creare l'account di servizio eseguendo il seguente comando:
```
gcloud iam service-accounts create NAMESPACE_GSA --project HOST_PROJECT_ID
```
Sostituisci quanto segue:
- NAMESPACE_GSA con il nome dell'account di servizio Google (GSA) associato al tuo spazio dei nomi.
- HOST_PROJECT_ID con l'ID del tuo progetto host.
Per scoprire di più sulla creazione degli account di servizio, consulta Creare e gestire gli account di servizio.
Concedi all'account di servizio IAM autorizzazioni elevate sul tuo progetto gestore.
```
gcloud projects add-iam-policy-binding MANAGED_PROJECT_ID \
    --member="serviceAccount:NAMESPACE_GSA@HOST_PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/owner"
```
Sostituisci quanto segue:
- MANAGED_PROJECT_ID con l'ID del progetto gestito.
- NAMESPACE_GSA con il nome dell'account di servizio Google associato al tuo spazio dei nomi.
- HOST_PROJECT_ID con l'ID del tuo progetto host.
Nota: se preferisci concedere editor l'accesso al progetto sostituisci roles/owner con roles/editor. La concessione del ruolo Editor consente la maggior parte delle funzionalità di Config Connector, ad eccezione di Configurazioni a livello di progetto o organizzazione, ad esempio IAM modifiche.
Crea un'associazione dei criteri IAM tra l'account di servizio IAM e l'account di servizio Kubernetes di Config Connector. Puoi associare gli account di servizio eseguendo il seguente comando gcloud:
```
gcloud iam service-accounts add-iam-policy-binding \
NAMESPACE_GSA@HOST_PROJECT_ID.iam.gserviceaccount.com \
    --member="serviceAccount:HOST_PROJECT_ID.svc.id.goog[cnrm-system/cnrm-controller-manager-NAMESPACE]" \
    --role="roles/iam.workloadIdentityUser" \
    --project HOST_PROJECT_ID
```
Sostituisci quanto segue:
- HOST_PROJECT_ID con l'ID del tuo progetto host.
- NAMESPACE_GSA con il nome dell'account di servizio Google associato al tuo spazio dei nomi.
- NAMESPACE con il tuo spazio dei nomi.
Concedi all'account di servizio IAM le autorizzazioni per la pubblicazione Metriche Prometheus a Google Cloud Observability sul tuo progetto host.
```
gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
    --member="serviceAccount:NAMESPACE_GSA@HOST_PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/monitoring.metricWriter"
```
Sostituisci quanto segue:
- HOST_PROJECT_ID con l'ID del tuo progetto host.
- NAMESPACE_GSA con il nome dell'account di servizio Google associato al tuo spazio dei nomi.

Creazione di un ConfigConnectorContext

Per creare risorse Google Cloud, devi configurare Config Connector per controllare lo spazio dei nomi aggiungendo un oggetto ConfigConnectorContext nello spazio dei nomi che vuoi utilizzare.

Per creare un ConfigConnectorContext, svolgi i seguenti passaggi:

Copia il seguente manifest YAML in un file denominato configconnectorcontext.yaml:

apiVersion: core.cnrm.cloud.google.com/v1beta1
kind: ConfigConnectorContext
metadata:
  # you can only have one ConfigConnectorContext per namespace
  name: configconnectorcontext.core.cnrm.cloud.google.com
  namespace: NAMESPACE
spec:
  googleServiceAccount: "NAMESPACE_GSA@HOST_PROJECT_ID.iam.gserviceaccount.com"
  stateIntoSpec: Absent

Sostituisci quanto segue:

NAMESPACE con il nome del tuo spazio dei nomi.
NAMESPACE_GSA con il nome dell'account di servizio Google associato al tuo spazio dei nomi.
HOST_PROJECT_ID con l'ID del progetto host.

Applica il file al tuo cluster con kubectl:

kubectl apply -f configconnectorcontext.yaml

Verifica che l'operatore Config Connector abbia creato un servizio Kubernetes prendi in considerazione il tuo spazio dei nomi con kubectl eseguendo questo comando:
```
kubectl get serviceaccount/cnrm-controller-manager-NAMESPACE  -n cnrm-system
```
Sostituisci NAMESPACE con il nome dello spazio dei nomi.
Verifica che il pod del controller Config Connector sia in esecuzione per lo spazio dei nomi con kubectl eseguendo questo comando:
```
kubectl wait -n cnrm-system \
    --for=condition=Ready pod \
    -l cnrm.cloud.google.com/component=cnrm-controller-manager \
    -l cnrm.cloud.google.com/scoped-namespace=NAMESPACE
```
Sostituisci NAMESPACE con il nome del tuo spazio dei nomi.

Se il controller Config Connector è in esecuzione, l'output è simile al seguente:
```
cnrm-controller-manager-abcdefghijk-0 condition met.
```

Configura Config Connector in modo che non gestisca più le risorse nel tuo spazio dei nomi

Per configurare Config Connector in modo che non gestisca più lo spazio dei nomi, rimuovi tutti Configura le risorse di Config Connector nello spazio dei nomi ed elimina ConfigConnectorContext nel tuo spazio dei nomi.

Rimuovi le risorse di Config Connector nello spazio dei nomi

Per finalizzare la rimozione di ConfigConnectorContext, rimuovi tutti i Config Connector delle risorse dal tuo spazio dei nomi.

Per scoprire tutte le risorse Config Connector nel tuo spazio dei nomi, per ogni Config Connector Definizione di risorsa personalizzata, elenca tutte le risorse.
```
kubectl get gcp -n NAMESPACE
```
Sostituisci NAMESPACE con il nome dello spazio dei nomi.
Per rimuovere tutte le risorse Config Connector, per ogni risorsa nell'output del nel passaggio precedente, emetti un comando di eliminazione.
```
kubectl delete -n NAMESPACE KIND NAME
```
Sostituisci quanto segue:
- NAMESPACE: il nome dello spazio dei nomi
- KIND: il tipo di risorsa scoperta nell'attività precedente passo
- NAME: il nome della risorsa scoperta nel passaggio precedente

Rimuovi ConfigConnectorContext

Per configurare Config Connector in modo che non gestisca più le risorse di Config Connector nello spazio dei nomi, elimina ConfigConnectorContext dallo spazio dei nomi.

  kubectl delete -n NAMESPACE ConfigConnectorContext configconnectorcontext.core.cnrm.cloud.google.com

Sostituisci NAMESPACE con il nome dello spazio dei nomi.

L'eliminazione di ConfigConnectorContext non verrà finalizzata fino a quando tutti i Config Connector le risorse vengano rimosse dallo spazio dei nomi.

Disinstallazione di Config Connector

Non utilizzare i passaggi che seguono per disinstallare un cluster di Controllori di configurazione.

Utilizza kubectl delete per rimuovere i CRD di Config Connector insieme ai componenti del controller:

kubectl delete ConfigConnectorContext --all -A –wait=false

kubectl delete ConfigConnector configconnector.core.cnrm.cloud.google.com \
    --wait=true

Per disinstallare l'operatore Config Connector, esegui il seguente comando:

kubectl delete -f operator-system/configconnector-operator.yaml  --wait=true

Passaggi successivi

Inizia a utilizzare Config Connector.
Scopri le best practice per Config Connector.