Escludere gli spazi dei nomi da Policy Controller

Questa pagina descrive come configurare gli spazi dei nomi esenti in Policy Controller.

Gli spazi dei nomi esenti rimuovono uno spazio dei nomi dall'applicazione del webhook di ammissione con Policy Controller, ma eventuali violazioni vengono comunque registrate nel controllo. Se non configuri alcuna solo lo spazio dei nomi gatekeeper-system è preconfigurato come esente dall'applicazione del webhook di ammissione di Policy Controller.

Configura spazi dei nomi esenti

La configurazione di uno spazio dei nomi esente ti consente di applicare l'etichetta admission.gatekeeper.sh/ignore per esentare lo spazio dei nomi dall'applicazione del webhook di ammissione di Policy Controller. Se in un secondo momento rimuovi uno spazio dei nomi esente, Policy Controller non rimuove l'etichetta admission.gatekeeper.sh/ignore dallo spazio dei nomi.

Esentare gli spazi dei nomi dall'applicazione

Puoi escludere gli spazi dei nomi durante l'installazione di Policy Controller, o dopo l'installazione. Il seguente processo mostra come escludere gli spazi dei nomi dopo l'installazione.

Console

1. Nella console Google Cloud, vai alla pagina Criteri di GKE Enterprise nella sezione Gestione della conformità.

   Vai al criterio

2. Nella scheda Impostazioni, nella tabella del cluster, seleziona Modifica nella colonna Modifica configurazione.
3. Espandi il menu Modifica configurazione di Policy Controller.
4. Nel campo Spazi dei nomi esenti, fornisci un elenco di spazi dei nomi validi. Gli oggetti in questi spazi dei nomi vengono ignorati da tutti i criteri. Gli spazi dei nomi non devono ancora esistere.
5. Seleziona Salva modifiche.

gcloud Policy Controller

Per aggiungere spazi dei nomi all'elenco di quelli che possono essere esenti da da parte del webhook di ammissione, esegui questo comando:

  gcloud container fleet policycontroller update \
    --memberships=MEMBERSHIP_NAME \
    --exemptable-namespaces=[NAMESPACE_LIST]

Sostituisci quanto segue:

• MEMBERSHIP_NAME: il nome dell'appartenenza del cluster registrato per cui esentare gli spazi dei nomi. Puoi specificare più iscrizioni separate da una virgola.
• NAMESPACE_LIST: un elenco di spazi dei nomi separati da virgole da esentare dall'applicazione da parte di Policy Controller.

Questo comando esclude le risorse solo dal webhook di ammissione. Le risorse vengono ancora sottoposti a controlli. Per esentare gli spazi dei nomi dal controllo, imposta l'esenzione a livello di bundle di criteri:

  gcloud container fleet policycontroller content bundles set BUNDLE_NAME \
    --memberships=MEMBERSHIP_NAME \
    --exempted-namespaces=[NAMESPACE_LIST]

Sostituisci quanto segue:

• BUNDLE_NAME con il nome del bundle di criteri che vuoi aggiornare con spazi dei nomi esenti.
• MEMBERSHIP_NAME: il nome dell'abbonamento di il cluster registrato per escludere gli spazi dei nomi. Puoi specificare più iscrizioni separate da una virgola.
• NAMESPACE_LIST: un elenco di spazi dei nomi separati da virgole da esentare dall'applicazione da parte di Policy Controller.

gcloud ConfigManagement

1. Per escludere uno spazio dei nomi dall'applicazione, aggiungi il nome dello spazio dei nomi in spec.policyController.exemptableNamespaces:

   # apply-spec.yaml
   
   applySpecVersion: 1
   spec:
     # Set to true to install and enable Policy Controller
     policyController:
       enabled: true
       exemptableNamespaces: ["NAMESPACE_NAME"]
   ...
   

   Sostituisci NAMESPACE_NAME con il nome dello spazio dei nomi che vuoi esentare dall'applicazione.

   Puoi anche escludere più spazi dei nomi. Ad esempio, per aggiungere gli spazi dei nominot-applicable e also-not-applicable, devi applicare il seguente manifest:

   # apply-spec.yaml
   
   applySpecVersion: 1
   spec:
     # Set to true to install and enable Policy Controller
     policyController:
       enabled: true
       exemptableNamespaces: ["not-applicable","also-not-applicable"]
   ...
   

2. Applica le modifiche al file apply-spec.yaml:

    gcloud beta container fleet config-management apply \
        --membership=MEMBERSHIP_NAME \
        --config=CONFIG_YAML \
        --project=PROJECT_ID
   

   Sostituisci quanto segue:

   • MEMBERSHIP_NAME: aggiungi il cluster registrato che vuoi a cui applicare questa configurazione. Se hai registrato il cluster nel cluster nella console Google Cloud, il nome dell'appartenenza corrisponde a quello del tuo in un cluster Kubernetes.
   • CONFIG_YAML: aggiungi il percorso al tuo file apply-spec.yaml.
   • PROJECT_ID: aggiungi il tuo ID progetto.

3. Etichetta lo spazio dei nomi esente in modo che il webhook di ammissione di Policy Controller non ne applichi i contenuti:

   kubectl label namespace NAMESPACE_NAME "admission.gatekeeper.sh/ignore=true"
   

   Sostituisci NAMESPACE_NAME con il nome dello spazio dei nomi che vuoi escludere l'applicazione forzata.

Spazi dei nomi da escludere dall'applicazione

Questi sono alcuni degli spazi dei nomi che potrebbero essere creati da Google Kubernetes Engine (GKE) e dai prodotti correlati. Ti consigliamo di esentarli dall'applicazione per evitare un impatto indesiderato:

- anthos-creds
- anthos-identity-service
- apigee
- apigee-system
- asm-system
- capi-kubeadm-bootstrap-system
- capi-system
- cert-manager
- cnrm-system
- config-management-monitoring
- config-management-system
- gke-connect
- gke-gmp-system
- gke-managed-cim
- gke-managed-filestorecsi
- gke-managed-metrics-server
- gke-managed-system
- gke-system
- gmp-public
- gmp-system
- hnc-system
- istio-system
- kube-node-lease
- kube-public
- kube-system
- poco-trial
- resource-group-system
- vm-system