Instala el Sincronizador de configuración con la configuración predeterminada

El Sincronizador de configuración sincroniza tus configuraciones de Kubernetes con tus clústeres. En este documento, se explica cómo habilitar y configurar el Sincronizador de configuración con la configuración predeterminada. Se enfoca en sincronizar la configuración desde un repositorio de Git no estructurado.

Esta página está dirigida a los operadores que desean implementar herramientas de GitOps para centralizar la administración de la configuración de sus equipos. Para obtener más información sobre los roles comunes y las tareas de ejemplo a las que hacemos referencia en el contenido de Google Cloud , consulta Roles y tareas comunes de los usuarios de GKE.

Para obtener instrucciones sobre cómo instalar Sincronizador de configuración con parámetros de configuración avanzados, consulta Personaliza tu Sincronizador de configuración Sync.

Antes de comenzar

Antes de instalar el Sincronizador de configuración, prepara tu repositorio de Git y tus clústeres de GKE.

Crea un repositorio de Git y otorga acceso al Sincronizador de configuración

Para sincronizar la configuración de un repositorio de Git 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:

  • Crea un repositorio de Git que contenga los archivos de configuración que deseas que el Sincronizador de configuración sincronice con tus clústeres, o bien accede a uno.

  • Si tu repositorio de Git es público, no es necesario que realices ninguna otra acción. El Sincronizador de configuración no requiere permisos adicionales.

  • Si tu repositorio de Git es privado, sigue las instrucciones en Otorga acceso al Sincronizador de configuración a Git.

Crea un clúster

Si ya tienes un clúster preparado, por ejemplo, si seguiste los pasos para otorgar acceso al Sincronizador de configuración a Git, continúa con Instala el Sincronizador de configuración.

El Sincronizador de configuración requiere que tus clústeres estén registrados en una flota. Para registrar tus clústeres, completa el siguiente paso:

Console

No es necesario que realices ninguna acción. Tus clústeres se registran automáticamente en una flota cuando instalas Sincronizador de configuración.

gcloud

  • Para crear un clúster de Autopilot registrado en una flota, ejecuta el siguiente comando:

    gcloud container clusters create-auto CLUSTER_NAME --enable-fleet

  • Para crear un clúster estándar registrado en una flota, ejecuta el siguiente comando:

    gcloud container clusters create CLUSTER_NAME --enable-fleet \
    --workload-pool=PROJECT_ID.svc.id.goog

Reemplaza lo siguiente:

  • CLUSTER_NAME: El nombre de tu clúster.
  • PROJECT_ID: el ID de tu proyecto

Para obtener más información sobre el registro de clústeres, consulta Registra un clúster en una flota.

Instalar el Sincronizador de configuración

Para habilitar y configurar el Sincronizador de configuración para que sincronice la configuración de tu repositorio de Git con tus clústeres registrados, completa los siguientes pasos:

Console

Si usas la consola de Google Cloud , primero debes instalar el Sincronizador de configuración en tus clústeres y, luego, configurar un paquete que permita que el Sincronizador de configuración se sincronice desde tu repositorio de Git.

Instalar el Sincronizador de configuración

  1. Ve a la página Config Sync en la consola de Google Cloud .

    Ir a Configuración

  2. Haz clic en Instalar el Sincronizador de configuración.

  3. Selecciona Instalar en todos los clústeres de la flota.

  4. Deja el resto de la configuración con sus valores predeterminados.

  5. Haz clic en Instalar el Sincronizador de configuración.

En la pestaña Configuración, después de unos minutos, aparecerá Habilitado en la columna Estado para los clústeres de tu flota.

Implementa un paquete

  1. Haz clic en Implementar paquete de clústeres.

  2. En la pestaña Seleccionar clústeres, selecciona el clúster en el que deseas implementar un paquete y, luego, haz clic en Continuar.

  3. Haz clic en la pestaña Configurar paquete y, luego, ingresa un nombre para el paquete.

  4. En la sección Fuente, completa lo siguiente:

    1. En el campo URL del repositorio, ingresa la URL de tu repositorio de Git.

    2. Opcional: Revisa y actualiza la configuración de los otros campos. Es posible que no necesites actualizar estos parámetros de configuración según la estructura de tu repositorio.

  5. Opcional: Si tu repositorio es privado, expande la sección Configuración avanzada para configurar tu método de autenticación. La consola de Google Cloud proporciona instrucciones integradas para ayudarte a configurar los parámetros de autenticación.

  6. Deja el resto de la configuración con sus valores predeterminados.

  7. Haz clic en Implementar paquete.

Se te redireccionará a la página Packages del Sincronizador de configuración. Después de unos minutos, aparecerá Sincronizado en la columna Estado de sincronización del clúster que configuraste.

gcloud

Si usas gcloud CLI, instalas el Sincronizador de configuración creando un manifiesto que contiene tu configuración del Sincronizador de configuración y, luego, aplicando esa configuración a tu clúster.

  1. Habilita la función de flota ConfigManagement:

    gcloud beta container fleet config-management enable

  2. Crea un manifiesto llamado apply-spec.yaml. Este manifiesto de ejemplo contiene la configuración predeterminada recomendada:

    applySpecVersion: 1
spec:
  configSync:
    enabled: true
    sourceFormat: unstructured
    syncRepo: REPO_URL
    # syncRev: REVISION
    secretType: none
    preventDrift: false

    Reemplaza lo siguiente:

    • REPO_URL: La URL de tu repositorio de Git, por ejemplo, https://github.com/GoogleCloudPlatform/anthos-config-management-samples.

    • REVISION: La revisión de Git (etiqueta o hash) o la rama desde la que deseas sincronizar (opcional). Quita el comentario y reemplaza este campo si necesitas sincronizar desde una ubicación que no sea HEAD.

      En el caso de los repositorios privados, puedes cambiar el campo secretType a un método de autenticación compatible. En general, se recomienda una cuenta de servicio de Google (gcpserviceaccount) con Secure Source Manager. Como alternativa, usa ssh, ya que funciona con la mayoría de los proveedores de Git. Para obtener instrucciones más detalladas sobre los métodos de autenticación admitidos, consulta Otorga acceso a Git.

  3. Aplica el manifiesto al clúster:

    gcloud beta container fleet config-management apply \
    --membership=MEMBERSHIP_NAME \
    --config=apply-spec.yaml \
    --project=PROJECT_ID

    Reemplaza lo siguiente:

    • MEMBERSHIP_NAME: Es el nombre de la membresía de flota que elegiste cuando registraste el clúster. Obtén el nombre con el comando gcloud container fleet memberships list.
    • PROJECT_ID: ID del proyecto

Verifique la instalación

Después de instalar y configurar el Sincronizador de configuración, verifica que la instalación se haya completado correctamente.

Console

  1. Ve a la página Config Sync en la consola de Google Cloud .

    Ir al Sincronizador de configuración

  2. En la pestaña Packages, verifica la columna Sync status en la tabla del clúster. Si la instalación del Sincronizador de configuración se realiza correctamente, se mostrará el estado Instalado. Un repositorio de Git configurado correctamente muestra el estado Sincronizado.

gcloud

Ejecuta el siguiente comando:

nomos status

Si la instalación se realiza correctamente, se muestra el estado SYNCED o PENDING.

Para obtener más detalles sobre la información que proporciona el comando nomos status, incluidos los errores informados, consulta Verifica el estado de Config Sync en la documentación de la herramienta de línea de comandos de nomos.

¿Qué sigue?