Configurar los componentes técnicos

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

Si tienes alguna pregunta durante el proceso de incorporación, habla con tu ingeniero de partners de Cloud Marketplace. Si no sabes quién es tu ingeniero de partners asignado, utiliza el servicio de asistencia para partners para solicitar ayuda e incluye la palabra "Marketplace" en tu descripción. Para obtener más información sobre el servicio de asistencia para partners, consulta el artículo Solicitar asistencia con Cloud Marketplace.

Configuración de Artifact Registry y gestión de identidades y accesos

Antes de crear tu producto en Producer Portal, debes crear un repositorio de Artifact Registry de staging y enviar las imágenes que quieras distribuir en tu producto a ese repositorio. En tu proyecto, debes asignar el rol Editor del proyecto a cloud-commerce-marketplace-onboarding@twosync-src.google.com.

Primeros pasos con Container Registry

Para enviar imágenes de contenedor etiquetadas a Container Registry, sigue los pasos de la sección Antes de empezar de la documentación de Artifact Registry. A continuación, sigue los pasos que se indican más abajo para habilitar la API Artifact Analysis.

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

• API de Artifact Registry
• API Artifact Analysis

La API de Artifact Registry te permite enviar contenido a Artifact Registry, mientras que la API de Artifact Analysis permite realizar análisis de seguridad.

Si tienes problemas para acceder a alguna de estas APIs, ponte en contacto con tu ingeniero de partners.

Etiquetar e insertar imágenes

1. Elige la ruta del repositorio de almacenamiento temporal de Artifact Registry. Te recomendamos que tu repositorio siga la estructura us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

   • El repositorio de staging 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 del repositorio de staging para crear el producto en Producer Portal.

2. Crea la imagen que quieras enviar al repositorio de almacenamiento temporal de Artifact Registry.

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 se extraerá la imagen etiquetada como latest si un usuario no especifica una etiqueta.

4. Envía la imagen con gcloud:

   gcloud docker push staging_repo_path:tag

5. Repite el proceso con las etiquetas o imágenes que quieras añadir al repositorio de staging. Una imagen puede tener varias etiquetas.

   • Recuerda que, al enviar una imagen a tu repositorio de staging, no se mostrará automáticamente a los usuarios. Esto solo ocurre con las imágenes de las etiquetas que selecciones, una vez que se hayan publicado.
   • El ámbito de un repositorio es el nivel único de la carpeta que especifica su ruta. Las imágenes que se encuentran en otra carpeta del repositorio no están en el repositorio en sí. Es decir, 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.

Crear un producto en Producer Portal

En esta sección se describe cómo crear y publicar su producto de imagen de contenedor en el portal del productor.

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.
• Imágenes de contenedor: proporciona el repositorio de Google Container Registry que incluye tus imágenes de contenedor.

Puedes enviar estas reseñas en cualquier momento y en cualquier orden.

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 Imagen de contenedor.

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.

Añadir detalles del producto

Los detalles del producto incluyen la ficha de su producto en Cloud Marketplace, información de marketing y enlaces a la documentación.

Para añadir los detalles de los productos, siga estos pasos:

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

2. En la página Visión general del producto, vaya a Detalles del producto y haga clic en Editar.

3. Rellena la pestaña INFORMACIÓN DEL PRODUCTO de la sección Detalles del producto. Mientras rellena la sección INFORMACIÓN DEL PRODUCTO, puede añadir IDs de categoría. Los IDs de categoría permiten que los clientes encuentren su producto en determinadas categorías o filtros cuando busquen en Cloud Marketplace.

4. Para añadir tutoriales, documentación y, opcionalmente, otros contratos de licencia, completa la pestaña DOCUMENTACIÓN de la sección Detalles del producto. Tu documentación debe cumplir los requisitos de las guías de usuario.

5. Para añadir metadatos o palabras clave de búsqueda, o bien para personalizar la URL de la página de detalles de su producto, vaya a la pestaña METADATOS DEL PRODUCTO de la sección Detalles del producto.

6. Cuando esté todo listo para que procesemos los detalles del producto, haz clic en Enviar.

El equipo de Ingeniería de Partners tarda entre 2 y 5 días en revisar y aprobar los detalles de tu producto. Puedes empezar a editar los detalles ahora y enviar la reseña más adelante.

Añadir imágenes de contenedor

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

Para añadir tus imágenes de contenedor, sigue estos pasos:

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

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

3. En la sección Imágenes de contenedor, introduzca la URL de su repositorio de staging de Artifact Registry.

4. Haz clic en Especificar retirada. Puede que tarde unos segundos en leer el repositorio y cargar tus etiquetas.

5. Seleccione la etiqueta de visualización de la versión que quiera incluir en su producto. Debes incluir la versión latest en tu producto, pero puedes añadir versiones adicionales. Te recomendamos que limites el número de versiones disponibles de tu producto para que los usuarios puedan acceder a ellas más fácilmente.

6. También puedes añadir un título de la versión y una breve descripción del lanzamiento. De esta forma, los usuarios pueden implementar la versión que quieran.

7. Introduce el sistema operativo que admite esta versión. Si es necesario, puedes especificar la versión del sistema operativo.

8. Una vez que hayas añadido toda la información de la versión, haz clic en Hecho.

9. Para añadir otra versión, haz clic en Añadir versión e introduce la información correspondiente.

10. Cuando haya terminado de añadir las versiones compatibles a su producto, haga clic en Guardar y validar. Las imágenes se copian en un repositorio público y, a continuación, se someten a una serie de pruebas.

11. Haga clic en Enviar para enviar las imágenes de contenedor a revisión.

Previsualizar un producto de imagen de contenedor

Para ver 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, haga clic en el ID del producto.

2. En la página Información general de su producto, haga clic en Vista previa completa.

Si has cambiado alguna etiqueta en tu repositorio de staging desde que validaste tus 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.

Publicar un producto de imagen de contenedor

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

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

• Recibir la aprobación para convertirte en Google Cloud partner de desarrollo.

Una vez que se hayan aprobado todas las reseñas, podrás publicar y lanzar el producto en cuestión de minutos. Para publicar su producto, siga estos pasos:

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

2. En la página Información general de su producto, haga clic en Publicar.