Instala el Sincronizador de configuración como valor predeterminado de la flota

Puedes instalar el Sincronizador de configuración como un valor predeterminado de la flota para que todos los clústeres nuevos que se agreguen a tu flota tengan habilitado automáticamente el Sincronizador de configuración con la configuración que desees. Si configuras los valores predeterminados a nivel de la flota, te aseguras de que cada clúster nuevo de GKE en Google Cloud registrado en la flota herede una configuración estándar del Sincronizador de configuración, incluida la versión y las conexiones a tu fuente de información. Este proceso simplifica el aprovisionamiento de clústeres y ayuda a mantener un modelo de referencia uniforme de administración de la configuración.

En esta página, se explica lo siguiente:

  • Cómo configurar estos parámetros predeterminados a nivel de la flota con Google Cloud CLI, Google Cloud la consola o Terraform.
  • Cómo aplicar la configuración predeterminada a los clústeres existentes.
  • Cómo inhabilitar la configuración predeterminada de la flota si es necesario.

Para obtener información general sobre las configuraciones predeterminadas de la flota, consulta Administra funciones a nivel de la flota.

Antes de comenzar

Antes de instalar el Sincronizador de configuración, prepara tu fuente de información y un clúster adecuado.

Otorga acceso al Sincronizador de configuración a tu fuente de información

Para sincronizar la configuración de una fuente de información con tus clústeres, el Sincronizador de configuración requiere acceso de solo lectura a tu repositorio. Para autorizar al Sincronizador de configuración a leer tus configuraciones, completa los siguientes pasos:

Revisa los requisitos del clúster

Antes de crear un clúster, revisa los requisitos del clúster.

Limitaciones

  • No se admite la configuración de Helm como tipo de fuente predeterminado de la flota.
  • La Google Cloud consola no admite la conexión a una fuente de información como configuración predeterminada. En su lugar, debes usar la función Implementar paquetes después de crear un clúster.

Configura los valores predeterminados a nivel de la flota para un repositorio de Git

Para configurar los valores predeterminados a nivel de la flota para el Sincronizador de configuración, completa los siguientes pasos:

gcloud

  1. Crea un manifiesto llamado apply-spec.yaml con el siguiente contenido. Si ya creaste un manifiesto, no es necesario que crees uno nuevo.

    applySpecVersion: 1
spec:
  configSync:
    enabled: true
    sourceType: git
    sourceFormat: unstructured
    syncRepo: REPO
    syncRev: REVISION
    secretType: SECRET_TYPE
    # only required if gcpserviceaccount is the secretType
    # gcpServiceAccountEmail: EMAIL
    metricsGcpServiceAccountEmail: METRICS_EMAIL

    Reemplaza lo siguiente:

    • REPO: la URL de tu repositorio de Git, por ejemplo, https://github.com/GoogleCloudPlatform/anthos-config-management-samples. Usa el formato HTTPS para la URL o el formato SSH si ssh es el sourceType.
    • REVISION: la revisión de Git (etiqueta o hash) o el nombre de la rama desde la que se sincronizará. Cuando se usa un hash, debe ser un hash completo y no una forma abreviada.

    • SECRET_TYPE: el método de autenticación que se usa para conectarse a tu repositorio de Git. Para los repositorios públicos, usa none. Para los repositorios privados, usa una de las siguientes opciones:

      • ssh: usa un par de claves SSH.
      • cookiefile: usa un cookiefile.
      • token: usa un token.
      • gcpserviceaccount: usa una cuenta de servicio de Google si Workload Identity Federation for GKE está habilitado. Solo Secure Source Manager o Cloud Source Repositories.
      • gcenode: usa una cuenta de servicio de Google si Workload Identity Federation for GKE no está habilitado. Solo Secure Source Manager o Cloud Source Repositories.
      • githubapp: usa una app de GitHub para autenticarte en un repositorio de GitHub.

      Para obtener más información sobre cómo conectar tu repositorio de Git al Sincronizador de configuración, consulta Otorga acceso al Sincronizador de configuración a Git.

    • EMAIL: si gcpserviceaccount es el secretType, quita el comentario de este campo y agrega la dirección de correo electrónico de la cuenta de servicio de Google, por ejemplo, config-sync@PROJECT_ID.iam.gserviceaccount.com.

    • METRICS_EMAIL: el correo electrónico de la Google Cloud cuenta de servicio (GSA) que se usa para exportar las métricas del Sincronizador de configuración a Cloud Monitoring. Para obtener más información sobre cómo configurar la exportación de métricas, consulta Supervisa el Sincronizador de configuración.

    Para obtener una lista completa de los campos que puedes agregar al manifiesto apply-spec, consulta los campos de gcloud apply spec.

  2. Ejecuta el siguiente comando para aplicar el archivo apply-spec con la configuración predeterminada de la flota:

    gcloud beta container fleet config-management enable \
    --fleet-default-member-config=apply-spec.yaml

