Utilizzare i vincoli dei criteri Policy Essentials v2022

Policy Controller include una libreria predefinita di modelli di vincolo che possono essere utilizzati con il bundle Policy Essentials v2022 per applicare le best practice consigliate da Google alle risorse del cluster.

Questa pagina contiene le istruzioni per applicare manualmente un bundle di norme. In alternativa, puoi applicare direttamente i bundle di norme.

Avviso: dopo aver scelto un metodo per applicare i bundle di policy (manuale, gcloud CLI o console Google Cloud ), l'utilizzo di un metodo diverso per installare i bundle di policy può causare errori nel tuo ambiente.

Questa pagina è destinata agli amministratori IT e agli operatori che vogliono assicurarsi che tutte le risorse in esecuzione all'interno della piattaforma cloud soddisfino i requisiti di conformità dell'organizzazione fornendo e gestendo l'automazione per il controllo o l'applicazione. Per scoprire di più sui ruoli comuni e sulle attività di esempio a cui facciamo riferimento nei contenuti di Google Cloud , consulta Ruoli e attività comuni degli utenti GKE.

Questo pacchetto di vincoli affronta e applica le norme nei seguenti domini:

• RBAC e service account
• Policy di sicurezza dei pod
• Container Network Interface (CNI)
• Gestione dei secret
• Norme generali

Vincoli del bundle di norme Policy Essentials

Nome vincolo	Descrizione del vincolo
policy-essentials-v2022-no-secrets-as-env-vars	Preferisci utilizzare i secret come file anziché come variabili di ambiente
policy-essentials-v2022-pods-require-security-context	Applica il contesto di sicurezza a pod e container
policy-essentials-v2022-prohibit-role-wildcard-access	Riduci al minimo l'utilizzo di caratteri jolly in Roles e ClusterRoles.
policy-essentials-v2022-psp-allow-privilege-escalation-container	Ridurre al minimo l'ammissione di container con allowPrivilegeEscalation
policy-essentials-v2022-psp-capabilities	I container devono eliminare la funzionalità `NET_RAW` e non è consentito aggiungere nuovamente funzionalità.
policy-essentials-v2022-psp-host-namespace	Ridurre al minimo l'ammissione di container con "hostPID" o "hostIPC" impostato su "true".
policy-essentials-v2022-psp-host-network-ports	Ridurre al minimo l'ammissione di container che vogliono condividere lo spazio dei nomi di rete dell'host
policy-essentials-v2022-psp-privileged-container	Ridurre al minimo l'ammissione di container con privilegi
policy-essentials-v2022-psp-pods-must-run-as-nonroot	Ridurre al minimo l'ammissione di container root
policy-essentials-v2022-psp-seccomp-default	Assicurati che il profilo seccomp sia impostato su `runtime/default` o `docker/default` nelle definizioni dei pod
policy-essentials-v2022-restrict-clusteradmin-rolebindings	Riduci al minimo l'utilizzo del ruolo cluster-admin.

Prima di iniziare

1. Installa e inizializza Google Cloud CLI, che fornisce i comandi gcloud e kubectl utilizzati in queste istruzioni. Se utilizzi Cloud Shell, Google Cloud CLI è preinstallato.
2. Installa Policy Controller v1.14.3 o versioni successive sul cluster con la libreria predefinita di modelli di vincoli.

Bundle di criteri Policy Essentials per l'audit

Policy Controller consente di applicare criteri per il cluster Kubernetes. Per testare i tuoi workload e la loro conformità alle best practice consigliate da Google descritte nella tabella precedente, puoi implementare questi vincoli in modalità "audit" per rivelare le violazioni e, soprattutto, darti la possibilità di correggerle prima di applicarle al tuo cluster Kubernetes.

Puoi applicare questi criteri con spec.enforcementAction impostato su dryrun utilizzando kubectl, kpt, o Config Sync.

kubectl

1. (Facoltativo) Visualizza l'anteprima dei vincoli dei criteri con kubectl:

   kubectl kustomize https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-v2022
   

2. Applica i vincoli dei criteri con kubectl:

   kubectl apply -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-v2022
   

   L'output è il seguente:

   k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars created
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation created
   k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot created
   k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities created
   k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace created
   k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports created
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container created
   k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-default created
   k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context created
   k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access created
   k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings created
   

