Configura tu entorno de Google Cloud

En esta página, se describen los pasos para configurar tu entorno de Google Cloud, de modo que puedas distribuir tus apps de Kubernetes.

Crea tu espacio de trabajo

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

Para administrar los productos que envías a Cloud Marketplace, te recomendamos que crees un proyecto nuevo con un ID del proyecto que termine en -public. Si deseas crear un proyecto para tus productos, consulta Crea y administra proyectos.

Si ya tienes un proyecto configurado para vender en Cloud Marketplace que quieres usar, verifica que los roles de Identity and Access Management (IAM) se otorguen correctamente para Kubernetes y ve a Configura un registro de contenedores.

Otorga roles para tu proyecto

Para terminar de configurar tu proyecto, completa los siguientes pasos:

1. Después de crear el proyecto, otorga los siguientes roles a nivel del proyecto:

   • Editor del proyecto, a [e-mail]
   • Administrador de Service Management (roles/servicemanagement.serviceAdmin), a [e-mail] y [e-mail]
   • Editor de configuración (roles/servicemanagement.configEditor), a [e-mail]

   Para otorgar acceso a tu proyecto, consulta Otorga, cambia y revoca el acceso a recursos.

2. Otorga los siguientes roles a nivel del servicio a [e-mail]:

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

   Si deseas conocer los pasos para otorgar acceso a nivel del servicio, consulta Cómo otorgar y revocar acceso a la API.

3. Establece un contacto de seguridad. Para obtener más información, consulta Administra contactos para notificaciones.

4. Completa el formulario de información del proyecto que te proporciona el equipo de Cloud Marketplace.

Configura un Container Registry

Necesitas un repositorio de Container Registry para alojar las imágenes de contenedor de tu app. Artifact Analysis analiza continuamente las imágenes de la app en busca de vulnerabilidades para que puedas revisar y abordar 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, otorga la función de visualizador de proyectos a [e-mail].

Habilita la API de Container Analysis

Debes habilitar la API de Artifact Analysis, que analiza las imágenes de los contenedores 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.

Agrega tu producto a Cloud Marketplace

Para crear y publicar tu producto en Cloud Marketplace, usa Producer Portal. El Ingeniero socio lo habilitará después de que completes el Formulario de información del proyecto de Cloud Marketplace.

Para publicar tu producto en Producer Portal, crea una entrada para él y, luego, envía la siguiente información para su revisión:

• Detalles del producto: Agrega información de marketing y fichas sobre tu producto.
• Precios: Elige y especifica tu modelo de precios para determinar cómo los clientes te pagarán por tu 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úrate de que tu producto cumpla con las políticas de Google para el software de código abierto.

Puedes enviar estas opiniones en cualquier momento y en cualquier orden. Algunas revisiones pueden tardar hasta dos semanas en aprobarse, por lo que te recomendamos que revises los requisitos y comiences lo antes posible.

Para crear la entrada de Cloud Marketplace de tu producto, haz lo siguiente:

1. Abre Producer Portal en la consola de Google Cloud:

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

   Reemplaza YOUR_PUBLIC_PROJECT_ID por el ID del proyecto público que creaste para Cloud Marketplace, por ejemplo, my-organization-public.

   Nota: Si no ves el vínculo o no puedes acceder a la URL, verifica si seleccionaste el proyecto correcto y si tienes la función de editor (roles/editor) para el proyecto. Si aún no puedes acceder a la URL, usa el Partner Support Desk para solicitar asistencia y, luego, incluye la palabra "Mercado" en la descripción. Para obtener más información sobre Partner Support Desk, consulta Cómo solicitar asistencia con Cloud Marketplace.

2. En la parte superior de la página, haz clic en Agregar producto.

3. Selecciona Kubernetes.

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

   Precaución: El ID y el tipo de producto no se pueden cambiar después de crear el producto. Puedes cambiar el nombre de tu producto antes de enviarlo.

5. Haga clic en Crear. La creación de tu producto puede tardar algunos segundos.

Agregarás tu modelo de precios y la información de marketing para tu solución en pasos posteriores.

