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.
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
- Installa e inizializza Google Cloud CLI, che fornisce i comandi
gcloudekubectlutilizzati in queste istruzioni. Se utilizzi Cloud Shell, Google Cloud CLI è preinstallato. - 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
(Facoltativo) Visualizza l'anteprima dei vincoli dei criteri con kubectl:
kubectl kustomize https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-v2022
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
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
Installa e configura kpt. kpt viene utilizzato in queste istruzioni per personalizzare ed eseguire il deployment delle risorse Kubernetes.
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
Esegui la funzione kpt
set-enforcement-actionper impostare l'azione di applicazione delle policy sudryrun:kpt fn eval policy-essentials-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 \ -- enforcementAction=dryrun
Inizializza la directory di lavoro con kpt, che crea una risorsa per monitorare le modifiche:
cd policy-essentials-v2022 kpt live init
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
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
CURRENTconferma l'installazione riuscita dei vincoli.
Config Sync
- 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:
Passa alla directory di sincronizzazione per Config Sync:
cd SYNC_ROOT_DIR
Per creare o aggiungere
.gitignoreconresourcegroup.yaml:echo resourcegroup.yaml >> .gitignore
Crea una directory
policiesdedicata:mkdir -p policies
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
Esegui la funzione kpt
set-enforcement-actionper impostare l'azione di applicazione delle policy sudryrun:kpt fn eval policies/policy-essentials-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
(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
Se la directory di sincronizzazione per Config Sync utilizza Kustomize, aggiungi
policies/policy-essentials-v2022alla radicekustomization.yaml. In caso contrario, rimuovi il filepolicies/policy-essentials-v2022/kustomization.yaml:rm SYNC_ROOT_DIR/policies/policy-essentials-v2022/kustomization.yaml
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
Verifica lo stato dell'installazione:
watch gcloud beta container fleet config-management status --project PROJECT_ID
Lo stato
SYNCEDconferma 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.
kubectl
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"}]'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
Esegui la funzione kpt
set-enforcement-actionper impostare l'azione di applicazione delle policy suwarn:kpt fn eval -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
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:
Passa alla directory di sincronizzazione per Config Sync:
cd SYNC_ROOT_DIR
Esegui la funzione kpt
set-enforcement-actionper impostare l'azione di applicazione delle policy suwarn:kpt fn eval policies/policy-essentials-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
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
Verifica lo stato dell'installazione:
nomos status
Il cluster dovrebbe mostrare lo stato
SYNCEDcon 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:
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
Verifica lo stato:
nomos status
Il cluster dovrebbe mostrare lo stato
SYNCEDcon le risorse rimosse.