Comportamiento del campo de configuración de gcloud

La marca --config del comando update acepta campos para configurar el comportamiento del Sincronizador de configuración en los clústeres miembros. La marca --fleet-default-member-config en los comandos update y enable acepta el mismo conjunto de campos para configurar el comportamiento predeterminado de la flota fleet-default del Sincronizador de configuración.

A diferencia de la marca --config en el comando apply, que define una representación de Google Cloud CLI de los campos subyacentes de la API de configuración, las marcas --config y --fleet-default-member-config en el comando update adoptan directamente el esquema de los campos de la API de Spec y MembershipSpec, respectivamente. La marca --fleet-default-member-config del comando enable también se migró de la representación de Google Cloud CLI al esquema del campo de la API de MembershipSpec en el segmento de lanzamiento alpha, pero la representación anterior se admite para la retrocompatibilidad.

En esta página, se documenta el control adicional específico de la CLI de gcloud de los campos de configuración en el esquema de campos de la API antes de que las marcas --config y --fleet-default-member-config los envíen a la API.

Valores de campo predeterminados

Campo Descripción
configSync.enabled Si el usuario especifica el campo configSync, la instalación del Sincronizador de configuración se establece de forma predeterminada en true.
version Para la marca --config, la versión del Sincronizador de configuración se establece de forma predeterminada en su valor existente en la configuración de la membresía o, si no está configurada, en la versión del Sincronizador de configuración instalada en el clúster de membresía. Usa el comando describe para ver estos valores. Si Config Sync no está instalado en el clúster de membresía, la CLI de gcloud deja la versión sin configurar en la solicitud de la API. Ten en cuenta que la API establecerá de forma predeterminada la versión del Sincronizador de configuración en la versión más reciente si configSync.enabled es true para --config y --fleet-default-member-config.

Campos no admitidos

Las marcas --config y --fleet-default-member-config en los comandos update y enable muestran un error si se configura alguno de los siguientes campos heredados:

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

Archivos de configuración de ejemplo

En esta sección, se proporcionan ejemplos de configuraciones que se pueden pasar a las marcas --config y --fleet-default-member-config en los comandos update y enable. Estas marcas admiten tanto camelCase como snake_case.

En comparación con los ejemplos de la página del comando apply, las siguientes configuraciones no contienen los campos applySpecVersion y spec. El campo configSync.deploymentOverrides[].deploymentName es spec.configSync.deploymentOverrides[].name para el comando apply. Otros campos, incluidos los que no se encuentran en los siguientes ejemplos, también se denominan de manera diferente.

En el siguiente ejemplo, se muestra una configuración 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

En el siguiente ejemplo, se muestra una configuración más compleja:

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