Champs spécifiques de la commande d'application de gcloud

Cette page décrit les différents champs que vous pouvez définir dans le fichier de configuration pour Anthos Config Management. Vous utilisez ce fichier lorsque vous configurez des composants Anthos Config Management avec l'outil de ligne de commande gcloud. La commande de l'outil gcloud qui vous permet d'appliquer le fichier de configuration contient également une documentation de référence.

Le format du fichier utilisé avec l'outil gcloud est semblable à celui de l'objet ConfigManagement. Cependant, les formats sont différents et les deux ne sont pas interchangeables.

Remarque : Le format de fichier que vous utilisez avec les commandes de l'outil gcloud a été modifié pour la version 1.8.0. Veillez à mettre à jour votre outil gcloud vers la dernière version.

Configuration pour Config Sync

Clé	Description
spec.configSync.enabled	Si la valeur est true, active Config Sync. La valeur par défaut est false.
spec.configSync.syncRepo	URL du dépôt Git à utiliser comme source fiable. Vous pouvez omettre ce champ si vous n'avez pas préparé de dépôt Git.
spec.configSync.syncBranch	Branche du dépôt à partir de laquelle la synchronisation doit être effectuée. Valeur par défaut : master
spec.configSync.policyDir	Chemin d'accès du dépôt Git vers le répertoire racine contenant la configuration que vous souhaitez synchroniser. La valeur par défaut correspond au répertoire racine du dépôt.
spec.configSync.syncWait	Période en secondes entre des synchronisations consécutives. La valeur par défaut est 15.
spec.configSync.syncRev	Révision Git (tag ou hachage) à récupérer. Valeur par défaut : HEAD.
spec.configSync.preventDrift	Si la valeur est true, active le webhook d'admission Config Sync pour éviter les écarts en empêchant le transfert des modifications incompatibles vers les clusters opérationnels. Valeurs par défaut : false. Config Sync corrige toujours les dérives, quelle que soit la valeur de ce champ. Ce champ est compatible avec Anthos Config Management version 1.10.0 et ultérieure.
spec.git.auth	Type de secret configuré pour l'accès au dépôt Git. La valeur doit être ssh, cookiefile, gcenode, gcpserviceaccount, token ou none. La validation de ce champ est sensible à la casse. Obligatoire.
spec.git.gcpServiceAccountEmail	Compte de service Google Cloud utilisé pour annoter le compte de service Kubernetes du contrôleur RootSync ou RepoSync. Ce champ n'est utilisé que lorsque spec.git.auth est défini sur gcpserviceaccount.
spec.configSync.sourceFormat	Si vous définissez ce paramètre sur unstructured, vous configurez un dépôt non hiérarchique. Valeur par défaut : hierarchy

Configuration du proxy pour le dépôt Git

Si les règles de sécurité de votre organisation vous obligent à acheminer le trafic via un proxy HTTPS, vous pouvez utiliser l'URI du proxy pour configurer Config Sync de manière à communiquer avec votre hôte Git. Le proxy n'est compatible qu'avec les types d'autorisation cookiefile, none ou token.

Remarque : Pour des raisons de sécurité, le proxy HTTP n'est pas accepté.

Clé	Description
spec.configSync.httpsProxy	Définit une variable d'environnement HTTPS_PROXY permettant d'accéder au dépôt Git.

Configuration pour Policy Controller

Clé	Description
spec.policyController.enabled	Si elle est définie sur true, Policy Controller est activé. La valeur par défaut est false.
spec.policyController.templateLibraryInstalled	Si elle est définie sur true, une bibliothèque de modèles de contrainte est installée pour les types de règles courants. La valeur par défaut est true.
spec.policyController.referentialRulesEnabled	Si la valeur est true, active la prise en charge des contraintes référentielles. Assurez-vous de bien comprendre les mises en garde concernant la cohérence à terme. La valeur par défaut est false.
spec.policyController.auditIntervalSeconds	Période en secondes entre les audits consécutifs liés au non-respect des contraintes. Définissez la valeur sur "0" pour désactiver la fonctionnalité d'audit. Valeur par défaut : 60.
spec.policyController.logDeniesEnabled	Si la valeur est true, tous les journaux refusent et simulent les échecs. La valeur par défaut est false.
spec.policyController.exemptableNamespaces	Liste des espaces de noms à supprimer de l'application du webhook d'admission Policy Controller. Les violations sont toujours signalées dans l'audit. La liste est vide par défaut.

Configuration pour Hierarchy Controller

Clé	Description
spec.hierarchyController.enabled	Si elle est définie sur true, Hierarchy Controller est activé. La valeur par défaut est false.
spec.hierarchyController.enableHierarchicalResourceQuota	Si elle est définie sur true, les quotas de ressources hiérarchiques sont activés. La valeur par défaut est false.
spec.hierarchyController.enablePodTreeLabels	Si la valeur est true, active l'observation hiérarchique des charges de travail. La valeur par défaut est false.

Exemple spécifique de la commande d'application de gcloud

applySpecVersion: 1
spec:
  configSync:
    enabled: true
    sourceFormat: unstructured
    syncRepo: https://github.com/GoogleCloudPlatform/anthos-config-management-samples
    syncBranch: main
    secretType: none
    policyDir: root-multirepo-unstructured
  policyController:
    enabled: false
  hierarchyController:
     enabled: false