Crea un clúster de desarrollo en Kubernetes Engine

Usa Google Kubernetes Engine para administrar y escalar los clústeres de Kubernetes. Para crear un clúster de prueba y, además, implementar una aplicación básica en él, sigue la Guía de inicio rápido del motor de Google Kubernetes.

Nota: Si no usas tu clúster para pruebas de forma activa, considera borrar el clúster. Si quieres mantener el clúster y ahorrar costos, puedes cambiar el tamaño del clúster y el número de nodos a cero. Si quieres obtener información sobre los pasos para cambiar el tamaño de tu clúster, consulta la documentación 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. Si bien no es necesario instalar mpdev con el fin de enviar una aplicación para el inicio, puedes ejecutar mpdev para verificar tu entorno de desarrollo y probar si tu aplicación se instala correctamente en tu clúster de desarrollo.

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

A fin de obtener información sobre el uso de mpdev para verificar el entorno y probar la aplicación, consulta la referencia de mpdev en GitHub.

Organiza tus versiones

En general, cada versión de tu aplicación debe adoptar el Control de versiones semánticas 2.0, que sigue la convención de numeración MAJOR.MINOR.PATCH. Cada versión debe tener un número de versión único, como 1.0.1, 1.0.2, 1.3.1, etcétera. De manera opcional, agrega un guion después del número de versión para agregar un modificador previo al lanzamiento, como 1.3.1-alpha201910. Los modificadores previos al lanzamiento se pueden usar para almacenar y destacar información adicional que te resulte útil, como la fecha de compilación que indica cuándo se crearon las versiones.

Te recomendamos que publiques su software en segmentos. Cada segmento es una serie de versiones con actualizaciones de retrocompatibilidad. Tus segmentos se deben basar en una versión secundaria, como 4.1.x. Como práctica recomendada, evita utilizar nombres de versión genéricos como latest.

Por ejemplo, si lanzas 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 versiones anteriores de 2.0, organiza estas versiones bajo el segmento 2.0.

Cuando publiques una versión de tu aplicación incompatible con versiones anteriores, o una versión que requiera que los usuarios realicen pasos de migración manual, lánzala en un segmento nuevo, para que los usuarios puedan planificar sus actualizaciones.

Elige los identificadores de tus productos

Debes seleccionar los siguientes identificadores para tu empresa, imágenes de contenedor y producto, que se utilizan con el fin de crear las URLs de Cloud Marketplace y los URI para tus imágenes de contenedor:

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

• El nombre de tu producto. Por ejemplo, si el nombre del producto es Example Pro, usa el identificador example-pro.

• El segmento del producto, como 4.0.

  Consulta los requisitos para organizar tus lanzamientos.

• Tus imágenes del contenedor. Selecciona un identificador único para cada imagen de contenedor en tu aplicación. Los siguientes identificadores son necesarios para todas las aplicaciones:

  • La imagen principal: esta imagen del contenedor es la imagen principal de tu producto y usa el mismo identificador que este. Por ejemplo, si el identificador de tu producto es example-pro, la imagen principal usa el mismo identificador.
  • deployer: la imagen del contenedor de implementación para el seguimiento. El contenedor de implementación se ejecuta cuando los usuarios implementan tu app desde la consola de Google Cloud. Cuando creas el paquete de tu app, creas una imagen de implementación.

Precaución: Los identificadores que seleccionas aparecen en las URL del producto y los URI de las imágenes de contenedor. Es difícil cambiar estos identificadores después de que tu producto se publica a los clientes de Cloud Marketplace.

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

	Nombre	Identificador
Empresa	Examplesoft Inc	examplesoft
Producto	Example Pro	example-pro
Imagen [1] (principal)	Example Pro server	No corresponde
Imagen [2]	Example Queue	example-queue
Imagen [deployer]	No corresponde	Deployer
Segmento [1]	Versión 4.x.x	4.0
Segmento [2]	Versión 5.x.x	5.0

Para estos identificadores, la información siguiente se genera de forma automática:

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

• Los URI de la imagen del 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