Cómo configurar componentes técnicos

En esta página, se describe cómo crear los componentes técnicos clave necesarios para distribuir tu producto de imagen de contenedor con Google Cloud Marketplace.

Si tienes preguntas durante el proceso de integración, comunícate con tu Ingeniero socio de Cloud Marketplace. Si no sabes quién es tu Ingeniero socio asignado, usa Partner Support Desk para solicitar asistencia y, además, incluye la palabra “Marketplace” en tu descripción. Para obtener más información sobre Partner Support Desk, consulta Solicita asistencia con Cloud Marketplace.

Configuración de IAM y de Artifact Registry

Antes de crear tu producto en Producer Portal, debes crear un repositorio de Artifact Registry de etapa de pruebas y enviar las imágenes que deseas distribuir en tu producto a ese repositorio. En tu proyecto, debes otorgar la función de Editor del proyecto a [e-mail].

Comienza a usar Container Registry

Para enviar imágenes de contenedor etiquetadas a Container Registry, sigue los pasos que se indican en Antes de comenzar en la documentación de Artifact Registry. Luego, sigue los pasos a continuación para habilitar la API de Artifact Analysis.

Para socios de VM existentes: El repositorio de etapa de pruebas de Artifact Registry se puede encontrar dentro de tu proyecto de desarrollo y no en tu proyecto público.

Después de instalar gcloud y Docker, debes habilitar las siguientes APIs desde la página Biblioteca de APIs:

• API de Artifact Registry
• API de Artifact Analysis

La API de Artifact Registry te permite enviar contenido a Artifact Registry, y la API de Artifact Analysis permite el análisis de seguridad.

Si tienes problemas para acceder a cualquiera de estas API, comunícate con tu Ingeniero socio.

Etiqueta y envía imágenes

1. Elige la ruta de acceso al repositorio de etapa de pruebas de Artifact Registry. Se recomienda que el repositorio respete la estructura us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

   • El repositorio de etapa de pruebas debe estar en us-docker.pkg.dev o gcr.io (otras regiones, como europe-docker.pkg.dev o eu.gcr.io, aún no se admiten).
   • Guarda o copia la ruta de acceso del repositorio de etapa de pruebas para crear productos en Producer Portal.

2. Compila la imagen que deseas enviar a tu repositorio de etapa de pruebas de Artifact Registryy.

3. Etiqueta la imagen a través de Docker con latest.

   docker tag image_name staging_repo_path:tag

   Por ejemplo: docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest

   Ten en cuenta que la imagen con la etiqueta latest se extrae si un usuario no especifica una.

4. Envía tu imagen con gcloud:

   gcloud docker push staging_repo_path:tag

5. Repite el proceso con cualquier etiqueta o imagen adicional que desees agregar a tu repositorio de etapa de pruebas. Una sola imagen puede tener varias etiquetas.

   • Recuerda que enviar una imagen a tu repositorio de etapa de pruebas no hace que sea visible para los usuarios de forma automática. Esto solo sucede con las imágenes de las etiquetas que seleccionas, después de su publicación.
   • El alcance de un repositorio es el nivel único de la carpeta que su ruta especifica. Una imagen que se encuentra dentro de otra carpeta en el repositorio no está realmente en el repositorio. En otras palabras, si una imagen está en us-docker.pkg.dev/testpartner/testsolution/1.0, NO está en el repositorio us-docker.pkg.dev/testpartner/testsolution. us-docker.pkg.dev/testpartner/testsolution/1.0 es un repositorio independiente.

Crea tu producto en Producer Portal

En esta sección, se describe cómo crear y publicar tu producto de imagen de contenedor en Producer Portal.

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

• Detalles del producto: Agrega información de marketing y de la ficha de tu producto.
• Imágenes de contenedor: Proporciona el repositorio de Google Container Registry que incluye tus imágenes de contenedor.

Puedes enviar estas opiniones en cualquier momento y en cualquier orden.

Sigue estos pasos para crear la entrada de Cloud Marketplace de tu producto:

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 Partner Support Desk para solicitar asistencia y, luego, incluye la palabra "Marketplace" en tu descripción. Para obtener más información sobre Partner Support Desk, visita Solicita asistencia con Cloud Marketplace.

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

3. Selecciona Imagen de contenedor.