Console

  1. En la Google Cloud consola, ve a la página Administrador de funciones.

    Ir a Administrador de funciones

  2. En el panel Sincronizador de configuración, haz clic en Configurar.

  3. Revisa la configuración a nivel de la flota. Todos los clústeres nuevos que crees en la flota heredarán esta configuración.

  4. Opcional: Para cambiar la configuración predeterminada, haz clic en Personalizar la configuración de la flota. En el cuadro de diálogo que aparece, haz lo siguiente:

    1. Selecciona la versión del Sincronizador de configuración que deseas usar.
    2. Haz clic en Guardar cambios.

  5. Haz clic en Configurar.

  6. En el cuadro de diálogo de confirmación Configuración de la flota, haz clic en Confirmar. Si no habilitaste el Sincronizador de configuración anteriormente, haz clic en Confirmar para habilitar la API de anthosconfigmanagement.googleapis.com.

Aunque no puedes configurar los parámetros de configuración de tu fuente de información como un valor predeterminado de la flota desde la Google Cloud consola, puedes seleccionar varios clústeres cuando usas la función Implementar un paquete.

Terraform

Para habilitar el Sincronizador de configuración como un valor predeterminado de la flota, consulta el siguiente ejemplo:

resource "google_gke_hub_feature" "default" {
  name     = "configmanagement"
  location = "global"

  fleet_default_member_config {
    configmanagement {
      config_sync {
        # The field `enabled` was introduced in Terraform version 5.41.0, and
        # needs to be set to `true` explicitly to install Config Sync.
        enabled = true
        git {
          sync_repo   = "REPO"
          sync_branch = "BRANCH"
          policy_dir  = "DIRECTORY"
          secret_type = "SECRET"
        }
      }
    }
  }
}

Reemplaza lo siguiente:

  • REPO: la URL del repositorio de Git que contiene tus archivos de configuración.
  • BRANCH: la rama del repositorio, por ejemplo, main.
  • DIRECTORY: la ruta de acceso dentro del repositorio de Git que representa el nivel superior del repositorio que deseas sincronizar.
  • SECRET: el tipo de autenticación secreta.

Para obtener más información sobre el uso de Terraform, consulta Aprovisiona recursos del Sincronizador de configuración con Terraform.

Configura los valores predeterminados a nivel de la flota para una imagen de OCI

Para configurar los valores predeterminados a nivel de la flota para el Sincronizador de configuración, completa los siguientes pasos:

gcloud

  1. Crea un manifiesto llamado apply-spec.yaml con el siguiente contenido. Si ya creaste un manifiesto, no es necesario que crees uno nuevo.

    applySpecVersion: 1
spec:
  configSync:
    enabled: true
    sourceType: oci
    sourceFormat: unstructured
    syncRepo: REPO
    secretType: SECRET_TYPE
    # only required if gcpserviceaccount is the secretType
    # gcpServiceAccountEmail: EMAIL
    metricsGcpServiceAccountEmail: METRICS_EMAIL

    Reemplaza lo siguiente:

    • REPO: la URL de tu imagen de OCI con el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME. De forma predeterminada, la imagen se extrae de la etiqueta latest, pero puedes extraer imágenes mediante TAG o DIGEST. Especifica TAG o DIGEST en PACKAGE_NAME:

      • Para extraer antes del TAG: LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME:TAG
      • Para extraer antes del DIGEST: LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME@sha256:DIGEST

    • SECRET_TYPE: el método de autenticación que se usa para conectarse a tu imagen de OCI. Para las imágenes públicas, usa none como valor. Para las imágenes privadas, usa una de las siguientes opciones:

      • gcpserviceaccount: Solo Secure Source Manager o Cloud Source Repositories. Usa una cuenta de servicio de Google si Workload Identity Federation for GKE está habilitado.
      • gcenode: Solo Secure Source Manager o Cloud Source Repositories. Usa una cuenta de servicio de Google si Workload Identity Federation for GKE no está habilitado.

      Para obtener más información sobre cómo conectar tu imagen de OCI al Sincronizador de configuración, consulta Otorga acceso al Sincronizador de configuración a OCI o Helm.

    • EMAIL: si gcpserviceaccount es el secretType, quita el comentario de este campo y agrega la dirección de correo electrónico de la cuenta de servicio de Google, por ejemplo, config-sync@PROJECT_ID.iam.gserviceaccount.com.

    • METRICS_EMAIL: el correo electrónico de la Google Cloud cuenta de servicio (GSA) que se usa para exportar las métricas del Sincronizador de configuración a Cloud Monitoring. Para obtener más información sobre cómo configurar la exportación de métricas, consulta Supervisa el Sincronizador de configuración.

    Para obtener una lista completa de los campos que puedes agregar al manifiesto apply-spec, consulta los campos de gcloud apply spec.

  2. Ejecuta el siguiente comando para aplicar el archivo apply-spec con la configuración predeterminada de la flota:

    gcloud beta container fleet config-management enable \
    --fleet-default-member-config=apply-spec.yaml

