Administra paquetes

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

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.

    Ir al panel del Sincronizador de configuración

  2. Haz clic en Deploy Package.

  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 con alcance de clúster crea un objeto RootSync, y la sincronización con alcance de 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 información como la URL del repositorio.
      2. Opcional: Actualiza el campo Revisión para confirmar si no usas el HEAD predeterminado.
      3. Opcional: Actualiza el campo Ruta de acceso si no deseas sincronizar desde el repositorio raíz.
      4. Opcional: Actualiza el campo Rama 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 se realiza la sincronización en relación con el directorio raíz como el 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 con un par de claves SSH.
      • Cookiefile: Autentícate con un cookiefile.
      • Token: Autentícate con 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 una cantidad de segundos para establecer el Tiempo de espera de la sincronización, que determina cuánto tiempo espera el Sincronizador de configuración entre los intentos de extracción 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 verdad.

    4. Elige Hierarchy 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 verdad como quieras.

  9. Haz clic en Deploy Package.

    Se te redireccionará a la página Packages 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 Packages

  2. Opcional: Expande el menú Filtros rápidos y, luego, selecciona un filtro para 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 desde 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 Packages

  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 Uninstall package.

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

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

¿Qué sigue?