3. Verifica che i vincoli dei criteri siano stati installati e controlla se esistono violazioni nel cluster:

   kubectl get -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-v2022
   

   L'output è simile al seguente:

   NAME                                                                                          ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars   dryrun               0
   
   NAME                                                                                                                       ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation   dryrun               0
   
   NAME                                                                                                ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot   dryrun               0
   
   NAME                                                                                    ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities   dryrun               0
   
   NAME                                                                                       ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace   dryrun               0
   
   NAME                                                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports   dryrun               0
   
   NAME                                                                                                   ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container   dryrun               0
   
   NAME                                                                                  ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-default   dryrun               0
   
   NAME                                                                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context   dryrun               0
   
   NAME                                                                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access   dryrun               0
   
   NAME                                                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings   dryrun               0
   

kpt

1. Installa e configura kpt. kpt viene utilizzato in queste istruzioni per personalizzare ed eseguire il deployment delle risorse Kubernetes.

2. Scarica il bundle di policy Policy Essentials v2022 da GitHub utilizzando kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-v2022
   

3. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione delle policy su dryrun:

   kpt fn eval policy-essentials-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 \
     -- enforcementAction=dryrun
   

4. Inizializza la directory di lavoro con kpt, che crea una risorsa per monitorare le modifiche:

   cd policy-essentials-v2022
   kpt live init
   

5. Applica i vincoli dei criteri con kpt:

   kpt live apply
   

   L'output è il seguente:

   k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-docker-default created
   k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context created
   k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access created
   k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars created
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation-container created
   k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot created
   k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports created
   k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings created
   k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities created
   k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace created
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container created
   11 resource(s) applied. 11 created, 0 unchanged, 0 configured, 0 failed
   

6. Verifica che i vincoli dei criteri siano stati installati e controlla se esistono violazioni nel cluster:

   kpt live status --output table --poll-until current
   

   Lo stato CURRENT conferma l'installazione riuscita dei vincoli.

Config Sync

1. Installa e configura kpt. kpt viene utilizzato in queste istruzioni per personalizzare ed eseguire il deployment delle risorse Kubernetes.

Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei propri cluster possono utilizzare le seguenti istruzioni:

1. Passa alla directory di sincronizzazione per Config Sync:

   cd SYNC_ROOT_DIR
   

   Nota: Kpt v1.0.0-beta.17 e versioni successive creano automaticamente un file resourcegroup.yaml durante live init, che non deve essere archiviato nel repository Config Sync. Se non è già presente, aggiungi resourcegroup.yaml al file .gitignore del tuo repository.

   Per creare o aggiungere .gitignore con resourcegroup.yaml:

   echo resourcegroup.yaml >> .gitignore
   

2. Crea una directory policies dedicata:

   mkdir -p policies
   

3. Scarica il bundle di policy Policy Essentials v2022 da GitHub utilizzando kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-v2022 policies/policy-essentials-v2022
   

4. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione delle policy su dryrun:

   kpt fn eval policies/policy-essentials-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
   

5. (Facoltativo) Visualizza l'anteprima dei vincoli delle norme da creare:

   kpt live init policies/policy-essentials-v2022
   kpt live apply --dry-run policies/policy-essentials-v2022
   

   L'output è il seguente:

   Dry-run strategy: client
   inventory update started
   inventory update finished
   apply phase started
   k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars apply successful
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation apply successful
   k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot apply successful
   k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities apply successful
   k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace apply successful
   k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports apply successful
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container apply successful
   k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-default apply successful
   k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context apply successful
   k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access apply successful
   k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings apply successful
   apply phase finished
   inventory update started
   inventory update finished
   apply result: 11 attempted, 11 successful, 0 skipped, 0 failed
   

6. Se la directory di sincronizzazione per Config Sync utilizza Kustomize, aggiungi policies/policy-essentials-v2022 alla radice kustomization.yaml. In caso contrario, rimuovi il file policies/policy-essentials-v2022/kustomization.yaml:

   rm SYNC_ROOT_DIR/policies/policy-essentials-v2022/kustomization.yaml
   

7. Esegui il push delle modifiche nel repository Config Sync:

   git add SYNC_ROOT_DIR/policy-essentials-v2022
   git commit -m 'Adding Policy Essentials v2022 policy audit enforcement'
   git push
   

8. Verifica lo stato dell'installazione:

   watch gcloud beta container fleet config-management status --project PROJECT_ID
   

   Lo stato SYNCED conferma l'installazione dei criteri.

Visualizzare le violazioni delle norme