4. En Nombre del producto, asigna un nombre al 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 del producto y el tipo de producto no se pueden cambiar después de crear el producto. Puedes cambiar el nombre del producto antes de enviarlo.

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

Agrega detalles del producto

Los detalles del producto incluyen la ficha de producto en Cloud Marketplace, la información de marketing y los vínculos a la documentación.

Sigue estos pasos para agregar los detalles de tus productos:

1. En la lista de productos, haz clic en el ID del producto.

2. En la página Descripción general del producto, ve a Detalles del producto y haz clic en Editar.

3. Completa la pestaña INFORMACIÓN DE PRODUCTOS de la sección Detalles del producto. Mientras se completaINFORMACIÓN DEL PRODUCTO, puede agregar ID de categoría. Los IDs de categoría permiten que los clientes encuentren tu producto en categorías o filtros seleccionados mientras buscan en Cloud Marketplace.

4. Para agregar instructivos, documentación y, de forma opcional, contratos de licencias adicionales, completa la pestaña de DOCUMENTACIÓN de la sección Detalles del producto. Tu documentación debe cumplir con los requisitos de las guías del usuario.

5. Para agregar metadatos de búsqueda o palabras clave, o personalizar la URL de la página de detalles de tu producto, completa la pestaña METADATOS DEL PRODUCTO de la sección Detalles del producto.

6. Cuando estés listo para enviar los detalles del producto a fin de procesarlos, haz clic en Enviar.

El equipo de Ingeniería de socios tarda de 2 a 5 días en revisar y aprobar los detalles del producto. Puedes empezar a editar los detalles ahora y enviar la revisión más tarde.

Agrega tus imágenes de contenedor

Debes crear una versión correspondiente a la etiqueta latest de Container Registry (distingue mayúsculas de minúsculas). Esta es la versión predeterminada en la página del producto.

Para agregar tus imágenes de contenedor, sigue estos pasos:

1. En la lista de productos, haz clic en el ID del producto.

2. En la página Descripción general de tu producto, ve a Imágenes de contenedor y haz clic en Editar.

3. En la sección Imágenes de contenedor, ingresa la URL de tu repositorio de Artifact Registry de etapa de pruebas.

4. Haz clic en Especificar versión. Es posible que tarde unos segundos en leer el repositorio y cargar tus etiquetas.

5. Selecciona la etiqueta de anuncio gráfico para la versión que quieras incluir en el producto. Debes incluir la versión latest en tu producto, pero puedes agregar versiones adicionales. Recomendamos limitar la cantidad de versiones disponibles para tu producto para la conveniencia de los usuarios.

6. De forma opcional, agrega el Título de la versión y una descripción breve de la versión. Esto ayuda a tus usuarios a implementar la versión que desean.

7. Ingresa el sistema operativo compatible con esta versión. Puedes especificar la versión del sistema operativo, si es necesario.

8. Después de agregar toda la información de la versión, haz clic en Listo.

9. Para agregar otra versión, haz clic en Agregar versión y, luego, ingresa la información de esa versión.

10. Cuando hayas terminado de agregar versiones compatibles a tu producto, haz clic en Guardar y validar. Las imágenes se copian en un repositorio público y, luego, ejecutamos una serie de pruebas.

11. Haz clic en Enviar (Submit) para enviar las imágenes de contenedor a revisión.

Obtén una vista previa de tu producto de imagen de contenedor

Para obtener una vista previa de tu ficha de Cloud Marketplace antes de que sea visible para los usuarios, sigue estos pasos:

1. En la lista de productos, haz clic en el ID del producto.

2. En la página Descripción general de tu producto, haz clic en Vista previa completa.

Si cambiaste alguna etiqueta en el repositorio de etapa de pruebas desde que validaste las imágenes de contenedor en Producer Portal, es posible que las imágenes a las que se hace referencia en la vista previa no sean precisas.

Publica tu producto de imagen de contenedor

Para publicar tu producto en Cloud Marketplace, debes hacer lo siguiente:

• Completa las revisiones de Detalles del producto e Imágenes de contenedor.

• Tener la aprobación como socio de Google Cloud Build

Después de que se aprueben todas las revisiones, puedes publicar y lanzar el producto en unos minutos. Para hacerlo, sigue estos pasos:

1. En la lista de productos, haz clic en el ID del producto.

2. En la página Descripción general de tu producto, haz clic en Publicar.