Comportamento do campo de configuração da gcloud

A flag --config no update comando aceita campos para configurar o comportamento do Config Sync em clusters de membros. A flag --fleet-default-member-config nos comandos update e enable aceita o mesmo conjunto de campos para configurar o comportamento padrão do Config Sync da frota.

Ao contrário da flag --config no comando apply, que define uma representação da Google Cloud CLI dos campos da API de configuração subjacente, as flags --config e --fleet-default-member-config no comando update adotam diretamente o esquema do campo da API Spec e do campo da API MembershipSpec, respectivamente. A flag --fleet-default-member-config no enable comando também migrou da representação da Google Cloud CLI para o esquema de campo da API MembershipSpec na faixa de lançamento alpha, mas a representação anterior é compatível com versões anteriores.

Esta página documenta o processamento adicional específico da CLI gcloud dos campos de configuração no esquema de campo da API antes que as flags --config e --fleet-default-member-config os enviem para a API.

Valores de campo padrão

Campo Descrição
configSync.enabled Se o usuário especificar o campo configSync, configSync.enabled será definido como true por padrão.
version Para a flag --config, a versão do Config Sync é definida como o valor atual na configuração de associação ou, se não estiver configurada, a versão do Config Sync instalada no cluster de membros. Use o comando describe para conferir esses valores. Se o Config Sync não estiver instalado no cluster de membros, a CLI gcloud deixará a versão não definida na solicitação de API. Para --config e --fleet-default-member-config, consulte a descrição do subcampo version no campo da API Spec e no campo da API MembershipSpec, respectivamente, para determinar o comportamento padrão da versão do Config Sync da API.

Campos sem suporte

As flags --config e --fleet-default-member-config nos update e enable comandos geram um erro se algum dos seguintes campos legados estiver definido:

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

Exemplos de arquivos de configuração

Esta seção fornece exemplos de configurações que podem ser transmitidas para as --config e --fleet-default-member-config flags nos update e enable comandos.

Em comparação com os exemplos na página de comandos apply, as configurações a seguir não contêm applySpecVersion e spec campos. O campo configSync.deploymentOverrides[].deploymentName é spec.configSync.deploymentOverrides[].name para o comando apply. Outros campos, incluindo aqueles que não estão nos exemplos a seguir, também têm nomes diferentes.

O exemplo a seguir mostra uma configuração básica:

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

O exemplo a seguir mostra uma configuração mais complexa:

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