Una volta installati i vincoli dei criteri in modalità audit, le violazioni nel cluster possono essere visualizzate nell'interfaccia utente utilizzando la dashboard di Policy Controller.

Puoi anche utilizzare kubectl per visualizzare le violazioni nel cluster utilizzando il seguente comando:

kubectl get constraint -l policycontroller.gke.io/bundleName=policy-essentials-v2022 -o json | jq -cC '.items[]| [.metadata.name,.status.totalViolations]'

Se sono presenti violazioni, è possibile visualizzare un elenco dei messaggi di violazione per vincolo con:

kubectl get constraint -l policycontroller.gke.io/bundleName=policy-essentials-v2022 -o json | jq -C '.items[]| select(.status.totalViolations>0)| [.metadata.name,.status.violations[]?]'

Modificare l'azione di applicazione del pacchetto di norme Policy Essentials

Dopo aver esaminato le violazioni delle norme nel cluster, puoi valutare la possibilità di modificare la modalità di applicazione in modo che il controller di ammissione warn o addirittura deny blocchi l'applicazione al cluster della risorsa non conforme.

Avviso :l'azione di applicazione deny deve essere utilizzata con cautela in quanto può potenzialmente bloccare le modifiche richieste, causando l'interruzione dei carichi di lavoro critici o del cluster. È consigliabile utilizzare solo le azioni di applicazione forzata warn o dryrun sui cluster con carichi di lavoro di produzione, quando si testano nuovi vincoli o si eseguono migrazioni come l'upgrade delle piattaforme. Per ulteriori informazioni sui provvedimenti, consulta Controllo con vincoli.

kubectl

1. Utilizza kubectl per impostare l'azione di applicazione delle norme su warn:

   kubectl get constraint -l policycontroller.gke.io/bundleName=policy-essentials-v2022 -o name | xargs -I {} kubectl patch {} --type='json' -p='[{"op":"replace","path":"/spec/enforcementAction","value":"warn"}]'
   

2. Verifica che l'azione di applicazione dei vincoli dei criteri sia stata aggiornata:

   kubectl get constraint -l policycontroller.gke.io/bundleName=policy-essentials-v2022
   

kpt

1. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione delle policy su warn:

   kpt fn eval -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
   

2. Applica i vincoli dei criteri:

   kpt live apply
   

Config Sync

Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei propri cluster possono utilizzare le seguenti istruzioni:

1. Passa alla directory di sincronizzazione per Config Sync:

   cd SYNC_ROOT_DIR
   

2. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione delle policy su warn:

   kpt fn eval policies/policy-essentials-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
   

3. Esegui il push delle modifiche nel repository Config Sync:

   git add SYNC_ROOT_DIR/policies/policy-essentials-v2022
   git commit -m 'Adding Policy Essentials policy bundle warn enforcement'
   git push
   

4. Verifica lo stato dell'installazione:

   nomos status
   

   Il cluster dovrebbe mostrare lo stato SYNCED con i criteri installati.

Testare l'applicazione delle norme

Crea una risorsa non conforme sul cluster utilizzando il seguente comando:

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: Pod
metadata:
  namespace: default
  name: wp-non-compliant
  labels:
    app: wordpress
spec:
  containers:
    - image: wordpress
      name: wordpress
      ports:
      - containerPort: 80
        name: wordpress
EOF

Il controller di ammissione deve generare un avviso che elenca le violazioni delle norme che questa risorsa viola, come mostrato nell'esempio seguente:

Warning: [policy-essentials-v2022-psp-capabilities] container <wordpress> is not dropping all required capabilities. Container must drop all of ["NET_RAW"] or "ALL"
pod/wp-non-compliant created

Rimuovi il bundle di norme Policy Essentials

Se necessario, il bundle di norme Policy Essentials può essere rimosso dal cluster.

kubectl

• Utilizza kubectl per rimuovere i criteri:

  kubectl delete constraint -l policycontroller.gke.io/bundleName=policy-essentials-v2022
  

kpt

• Rimuovi le policy:

  kpt live destroy
  

Config Sync

Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei propri cluster possono utilizzare le seguenti istruzioni:

1. Esegui il push delle modifiche nel repository Config Sync:

   git rm -r SYNC_ROOT_DIR/policies/policy-essentials-v2022
   git commit -m 'Removing Policy Essentials v2022 policies'
   git push
   

2. Verifica lo stato:

   nomos status
   

   Il cluster dovrebbe mostrare lo stato SYNCED con le risorse rimosse.