Configurar tu entorno de Google Cloud

En esta página se describen los pasos que debes seguir para configurar tu Google Cloud entorno para poder distribuir tus aplicaciones de Kubernetes.

Crear un espacio de trabajo

Te recomendamos que crees un proyecto en la Google Cloud consola principalmente para tus productos de Cloud Marketplace.

Para gestionar los productos que envíe a Cloud Marketplace, le recomendamos que cree un proyecto con un ID que termine en -public. Para crear un proyecto para tus productos, consulta el artículo Crea y gestiona proyectos.

Si ya tienes un proyecto configurado para vender en Cloud Marketplace que quieres usar, comprueba que los roles de Gestión de Identidades y Accesos (IAM) se hayan concedido correctamente para Kubernetes y ve a la sección Configurar un registro de contenedores.

Conceder roles para tu proyecto

Para terminar de configurar el proyecto, sigue estos pasos:

1. Una vez que hayas creado el proyecto, concede los siguientes roles a nivel de proyecto:

   • Editor del proyecto, a cloud-commerce-marketplace-onboarding@twosync-src.google.com
   • Administrador de Service Management (roles/servicemanagement.serviceAdmin), a cloud-commerce-marketplace-onboarding@twosync-src.google.com y managed-services@cloud-marketplace.iam.gserviceaccount.com
   • Editor de configuración (roles/servicemanagement.configEditor) para cloud-commerce-producer@system.gserviceaccount.com

   Para conceder acceso a tu proyecto, consulta Conceder, cambiar y revocar el acceso a los recursos.

2. Concede los siguientes roles a nivel de servicio a cloud-commerce-procurement@system.gserviceaccount.com:

   • Consumidor de servicio (roles/servicemanagement.serviceConsumer)
   • Controlador de servicio (roles/servicemanagement.serviceController)

   Para saber cómo conceder acceso a nivel de servicio, consulta el artículo Conceder y revocar el acceso a la API.

3. Define un contacto de seguridad. Para obtener más información, consulta Gestionar contactos para las notificaciones.

4. Rellena el formulario de información del proyecto que te proporcione el equipo de Cloud Marketplace.

Configurar un registro de contenedores

Necesitas un repositorio de Container Registry para alojar las imágenes de contenedor de tu aplicación. Artifact Analysis analiza continuamente las imágenes de la aplicación para detectar vulnerabilidades, de modo que puedas revisar y solucionar los problemas antes de enviar tu producto a Cloud Marketplace.

Para configurar Container Registry, Docker y el SDK de Google Cloud , sigue la guía de inicio rápido de Container Registry.

Después de configurar Container Registry, en el proyecto que contiene tu registro, asigna el rol Lector de proyecto a cloud-commerce-marketplace-onboarding@twosync-src.google.com.

Habilitar la API Container Analysis

Debe habilitar la API Artifact Analysis, que analiza sus imágenes de contenedor en Container Registry en busca de vulnerabilidades. Para obtener una descripción general del análisis de vulnerabilidades en Artifact Analysis, consulta la documentación de Container Registry.

Añadir un producto a Cloud Marketplace

Para crear y publicar tu producto en Cloud Marketplace, debes usar Producer Portal. Tu ingeniero de partners lo habilitará después de que completes el formulario de información del proyecto de Cloud Marketplace.

Para publicar su producto en el Portal del Productor, debe crear una entrada para su producto y, a continuación, enviar la siguiente información para que se revise:

• Detalles del producto: añada información sobre la ficha y el marketing de su producto.
• Precios: elija y especifique su modelo de precios para determinar cómo le pagan los clientes por su producto.
• Imágenes de contenedor: proporciona el repositorio de Google Container Registry que incluye tus imágenes de contenedor.
• Cumplimiento de código abierto: asegúrese de que su producto cumpla las políticas de Google sobre software de código abierto.

Puedes enviar estas reseñas en cualquier momento y en cualquier orden. Algunas revisiones pueden tardar hasta dos semanas en aprobarse, por lo que le recomendamos que consulte los requisitos y empiece lo antes posible.

Para crear la ficha de tu producto en Cloud Marketplace, sigue estos pasos:

1. Abre el Portal para productores en la Google Cloud consola:

   https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
   

   Sustituye YOUR_PUBLIC_PROJECT_ID por el ID del proyecto público que has creado para Cloud Marketplace. Por ejemplo, my-organization-public.

2. En la parte superior de la página, haz clic en Añadir producto.

3. Selecciona Kubernetes.

4. En Nombre del producto, asigna un nombre al producto y comprueba el ID de producto. El ID de producto se usa en la URL de tu ficha de Cloud Marketplace.

5. Haz clic en Crear. El producto puede tardar unos segundos en crearse.

En los pasos posteriores, añadirás el modelo de precios y la información de marketing de tu solución.

