Ciclo de vida de una implementación de Marketplace

En este documento, se explica cómo instalar, actualizar y desinstalar paquetes de software de Marketplace de Google Distributed Cloud (GDC) aislado con la consola de GDC. También puedes instalar paquetes de software con la CLI de gdcloud marketplace o la API de Marketplace.

Este documento está dirigido a públicos dentro del grupo de operadores de aplicaciones que administran el ciclo de vida de las implementaciones de Marketplace dentro de los proyectos de GDC. Para obtener más información, consulta Públicos de la documentación de GDC aislado.

Antes de comenzar

Antes de instalar, actualizar o desinstalar paquetes de software de Marketplace, debes tener los permisos necesarios y preparar tu entorno.

Solicita roles de IAM

Comunícate con el administrador de la organización de IAM o el administrador del proyecto de IAM para solicitar los siguientes roles según las tareas que debas realizar en tu proyecto:

• Editor de Marketplace (marketplace-editor): Instala, actualiza y desinstala paquetes de software de Marketplace.
• Visualizador del proyecto (project-viewer): Permite ver un proyecto existente y sus recursos.

El administrador de IAM de la organización puede otorgar estos roles para cualquier proyecto dentro de la organización. El administrador de IAM del proyecto puede otorgar estos roles dentro del alcance de su proyecto específico.

Prepara el entorno

Las tareas de esta página usan principalmente la consola de GDC. Si planeas usar las alternativas de línea de comandos, completa lo siguiente:

• Descarga e instala la CLI de gdcloud, si aún no lo hiciste.
• Para usar la API con kubectl, se requiere una configuración adicional:
  • Instala la CLI de kubectl.
  • Genera un archivo kubeconfig.

Instala un paquete de software de Distributed Cloud Marketplace

Para instalar un paquete de software desde el mercado de Distributed Cloud, completa los siguientes pasos:

Console

1. En el selector de proyectos de la consola de GDC, selecciona el proyecto en el que deseas instalar el paquete de software.
2. En Distributed Cloud Marketplace, visita la página de la ficha del producto que quieres instalar. En esta página, puedes revisar los detalles del producto y seguir los vínculos a su documentación, precios y condiciones del servicio.
3. Si es la primera vez que instalas este producto, haz clic en Instalar. De lo contrario, ve a la pestaña Administración y haz clic en Nueva instancia.
4. En el cuadro de diálogo, selecciona en qué clúster de usuario deseas instalar el paquete de software. Si quieres personalizar su configuración, haz clic en Siguiente. Si deseas usar la configuración predeterminada, haz clic en Instalar.
5. Si hiciste clic en Siguiente, ahora puedes examinar la configuración predeterminada. Haz clic en Configuración personalizada para ingresar tus propios parámetros, según la documentación del proveedor. Cuando termines, haz clic en Install para continuar con la instalación. En el caso de los paquetes de software de Kubernetes, los parámetros que configures aquí anularán los valores predeterminados que proporciona el proveedor en su archivo de valores de Helm.

6. Espera unos minutos hasta que tu instancia nueva se marque como Lista en la pestaña Administración de la página.

   

7. Consulta la documentación del proveedor de software correspondiente para aprender a usar su solución una vez que esté instalada.

gdcloud

1. Selecciona el proyecto en el que deseas instalar el paquete de software:

   gdcloud config set project PROJECT_NAME
   

   Reemplaza PROJECT_NAME por el nombre del proyecto en el que deseas instalar el paquete de software.

2. Enumera las aplicaciones de Marketplace disponibles:

   gdcloud marketplace services list
   

3. Instala la aplicación seleccionada de la lista y especifica el clúster de destino:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME
   

   Para proporcionar anulaciones de configuración personalizadas durante la instalación, usa la marca --parameters-file:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME \
     --parameters-file=PATH_TO_PARAMETERS_FILE
   

   Reemplaza lo siguiente:

   • SERVICE_NAME: Es el nombre del servicio de Marketplace que se instalará (por ejemplo, dataproc).
   • CLUSTER_NAME: Es el nombre del clúster de usuario de destino en el que deseas instalar la aplicación.
   • PATH_TO_PARAMETERS_FILE: Es la ruta de acceso a un archivo YAML que contiene parámetros de anulación de configuración para la instancia de servicio.

4. Verifica la instalación:

   gdcloud marketplace services list
   

   Confirma que la aplicación instalada recientemente aparezca en la lista con el estado READY o INSTALLED.

API

1. Enumera los recursos ServiceVersion disponibles para encontrar el servicio y la versión específicos que deseas instalar:

   kubectl get serviceversions -n mkt-system
   

2. Crea un manifiesto YAML para un recurso ServiceInstance (por ejemplo, service-instance.yaml):

   apiVersion: marketplace.gdc.goog/v1
   kind: ServiceInstance
   metadata:
     name: INSTANCE_NAME
   spec:
     clusterRef:
       name: CLUSTER_NAME
       namespace: CLUSTER_NAMESPACE
     serviceVersionRef:
       name: SERVICE_VERSION_NAME
       namespace: mkt-system
     parameters:
       KEY: VALUE
   

   Reemplaza lo siguiente:

   • INSTANCE_NAME: Es un nombre para la instancia de tu aplicación nueva.
   • CLUSTER_NAME: Es el nombre del clúster de usuario de destino en el que deseas instalar la aplicación.
   • CLUSTER_NAMESPACE: Es el espacio de nombres del clúster (por ejemplo, production-cluster).
   • SERVICE_VERSION_NAME: Es el nombre del ServiceVersion que se instalará (por ejemplo, dataproc-1.0.0).
   • KEY: Es el nombre del parámetro de anulación de la configuración, según el esquema de valores de Helm del proveedor.
   • VALUE: Es el valor del parámetro de anulación de la configuración.

   Para obtener más información y un manifiesto de ejemplo, consulta la descripción general de la API de Marketplace.

