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 sur les commandes update et enable accepte le même ensemble de champs pour configurer le comportement par défaut du parc de Config Sync.

Contrairement au flag --config de la commande apply, qui définit une représentation Google Cloud CLI des champs de l'API de configuration sous-jacente, les flags --config et --fleet-default-member-config de la commande update adoptent directement le schéma des champs de l'API Spec et MembershipSpec, respectivement. L'indicateur --fleet-default-member-config de la commande enable a également 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 le traitement 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, configSync.enabled est défini 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. Pour --config et --fleet-default-member-config, consultez la description du sous-champ version dans les champs de l'API Spec et MembershipSpec, respectivement, pour déterminer le comportement par défaut de la version Config Sync de l'API.

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.

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 défini sur 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