Questa pagina mostra come definire i vincoli di Policy Controller utilizzando i template di vincolo preesistenti forniti da Google.
Questa pagina è rivolta agli amministratori IT e agli operatori che vogliono garantire che tutte le risorse in esecuzione all'interno della piattaforma cloud soddisfino i requisiti di conformità dell'organizzazione fornendo e mantenendo l'automazione per l'audit o l'applicazione e utilizzando i modelli di configurazione dichiarativa. 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.
Policy Controller consente di applicare una policy per un cluster Kubernetes definendo uno o più oggetti vincolo. Dopo l'installazione di un vincolo, le richieste al server API vengono confrontate con il vincolo e rifiutate se non sono conformi. Le risorse non conformi preesistenti vengono segnalate al momento dell'audit.
Ogni vincolo è supportato da un template di vincolo che ne definisce lo schema e la logica. I template di vincolo possono provenire da Google e da terze parti oppure puoi scriverne di tuoi. Per saperne di più sulla creazione di nuovi template, consulta Scrivi un template di vincolo.
Prima di iniziare
Esamina la libreria dei modelli di vincolo
Quando definisci un vincolo, specifichi il template di vincolo che estende. Una libreria di modelli di vincoli comuni sviluppati da Google viene installata per impostazione predefinita e molte organizzazioni non hanno bisogno di creare modelli di vincoli personalizzati direttamente in Rego. I modelli di vincolo forniti da Google
hanno l'etichetta configmanagement.gke.io/configmanagement.
Per elencare i vincoli, utilizza il seguente comando:
kubectl get constrainttemplates \
-l="configmanagement.gke.io/configmanagement=config-management"
Per descrivere un template di vincolo e controllarne i parametri obbligatori, utilizza il seguente comando:
kubectl describe constrainttemplate CONSTRAINT_TEMPLATE_NAME
Puoi anche visualizzare tutti i modelli di vincolo nella libreria.
Definisci un vincolo
Puoi definire un vincolo utilizzando YAML e non è necessario comprendere o scrivere Rego. Un vincolo richiama invece un template di vincolo e gli fornisce parametri specifici per il vincolo.
Se utilizzi Config Sync con un repository gerarchico, ti consigliamo di creare i vincoli nella directory cluster/.
I vincoli hanno i seguenti campi:
- Il valore
kindin minuscolo corrisponde al nome di un template di vincolo. metadata.nameè il nome del vincolo.- Il campo
matchdefinisce gli oggetti a cui si applica il vincolo. Tutte le condizioni specificate devono essere soddisfatte prima che un oggetto rientri nell'ambito di un vincolo.matchLe condizioni sono definite dai seguenti campi secondari:kindssono i tipi di risorse a cui si applica il vincolo, determinati da due campi:apiGroupsè un elenco di gruppi di API Kubernetes corrispondenti ekindsè un elenco di tipi corrispondenti. "*" corrisponde a tutto. Se almeno una voceapiGroupe una vocekindcorrispondono, la condizionekindsè soddisfatta.scopeaccetta *, Cluster o Namespaced, che determina se vengono selezionate risorse con ambito cluster o con ambito spazio dei nomi (il valore predefinito è *).namespacesè un elenco di nomi di namespace a cui l'oggetto può appartenere. L'oggetto deve appartenere ad almeno uno di questi spazi dei nomi. Le risorse dello spazio dei nomi vengono trattate come se appartenessero a se stesse.excludedNamespacesè un elenco di spazi dei nomi a cui l'oggetto non può appartenere.labelSelectorè un selettore di etichette Kubernetes che l'oggetto deve soddisfare.namespaceSelectorè un selettore di etichette nello spazio dei nomi a cui appartiene l'oggetto. Se lo spazio dei nomi non soddisfa l'oggetto, non corrisponderà. Le risorse dello spazio dei nomi vengono trattate come se appartenessero a se stesse.
- Il campo
parametersdefinisce gli argomenti per il vincolo, in base a ciò che il template del vincolo si aspetta.
Il seguente vincolo, denominato ns-must-have-geo, richiama un template di vincolo denominato K8sRequiredLabels, incluso nella libreria di template di vincolo fornita da Google. Il vincolo definisce i parametri utilizzati dal template di vincolo per valutare se gli spazi dei nomi hanno l'etichetta geo impostata su un valore.
# ns-must-have-geo.yaml
apiVersion: constraints.gatekeeper.sh/v1beta1
kind: K8sRequiredLabels
metadata:
name: ns-must-have-geo
spec:
match:
kinds:
- apiGroups: [""]
kinds: ["Namespace"]
parameters:
labels:
- key: "geo"
Per creare il vincolo, utilizza kubectl apply -f:
kubectl apply -f ns-must-have-geo.yaml
Controlla un vincolo
Se il vincolo è configurato e installato correttamente, il campo status.byPod[].enforced è impostato su true, indipendentemente dal fatto che il vincolo sia configurato per l'applicazione o solo per il test.
I vincoli vengono applicati per impostazione predefinita e una violazione di un vincolo impedisce una determinata operazione del cluster. Puoi impostare il valore spec.enforcementAction di un vincolo su dryrun per segnalare le violazioni nel campo status.violations senza impedire l'operazione.
Per saperne di più sull'audit, consulta Esegui l'audit utilizzando i vincoli.
Avvertenze per la sincronizzazione dei vincoli
Se sincronizzi i vincoli con un'origine centralizzata, come un repository Git, con Config Sync o un altro strumento in stile GitOps, tieni presente i seguenti avvertimenti durante la sincronizzazione dei vincoli.
Coerenza finale
Puoi eseguire il commit dei vincoli in una fonte attendibile, ad esempio un repository Git, e puoi limitarne gli effetti utilizzando ClusterSelectors o NamespaceSelectors. Poiché la sincronizzazione è coerente, tieni presente i seguenti avvertimenti:
- Se un'operazione del cluster attiva un vincolo il cui NamespaceSelector fa riferimento a uno spazio dei nomi non sincronizzato, il vincolo viene applicato e l'operazione viene impedita. In altre parole, uno spazio dei nomi mancante "non riesce a chiudersi".
- Se modifichi le etichette di uno spazio dei nomi, la cache potrebbe contenere dati obsoleti per un breve periodo di tempo.
Riduci al minimo la necessità di rinominare uno spazio dei nomi o di modificarne le etichette e testa i vincoli che influiscono su uno spazio dei nomi rinominato o con etichette modificate per assicurarti che funzionino come previsto.
Configura Policy Controller per i vincoli referenziali
Prima di poter attivare i vincoli referenziali, devi creare una configurazione che indichi a Policy Controller quali tipi di oggetti controllare, ad esempio gli spazi dei nomi.
Salva il seguente manifest YAML in un file e applicalo con kubectl. Il manifest configura Policy Controller per monitorare gli spazi dei nomi e gli Ingress.
Crea una voce con group, version e kind in spec.sync.syncOnly, con i valori per ogni tipo di oggetto che vuoi monitorare.
apiVersion: config.gatekeeper.sh/v1alpha1
kind: Config
metadata:
name: config
namespace: "gatekeeper-system"
spec:
sync:
syncOnly:
- group: ""
version: "v1"
kind: "Namespace"
- group: "extensions"
version: "v1beta1"
kind: "Ingress"
Abilita i vincoli referenziali
Un vincolo referenziale fa riferimento a un altro oggetto nella sua definizione. Ad esempio, puoi creare un vincolo che richiede che gli oggetti Ingress in un cluster abbiano nomi host univoci. Il vincolo è referenziale se il relativo template contiene la stringa data.inventory nel relativo Rego.
I vincoli referenziali sono abilitati per impostazione predefinita se installi Policy Controller utilizzando la console Google Cloud . Se installi Policy Controller utilizzando Google Cloud CLI, puoi scegliere se abilitare i vincoli referenziali quando installi Policy Controller. La coerenza finale dei vincoli referenziali è l'unica garantita e questo comporta dei rischi:
Su un server API sovraccarico, i contenuti della cache di Policy Controller potrebbero diventare obsoleti, causando un "fail open" del vincolo referenziale, il che significa che il provvedimento sembra funzionare quando non è così. Ad esempio, puoi creare Ingress con nomi host duplicati troppo rapidamente per consentire al controller di ammissione di rilevare i duplicati.
L'ordine in cui vengono installati i vincoli e l'ordine in cui viene aggiornata la cache sono entrambi casuali.
Puoi aggiornare un cluster esistente per consentire i vincoli referenziali.
Console
Per disattivare i vincoli referenziali, completa i seguenti passaggi:
- Nella console Google Cloud , vai alla pagina Policy nella sezione Posture Management.
- Nella scheda Impostazioni, nella tabella in cluster, seleziona Modifica edit nella colonna Modifica configurazione.
- Espandi il menu Modifica la configurazione di Policy Controller.
- Seleziona la casella di controllo Abilita i modelli di vincolo che fanno riferimento a oggetti diversi dall'oggetto attualmente valutato.
- Seleziona Salva modifiche.
gcloud
Per abilitare il supporto dei vincoli referenziali, esegui questo comando:
gcloud container fleet policycontroller update \
--memberships=MEMBERSHIP_NAME \
--referential-rules
Sostituisci MEMBERSHIP_NAME con il nome dell'appartenenza del cluster registrato su cui abilitare le regole referenziali. Puoi specificare più iscrizioni separate da una virgola.
Disabilita i vincoli referenziali
Quando disattivi i vincoli referenziali, anche tutti i template che li utilizzano vengono rimossi dal cluster, insieme a tutti i vincoli che utilizzano questi template.
Console
I vincoli referenziali sono abilitati per impostazione predefinita quando installi Policy Controller con la console Google Cloud . Per disattivare i vincoli referenziali, completa i seguenti passaggi:
- Nella console Google Cloud , vai alla pagina Policy nella sezione Posture Management.
- Nella scheda Impostazioni, nella tabella in cluster, seleziona Modifica edit nella colonna Modifica configurazione.
- Espandi il menu Modifica la configurazione di Policy Controller.
- Deseleziona la casella di controllo Abilita i modelli di vincolo che fanno riferimento a oggetti diversi dall'oggetto attualmente valutato.
- Seleziona Salva modifiche.
gcloud
Per disattivare il supporto dei vincoli referenziali, esegui questo comando:
gcloud container fleet policycontroller update \
--memberships=MEMBERSHIP_NAME \
--no-referential-rules
Sostituisci MEMBERSHIP_NAME con il nome dell'appartenenza del cluster registrato su cui abilitare le regole referenziali. Puoi specificare più iscrizioni separate da una virgola.
Elenca tutti i vincoli
Per elencare tutti i vincoli installati su un cluster, utilizza il seguente comando:
kubectl get constraint
Puoi anche visualizzare una panoramica dei vincoli applicati nella console Google Cloud . Per saperne di più, consulta Metriche di Policy Controller.
Rimuovi un vincolo
Per trovare tutti i vincoli che utilizzano un template di vincolo, utilizza il seguente comando per elencare tutti gli oggetti con lo stesso kind del metadata.name del template di vincolo:
kubectl get CONSTRAINT_TEMPLATE_NAME
Per rimuovere un vincolo, specifica kind e name:
kubectl delete CONSTRAINT_TEMPLATE_NAME CONSTRAINT_NAME
Quando rimuovi un vincolo, questo non viene più applicato non appena il server API lo contrassegna come eliminato.
Rimuovi tutti i template di vincolo
Console
Per disattivare la libreria dei modelli di vincolo, completa i seguenti passaggi:
- Nella console Google Cloud , vai alla pagina Policy nella sezione Posture Management.
- Nella scheda Impostazioni, nella tabella in cluster, seleziona Modifica edit nella colonna Modifica configurazione.
- Nel menu Aggiungi/modifica pacchetti di policy, disattiva la raccolta di modelli e tutti i pacchetti di policy do_not_disturb_on.
- Seleziona Salva modifiche.
gcloud
Per disattivare la libreria di template dei vincoli, esegui questo comando:
gcloud container fleet policycontroller content templates disable \
--memberships=MEMBERSHIP_NAME
Sostituisci MEMBERSHIP_NAME con il nome dell'appartenenza del cluster registrato su cui disabilitare la libreria dei template dei vincoli. Puoi specificare più iscrizioni separate da una virgola.
Ripristina la libreria dei modelli di vincolo
Console
Per abilitare la libreria di modelli di vincoli, completa i seguenti passaggi:
- Nella console Google Cloud , vai alla pagina Policy nella sezione Posture Management.
- Nella scheda Impostazioni, nella tabella in cluster, seleziona Modifica edit nella colonna Modifica configurazione.
- Nel menu Aggiungi/modifica pacchetti di policy, attiva la raccolta di modelli check_circle. Puoi anche attivare uno o tutti i bundle di policy.
- Seleziona Salva modifiche.
gcloud
Per ripristinare la libreria dei template di vincolo, esegui questo comando:
gcloud container fleet policycontroller content templates enable \
--memberships=MEMBERSHIP_NAME
Sostituisci MEMBERSHIP_NAME con il nome dell'appartenenza del cluster registrato su cui abilitare la libreria di template dei vincoli. Puoi specificare più iscrizioni separate da una virgola.
Passaggi successivi
- Scopri di più sulle suite di Policy Controller.
- Consulta la documentazione di riferimento della libreria dei modelli di vincolo.
- Scopri come creare vincoli personalizzati.
- Risolvi i problemi di Policy Controller.