Crear un clúster de desarrollo en Kubernetes Engine

Utilizas Google Kubernetes Engine para gestionar y escalar clústeres de Kubernetes. Para crear un clúster de prueba y desplegar una aplicación básica en él, sigue la guía de inicio rápido de Google Kubernetes Engine.

Instala la herramienta de desarrollo mpdev

La herramienta mpdev es un contenedor que agrupa utilidades para probar y publicar las imágenes de tu aplicación. Aunque no es necesario instalar mpdev para enviar una aplicación para su lanzamiento, puedes ejecutar mpdev para verificar tu entorno de desarrollo y comprobar si tu aplicación se instala correctamente en tu clúster de desarrollo.

Instala mpdev desde el repositorio de GitHub de herramientas de Cloud Marketplace.

Para obtener información sobre cómo usar mpdev para comprobar tu entorno y probar tu aplicación, consulta la referencia de mpdev en GitHub.

Organizar tus lanzamientos

Por lo general, todas las versiones de tu aplicación deben adoptar la versión semántica 2.0, que sigue la convención de numeración MAJOR.MINOR.PATCH. Cada versión debe tener un número único, como 1.0.1, 1.0.2, 1.3.1, etc. También puedes añadir un guion después del número de versión para añadir un modificador de versión preliminar, como 1.3.1-alpha201910. Los modificadores de versión preliminar se pueden usar para almacenar y destacar cualquier información adicional que te resulte útil, como las fechas de compilación que indican cuándo se crearon las versiones.

Te recomendamos que publiques tu software en pistas. Cada pista es una serie de versiones con actualizaciones retrocompatibles. Tus canales de lanzamiento deben basarse en una versión secundaria, como 4.1.x. Como práctica recomendada, no uses nombres de versión genéricos, como latest.

Por ejemplo, si vas a lanzar la versión 2.0 de tu software en Cloud Marketplace y esperas que las versiones 2.0.1, 2.0.5, etc., sean compatibles con la versión 2.0, organiza estos lanzamientos en la pista de lanzamiento 2.0.

Cuando publiques una versión de tu aplicación que no sea compatible con versiones anteriores o una versión que requiera que los usuarios sigan pasos de migración manuales, publícala en un nuevo canal para que los usuarios puedan planificar sus actualizaciones.

Elegir los identificadores de producto

Debe seleccionar los siguientes identificadores de su empresa, producto e imágenes de contenedor, que se utilizan para crear las URLs de Cloud Marketplace y los URIs de sus imágenes de contenedor:

• El nombre de tu empresa. Por ejemplo, si el nombre de tu empresa es Examplesoft Inc., puedes usar el identificador examplesoft.

• Nombre del producto. Por ejemplo, si el nombre del producto es Example Pro, use el identificador example-pro.

• El canal de lanzamiento de tu producto, como 4.0.

  Consulta los requisitos para organizar tus lanzamientos.

• Tus imágenes de contenedor. Selecciona un identificador único para cada imagen de contenedor de tu aplicación. Se requieren los siguientes identificadores para todas las aplicaciones:

  • Imagen principal: esta imagen de contenedor es la imagen principal de su producto y usa el mismo identificador que el producto. Por ejemplo, si el identificador de su producto es example-pro, la imagen principal utiliza el mismo identificador.
  • deployer: imagen del contenedor de implementación de la pista. El contenedor de implementación se ejecuta cuando los usuarios implementan tu aplicación desde la consola. Google Cloud Creas una imagen de implementación cuando crees el paquete de tu aplicación.

Por ejemplo, la empresa Examplesoft Inc. elige los siguientes identificadores para su producto, Example Pro:

	Nombre	Identificador
Empresa	Examplesoft Inc	examplesoft
Producto	Example Pro	example-pro
Imagen [1] (principal)	Servidor Pro de ejemplo	n/a
Imagen [2]	Cola de ejemplo	example-queue
Imagen [deployer]	n/a	Encargado de despliegues
Canal de lanzamiento [1]	Versión 4.x.x	4.0
Canal de lanzamiento [2]	Versión 5.x.x	5,0

En el caso de estos identificadores, se genera automáticamente la siguiente información:

• URL del producto en Cloud Marketplace: https://console.cloud.google.com/marketplace/details/examplesoft/example-pro

• Los URIs de las imágenes de contenedor:

  • marketplace.gcr.io/examplesoft/example-pro:4.0
  • marketplace.gcr.io/examplesoft/example-pro/example-queue:4.0
  • marketplace.gcr.io/examplesoft/example-pro/deployer:4.0
  • marketplace.gcr.io/examplesoft/example-pro:5.0
  • marketplace.gcr.io/examplesoft/example-pro/example-queue:5.0
  • marketplace.gcr.io/examplesoft/example-pro/deployer:5.0