Comportement des champs de configuration gcloud

L'indicateur --config de la commande update accepte les champs permettant de configurer le comportement de Config Sync sur les clusters membres. L'indicateur --fleet-default-member-config des commandes update et enable accepte le même ensemble de champs pour configurer le comportement fleet-default de Config Sync.

Contrairement à l'option --config de la commande apply, qui définit une représentation Google Cloud CLI des champs d'API de configuration sous-jacents, les options --config et --fleet-default-member-config de la commande update adoptent directement le schéma des champs d'API Spec et MembershipSpec, respectivement. L'indicateur --fleet-default-member-config de la commande enable a également été migré de la représentation Google Cloud CLI vers le schéma de champ d'API MembershipSpec dans le canal de publication alpha, mais la représentation précédente est compatible pour assurer la rétrocompatibilité.

Cette page décrit la gestion spécifique à gcloud CLI des champs de configuration dans le schéma de champ de l'API avant que les indicateurs --config et --fleet-default-member-config ne les envoient à l'API.

Valeurs de champ par défaut

Champ Description
configSync.enabled Si l'utilisateur spécifie le champ configSync, l'installation de Config Sync est définie par défaut sur true.
version Pour l'indicateur --config, la version de Config Sync est définie par défaut sur sa valeur existante dans la configuration de l'appartenance. Si elle n'est pas configurée, elle est définie sur la version de Config Sync installée sur le cluster membre. Utilisez la commande describe pour afficher ces valeurs. Si Config Sync n'est pas installé sur le cluster membre, la gcloud CLI laisse la version non définie dans la requête API. Notez que l'API définira par défaut la version de Config Sync sur la dernière version si configSync.enabled est défini sur true pour --config et --fleet-default-member-config.

Champs non compatibles

Les indicateurs --config et --fleet-default-member-config des commandes update et enable génèrent une erreur si l'un des anciens champs suivants est défini :

  • configSync.metricsGcpServiceAccountEmail
  • policyController
  • hierarchyController
  • binauthz
  • management

Exemples de fichiers de configuration

Cette section fournit des exemples de configurations pouvant être transmises aux indicateurs --config et --fleet-default-member-config des commandes update et enable. Ces indicateurs sont compatibles avec camelCase et snake_case.

Par rapport aux exemples de la page de la commande apply, les configurations suivantes ne contiennent pas les champs applySpecVersion et spec. Le champ configSync.deploymentOverrides[].deploymentName est spec.configSync.deploymentOverrides[].name pour la commande apply. D'autres champs, y compris ceux qui ne figurent pas dans les exemples suivants, sont également nommés différemment.

L'exemple suivant montre une configuration de base :

configSync:
  enabled: true
  sourceFormat: unstructured
  git:
    syncRepo: https://github.com/GoogleCloudPlatform/anthos-config-management-samples
    syncBranch: main
    secretType: none
    policyDir: config-sync-quickstart/multirepo/root

L'exemple suivant montre une configuration plus complexe :

configSync:
  enabled: true
  stopSyncing: true
  sourceFormat: unstructured
  git:
    syncRepo: https://github.com/GoogleCloudPlatform/anthos-config-management-samples
    syncBranch: main
    secretType: none
    policyDir: config-sync-quickstart/multirepo/root
  deploymentOverrides:
  - deploymentName: reconciler-manager
    deploymentNamespace: config-management-system
    containers:
    - containerName: reconciler-manager
      cpuRequest: 50m
      cpuLimit: 100m
      memoryRequest: 256Mi
      memoryLimit: 512Mi