Administra paquetes

En esta página, se explica cómo administrar paquetes con el Sincronizador de configuración desde la consola de Google Cloud .

Un paquete es un conjunto de manifiestos de objetos de recursos de Kubernetes que se administran en una fuente de información y que el Sincronizador de configuración sincroniza con un clúster. Cada definición de paquete se encuentra en un objeto RootSync o RepoSync en el clúster. Para obtener información más detallada sobre los objetos RootSync y RepoSync, consulta Arquitectura de Sincronizador de configuración.

Antes de comenzar

Implementa un paquete

Después de registrar tus clústeres en una flota y de instalar el Sincronizador de configuración, puedes configurarlo para implementar un paquete en un clúster desde una fuente de información. Puedes implementar el mismo paquete en varios clústeres o implementar paquetes diferentes en clústeres distintos. Puedes editar un paquete después de implementarlo, excepto algunos parámetros de configuración, como el nombre del paquete y el tipo de sincronización. Para obtener más información, consulta Administra paquetes.

Para implementar un paquete, completa los siguientes pasos:

  1. En la consola de Google Cloud , ve al panel de Config Sync.

    Ve al panel del Sincronizador de configuración

  2. Haz clic en Implementar paquete.

  3. En la tabla Selecciona clústeres para la implementación de paquetes, selecciona el clúster en el que deseas implementar un paquete y, luego, haz clic en Continuar.

  4. Selecciona Paquete alojado en Git o Paquete alojado en OCI como tu tipo de fuente y, luego, haz clic en Continuar.

  5. En la sección Detalles del paquete, ingresa un Nombre del paquete, que identifica el objeto RootSync o RepoSync.

  6. En el campo Tipo de sincronización, elige Sincronización centrada en el clúster o Sincronización centrada en el espacio de nombres como el tipo de sincronización.

    La sincronización centrada en el clúster crea un objeto RootSync, y la sincronización centrada en el espacio de nombres crea un objeto RepoSync. Para obtener más información sobre estos objetos, consulta Arquitectura de Sincronizador de configuración.

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

    • Para las fuentes alojadas en un repositorio de Git, ingresa los siguientes campos:

      1. Ingresa la URL del repositorio de Git que usas como fuente de confianza como URL del repositorio.
      2. Opcional: Actualiza el campo Revisión para comprobar si no estás usando el HEAD predeterminado.
      3. Opcional: Actualiza el campo Ruta si no deseas sincronizar desde el repositorio raíz.
      4. Opcional: Actualiza el campo Branch si no usas la rama main predeterminada.

    • Para las fuentes alojadas en una imagen de OCI, ingresa los siguientes campos:

      1. Ingresa la URL de la imagen de OCI que usas como fuente de confianza como Imagen.
      2. Ingresa la ruta del directorio desde el que deseas sincronizar en relación con el directorio raíz como Directorio.

  8. (Opcional) Expande la sección Configuración avanzada para completar lo siguiente:

    1. Selecciona un Tipo de autenticación. El Sincronizador de configuración necesita acceso de solo lectura a tu fuente de información para leer los archivos de configuración en la fuente y aplicarlos a tus clústeres. A menos que tu fuente no requiera autenticación, como un repositorio público, asegúrate de otorgarle al Sincronizador de configuración acceso de solo lectura a tu repositorio de Git, imagen de OCI o gráfico de Helm (solo gcloud CLI). Elige el mismo tipo de autenticación que configuraste cuando instalaste el Sincronizador de configuración:

      • Ninguna: No usa autenticación.
      • SSH: Autentica mediante un par de claves SSH.
      • Cookiefile: Realiza la autenticación con un cookiefile.
      • Token: Autentica mediante un token de acceso o una contraseña.
      • Google Cloud Repository: Usa una cuenta de servicio de Google para acceder a un Cloud Source Repositories. Selecciona esta opción solo si la Workload Identity Federation for GKE no está habilitada en tu clúster.
      • Workload Identity: Usa una cuenta de servicio de Google para acceder a un repositorio de Cloud Source Repositories.

    2. Ingresa un número en segundos para establecer el tiempo de espera de sincronización, que determina cuánto tiempo espera el Sincronizador de configuración entre los intentos de extraer datos de la fuente de información.

    3. Ingresa una URL de proxy de Git para el proxy HTTPS que se usará durante la comunicación con la fuente de información.

    4. Elige Jerarquía para cambiar el Formato de origen.

      En la mayoría de los casos, se recomienda el valor predeterminado No estructurado, ya que te permite organizar tu fuente de información como quieras.

  9. Haz clic en Implementar paquete.

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

Edita un paquete

Para editar un paquete que ya implementaste, completa los siguientes pasos:

  1. En la consola de Google Cloud , ve a la pestaña Packages de Sincronizador de configuración.

    Ir a Paquetes

  2. Opcional: Expande el menú Filtros rápidos y, luego, selecciona un filtro para ayudarte a encontrar el paquete que deseas editar.

  3. Expande el nombre del paquete que deseas editar y, luego, en la fila que contiene el nombre del clúster, haz clic en el menú contextual y, luego, en Editar paquete.

  4. Revisa y actualiza la configuración del paquete que quieras cambiar.

  5. Haz clic en Guardar.

Desinstala un paquete

Para desinstalar un paquete de la consola de Google Cloud , completa los siguientes pasos:

  1. En la consola de Google Cloud , ve a la pestaña Packages de Sincronizador de configuración.

    Ir a Paquetes

  2. (Opcional): Expande el menú Filtros rápidos y, luego, selecciona un filtro para encontrar el paquete que quieres desinstalar.

  3. Expande el nombre del paquete que deseas desinstalar y, luego, en la fila que contiene el nombre del clúster, haz clic en el menú contextual y, luego, en Desinstalar paquete.

  4. En el diálogo de confirmación, selecciona si quieres desinstalar solo el objeto RootSync o RepoSync, o bien RootSync o RepoSync y todos los recursos que administran.

  5. Escribe el mensaje de confirmación y, luego, haz clic en Desinstalar.

¿Qué sigue?