3. Aplica el manifiesto al proyecto:

   kubectl apply -f service-instance.yaml -n PROJECT_NAME
   

   Reemplaza PROJECT_NAME por el nombre del proyecto en el que deseas instalar el paquete de software.

4. Para verificar la instalación, inspecciona el estado del objeto ServiceInstance:

   kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
   

   Confirma que status.conditions contenga una condición de tipo Ready con el estado "True" y que status.installedVersion muestre la versión instalada.

Nota: Si necesitas saber qué imagen de contenedor está disponible en GDC, consulta la lista de imágenes de Marketplace que se incluyen en tu versión de GDC. Las imágenes que se incluyeron en versiones anteriores de GDC siguen estando disponibles para su uso, incluso después de una actualización de GDC.

Vuelve a configurar una instancia de un paquete de software de Distributed Cloud Marketplace

Advertencia: Si bien puedes volver a configurar una instancia en ejecución de un paquete de software de Distributed Cloud Marketplace, el proceso de reconfiguración lo implementa el proveedor que publicó el producto. Por lo tanto, el proceso de reconfiguración varía de un paquete de software a otro. Te recomendamos que revises detenidamente la documentación del proveedor correspondiente antes de continuar con una reconfiguración. Según cómo el proveedor haya implementado su proceso de reconfiguración, es posible que experimentes un tiempo de inactividad en el servicio que se entrega.

Algunos paquetes de software de Distributed Cloud Marketplace se pueden volver a configurar cuando ya se están ejecutando. En el caso de los servicios basados en Kubernetes, esto equivale a aplicar nuevos valores al gráfico de Helm del proveedor.

Para volver a configurar una instancia en ejecución de un paquete de software de Distributed Cloud Marketplace, sigue estos pasos:

1. En el selector de proyectos de la consola de GDC, selecciona el proyecto en el que deseas actualizar el paquete de software.
2. En la página de Distributed Cloud Marketplace, visita la página de la ficha del producto que quieres actualizar.
3. Haz clic en la pestaña Administración.
4. Haz clic en Archivo de configuración para la instancia que quieres volver a configurar.
5. En el panel que se abre, ingresa tus parámetros personalizados según la documentación del proveedor.
6. Haz clic en Guardar para aplicar los parámetros nuevos. La reconfiguración se completa en unos minutos.

Actualiza un paquete de software de Distributed Cloud Marketplace

Advertencia: Si bien puedes activar la actualización de un paquete de software con el mercado de Distributed Cloud, el proceso de actualización lo implementa el proveedor que publicó el producto. Por lo tanto, el proceso de actualización varía de un paquete de software a otro. Te recomendamos que revises detenidamente las notas de la versión y la documentación de actualización del proveedor correspondiente antes de continuar con la actualización. Según cómo el proveedor haya implementado su proceso de actualización, es posible que experimentes tiempo de inactividad en el servicio entregado o problemas de compatibilidad entre las versiones anteriores y las más recientes.

Algunos paquetes de software de Distributed Cloud Marketplace se pueden actualizar a una versión nueva a través de Google Distributed Cloud Marketplace después de que el operador de infraestructura ponga esas versiones nuevas a tu disposición.

Para actualizar un paquete de software de Distributed Cloud Marketplace, sigue estos pasos:

1. En el selector de proyectos de la consola de GDC, selecciona el proyecto en el que deseas actualizar el paquete de software.
2. En la página de Distributed Cloud Marketplace, visita la página de la ficha del producto que quieres actualizar.
3. Haz clic en la pestaña Administración.
4. Haz clic en Actualizar en la instancia que deseas actualizar. La actualización se completará en unos minutos.

Nota: Cuando actualizas un paquete de software a través de la consola de Distributed Cloud, se instala la siguiente versión disponible del software. Si hay varias versiones nuevas del software disponibles, debes repetir el proceso para cada una de ellas. Si es necesario, usa la API de Marketplace para actualizar a una versión específica.

Desinstala un paquete de software de Distributed Cloud Marketplace

Advertencia: Desinstalar un paquete de software de Distributed Cloud Marketplace es una acción destructiva y puede provocar la pérdida de datos o el tiempo de inactividad de los sistemas que dependen de este software. Antes de continuar, asegúrate de haber creado una copia de seguridad de todos los datos importantes y de que ningún sistema importante dependa del software que quieres desinstalar. Consulta la documentación del proveedor correspondiente para obtener información sobre cómo crear una copia de seguridad de los datos que administra su software.

Para desinstalar un paquete de software de Distributed Cloud Marketplace, completa los siguientes pasos:

1. En el selector de proyectos de la consola de GDC, selecciona el proyecto del que deseas desinstalar el paquete de software.
2. En la página de Distributed Cloud Marketplace, visita la página de ficha del producto que quieres desinstalar.
3. Haz clic en la pestaña Administración.
4. Haz clic en Desinstalar en la instancia que quieras desinstalar. El paquete de software se desinstalará en unos minutos.