Gestionar paquetes

En esta página se explica cómo gestionar paquetes con Config Sync desde la consola de Google Cloud .

Antes de empezar

Desplegar un paquete

Una vez que hayas registrado tus clústeres en una flota e instalado Config Sync, puedes configurar Config Sync para desplegar un paquete en un clúster desde una fuente de información veraz. Puedes desplegar el mismo paquete en varios clústeres o desplegar diferentes paquetes en distintos clústeres. Puedes editar un paquete después de implementarlo, excepto algunos ajustes, como el nombre del paquete y el tipo de sincronización. Para obtener más información, consulta Gestionar paquetes.

Para implementar un paquete, sigue estos pasos:

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

    Ir al panel de control de Config Sync

  2. Haz clic en Desplegar paquete.

  3. En la tabla Seleccionar clústeres para la implementación de paquetes, seleccione el clúster en el que quiera implementar un paquete y, a continuación, haga clic en Continuar.

  4. Seleccione Paquete alojado en Git o Paquete alojado en OCI como tipo de fuente y, a continuación, haga clic en Continuar.

  5. En la sección Package details (Detalles del paquete), introduce un Package name (Nombre del paquete), que identifica el objeto RootSync o RepoSync.

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

    La sincronización con ámbito de clúster crea un objeto RootSync, mientras que la sincronización con ámbito de espacio de nombres crea un objeto RepoSync. Para obtener más información sobre estos objetos, consulta el artículo Arquitectura de Config Sync.

  7. En la sección Origen, haz lo siguiente:

    • En el caso de las fuentes alojadas en un repositorio de Git, introduce los siguientes campos:

      1. Introduce la URL del repositorio de Git que estés usando como fuente de información principal en el campo URL del repositorio.
      2. Opcional: Actualiza el campo Revisión para comprobar si no estás usando el valor predeterminado HEAD.
      3. Opcional: Actualiza el campo Ruta si no quieres sincronizar desde el repositorio raíz.
      4. Opcional: Actualiza el campo Rama si no usas la rama main predeterminada.

    • En el caso de las fuentes alojadas en una imagen de OCI, introduce los siguientes campos:

      1. Introduce la URL de la imagen OCI que estés usando como fuente de información principal en el campo Imagen.
      2. Introduce la ruta del directorio desde el que se va a sincronizar, relativa al directorio raíz, en el campo Directorio.

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

    1. Selecciona un Tipo de autenticación. Config Sync necesita acceso de solo lectura a tu fuente de información veraz para leer los archivos de configuración de 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 conceder a Config Sync acceso de solo lectura a tu repositorio de Git, imagen OCI o gráfico de Helm (solo en la CLI de gcloud). Elige el mismo tipo de autenticación que configuraste al instalar Config Sync:

      • Ninguna: no se usa ninguna autenticación.
      • SSH autentica mediante un par de claves SSH.
      • Cookiefile: autentica mediante un cookiefile.
      • Token: autentícate con un token de acceso o una contraseña.
      • Repositorio de Google Cloud: usa una cuenta de servicio de Google para acceder a un repositorio de Cloud Source Repositories. Selecciona esta opción solo si la federación de identidades de carga de trabajo para 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. Introduce un número en segundos para definir el Tiempo de espera de sincronización, que determina cuánto tiempo espera Config Sync entre los intentos de extraer datos de la fuente de información veraz.

    3. Introduce una URL de proxy de Git para el proxy HTTPS que se usará al comunicarse con la fuente de información principal.

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

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

  9. Haz clic en Desplegar paquete.

    Se te redirigirá a la página Paquetes de Config Sync. Al cabo de unos minutos, debería ver el estado Sincronizado en la columna Estado de sincronización del clúster que ha configurado.

Editar un paquete

Para editar un paquete que ya hayas implementado, sigue estos pasos:

  1. En la Google Cloud consola, ve a la pestaña Paquetes de Config Sync.

    Ir a Paquetes

  2. Opcional: Despliega el menú Filtros rápidos y selecciona un filtro para encontrar el paquete que quieras editar.

  3. Despliega el nombre del paquete que quieras editar y, a continuación, en la fila que contiene el nombre del clúster, haz clic en el menú contextual y, después, en Editar paquete.

  4. Revisa y actualiza los ajustes del paquete que quieras cambiar.

  5. Haz clic en Guardar.

Desinstalar un paquete

Para desinstalar un paquete desde la consola Google Cloud , sigue estos pasos:

  1. En la Google Cloud consola, ve a la pestaña Paquetes de Config Sync.

    Ir a Paquetes

  2. Opcional: Despliega el menú Filtros rápidos y selecciona un filtro para encontrar el paquete que quieras desinstalar.

  3. Despliega el nombre del paquete que quieras desinstalar y, a continuación, en la fila que contiene el nombre del clúster, haz clic en el menú contextual y, después, en Desinstalar paquete.

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

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

Siguientes pasos