Console

  1. En la Google Cloud consola, ve a la página Administrador de funciones.

    Ir a Administrador de funciones

  2. En el panel Sincronizador de configuración, haz clic en Configurar.

  3. Revisa la configuración a nivel de la flota. Todos los clústeres nuevos que crees en la flota heredarán esta configuración.

  4. Opcional: Para cambiar la configuración predeterminada, haz clic en Personalizar la configuración de la flota. En el cuadro de diálogo que aparece, haz lo siguiente:

    1. Selecciona la versión del Sincronizador de configuración que deseas usar.
    2. Haz clic en Guardar cambios.

  5. Haz clic en Configurar.

  6. En el cuadro de diálogo de confirmación Configuración de la flota, haz clic en Confirmar. Si no habilitaste el Sincronizador de configuración anteriormente, haz clic en Confirmar para habilitar la API de anthosconfigmanagement.googleapis.com.

Aunque no puedes configurar los parámetros de configuración de tu fuente de información como un valor predeterminado de la flota desde la Google Cloud consola, puedes seleccionar varios clústeres cuando usas la función Implementar un paquete.

Terraform

Para habilitar el Sincronizador de configuración como un valor predeterminado de la flota, consulta el siguiente ejemplo:

resource "google_gke_hub_feature" "configmanagement_feature_member" {
  name     = "configmanagement"
  location = "global"

  fleet_default_member_config {
    configmanagement {
      config_sync {
        # The field `enabled` was introduced in Terraform version 5.41.0, and
        # needs to be set to `true` explicitly to install Config Sync.
        enabled = true
        oci {
          sync_repo   = "REPO"
          policy_dir  = "DIRECTORY"
          secret_type = "SECRET"
        }
      }
    }
  }
}

Reemplaza lo siguiente:

  • REPO: la URL del repositorio de imágenes de OCI que contiene tus archivos de configuración.
  • DIRECTORY: la ruta de acceso absoluta del directorio que contiene los recursos que deseas sincronizar. Para usar el directorio raíz, deja este campo en blanco.
  • SECRET: el tipo de autenticación secreta.

Para obtener más información sobre el uso de Terraform, consulta Aprovisiona recursos del Sincronizador de configuración con Terraform.

Actualiza los clústeres existentes para heredar los valores predeterminados de la flota

Para actualizar los clústeres existentes para usar la configuración predeterminada del Sincronizador de configuración, puedes usar la Google Cloud consola o gcloud CLI para sincronizar los clústeres de la flota seleccionados con los valores predeterminados de la flota. Como alternativa, puedes configurar manualmente cada clúster con la misma configuración usando Terraform y siguiendo las instrucciones para instalar el Sincronizador de configuración en la sección anterior. Si usaste Terraform anteriormente para especificar los valores predeterminados de la flota, usa el mismo bloque configmanagement y config_sync que usaste para establecer los valores predeterminados para configurar los clústeres elegidos.

Para sincronizar la configuración predeterminada del Sincronizador de configuración en toda la flota, sigue estos pasos:

gcloud

  1. Sincroniza una membresía existente con la configuración predeterminada de la flota:

    gcloud beta container fleet config-management apply \
    --origin=FLEET \
    --membership=MEMBERSHIP_NAME

    Reemplaza MEMBERSHIP_NAME por el nombre de la membresía de la flota del clúster que deseas sincronizar con la configuración predeterminada de la flota.

  2. Confirma que las configuraciones de tu membresía estén sincronizadas con la configuración predeterminada de la flota:

    gcloud beta container fleet config-management status

    El resultado de este comando debería mostrar Yes para el estado Synced_to_Fleet_Default de la membresía que sincronizaste.

Console

  1. Ve al Administrador de funciones

    Ve al Administrador de funciones: Sincronizador de configuración

  2. En la tabla de clústeres, selecciona los clústeres que deseas sincronizar con la configuración de la flota.

  3. Haz clic en Sincronizar con la configuración de la flota.

Inhabilita los valores predeterminados de la flota

Para inhabilitar la configuración predeterminada del Sincronizador de configuración en toda la flota, sigue estos pasos:

  1. Para quitar la configuración predeterminada a nivel de la flota, ejecuta el siguiente comando:

    gcloud beta container fleet config-management disable --fleet-default-member-config

  2. Confirma que la configuración predeterminada de la flota esté inhabilitada:

    gcloud beta container fleet config-management status

¿Qué sigue?