Se usó la API de Cloud Translation para traducir esta página.

Configura tu imagen de VM para la implementación de Deployment Manager

Si decides admitir la implementación con Deployment Manager para tu producto de VM, debes completar los siguientes pasos.

Determina cómo crear tu paquete de implementación

Te recomendamos que uses la opción de configuración guiada de Producer Portal para crear tu paquete de implementación directamente en la consola de Google Cloud.

La configuración guiada admite productos de VM simples, como implementaciones de VM única con reglas básicas de firewall, pero no admite algunas funciones complejas, como implementaciones con varias VMs y campos de configuración personalizados. Si necesitas funciones que no admite la configuración guiada, puedes usar la herramienta mpdev de código abierto para crear tu paquete de implementación o personalizar uno existente agregando funciones adicionales.

No recomendamos usar plantillas de implementación personalizadas que hayas creado sin usar la consola de Google Cloud o la herramienta de generación automática de Deployment Manager con Cloud Marketplace. Te recomendamos que crees tu paquete de despliegue directamente en la consola de Google Cloud.

Cómo cambiar entre la configuración guiada y la configuración manual

Si usas la opción de configuración guiada de Producer Portal y, luego, deseas cambiar de forma manual a tu paquete de implementación, haz clic en Ir a la configuración manual.

Cuando cambies, podrás descargar la especificación de Autogen del paquete de implementación que creaste en la configuración guiada como base para la configuración manual.

Completa la configuración guiada

Para terminar de configurar y enviar un paquete de implementación simple con la console de Google Cloud, completa los siguientes pasos:

En Producer Portal, ve a la sección Paquete de implementación.
En Configuración de Deployment Manager, junto al campo de entrada etiquetado como Bucket de Cloud Storage, haz clic en Explorar.

Si ya creaste un bucket de Cloud Storage, selecciónalo aquí.

Si no tienes un bucket de Cloud Storage, haz clic en el ícono etiquetado como Create new bucket. Cuando creas un bucket nuevo, puedes hacer lo siguiente:
- Selecciona un nombre para el bucket.
- Especifica en qué regiones almacena datos el bucket.
- Especifica la clase de almacenamiento para tus datos.
- Determina qué nivel de detalle aplicar a los permisos de Identity and Access Management (IAM) para los datos del bucket.
- Configura la configuración avanzada opcional, como la encriptación o las políticas de retención de datos.
Asegúrate de habilitar el control de versiones de objetos para tu bucket de Cloud Storage.
Para guardar la configuración del bucket y continuar configurando tu paquete de despliegue, haz clic en Configurar.
En Elige el tipo de máquina, debes especificar una Zona predeterminada, un Tipo de máquina mínimo y un Tipo de máquina predeterminado para tu producto de VM, junto con el tamaño y el tipo de su disco de arranque.
En Especificar el sistema operativo, debes especificar el nombre y la versión del SO que usa la imagen de la VM, así como el número de versión de la imagen de la VM.
De manera opcional, en Configurar acceso a la VM, puedes especificar las URLs del sitio y del administrador, junto con un nombre de usuario y una contraseña, que los usuarios pueden usar para acceder a la VM después de la implementación.
De forma opcional, en Configurar redes, puedes especificar la configuración de reenvío de IP y configurar reglas de firewall.
De manera opcional, en Define los próximos pasos, puedes proporcionar instrucciones a los usuarios de tu producto para guiarlos en el proceso de comenzar a usarlo. Podrán ver estas instrucciones después de implementar tu producto.
Después de completar los pasos anteriores, haz clic en Generate para crear tu paquete de implementación.

Si necesitas realizar cambios adicionales en el paquete de implementación más adelante, puedes hacer clic en Editar para realizar cambios y, luego, en Generar para volver a generar el paquete de implementación con esos cambios aplicados.

Si planeas cambiar a la configuración manual, puedes hacer clic en Descargar para descargar la especificación de Autogen del paquete de implementación que creaste en la configuración guiada como base para la configuración manual.
Envía el paquete de implementación para su revisión en Producer Portal. Después de enviar el paquete, Google puede tardar hasta dos semanas en revisarlo y aprobarlo.

Completa la configuración manual

En esta sección, se explica cómo usar la herramienta mpdev para crear un paquete de implementación y enviarlo para su revisión.

La herramienta de mpdev usa Autogen de Deployment Manager para generar las plantillas de Deployment Manager para tu paquete de implementación. La herramienta genera el paquete de implementación según una especificación de Autogen que contiene las entradas de configuración de tu producto de VM.

En un nivel alto, para generar y enviar tu paquete de implementación, debes hacer lo siguiente:

Crea y configura un bucket de Cloud Storage para almacenar y administrar el acceso al paquete de implementación.
Crea una especificación de Autogen que incluya los detalles de la imagen y los requisitos de implementación de tu producto de VM.
Genera el paquete de implementación según tu especificación de Autogen y súbelo al bucket de Cloud Storage.
Envía el paquete de implementación para su revisión en Producer Portal. Después de que envíes el paquete, Google puede tardar hasta dos semanas en revisarlo y aprobarlo.

En las siguientes secciones, se explica cómo completar los pasos para generar y enviar tu paquete de implementación.

Antes de comenzar

Si usas mpdev para crear tu paquete de implementación, completa estos pasos:

Instala la herramienta de mpdev. Para ello, sigue las instrucciones del repositorio marketplace-tools.
Descarga el SDK de Google Cloud.

Crea tu bucket de Cloud Storage

Debes crear el bucket de Cloud Storage en el mismo proyecto público de Google Cloud que usas para el Producer Portal y configurarlo de las siguientes maneras:

Habilita el control de versiones de objetos para el bucket para proteger tu paquete de implementación de borrados o reemplazos.
Otorga el rol de Visualizador de objetos de almacenamiento (roles/storage.objectViewer) a cloud-commerce-marketplace-onboarding@twosync-src.google.com.

Para crear y configurar un bucket de Cloud Storage, ejecuta los siguientes comandos gcloud storage:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gcloud storage buckets create gs://$BUCKET_NAME
  gcloud storage buckets update gs://$BUCKET_NAME --versioning
  gcloud storage buckets add-iam-policy-binding gs://$BUCKET_NAME --member=group:cloud-commerce-marketplace-onboarding@twosync-src.google.com --role=roles/storage.objectViewer

Donde YOUR_BUCKET_NAME es el nombre que proporcionas para el bucket nuevo, sujeto a los requisitos de nomenclatura.

Crea tu especificación de Autogen

Para crear tu especificación de Autogen, te recomendamos que uses el single VM example del repositorio de marketplace-tools como tu especificación inicial de Autogen y, luego, personaliza la especificación con los detalles de la configuración de tu VM.

Para casos de uso más complejos, puedes configurar la función de autocompletar en algunos entornos de desarrollo integrados (IDE) para editar y validar archivos configurations.yaml.

Para crear tu especificación de Autogen a partir de single VM example, haz lo siguiente:

Consulta la especificación de Autogen preconfigurada del ejemplo en un directorio local:
```
PACKAGE=YOUR_PACKAGE_NAME
mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm $PACKAGE
```
Donde YOUR_PACKAGE_NAME es el nombre que proporcionas para el directorio local. Por ejemplo, my-deployment-package
Para actualizar la especificación con los detalles de configuración de tu VM, modifica el archivo configurations.yaml con la siguiente información:
- El nombre de la imagen de tu VM.
- El ID del proyecto público de Google Cloud que aloja tu imagen de VM, que es el mismo proyecto que usas para Producer Portal.
Para obtener pasos para actualizar la imagen de la VM y los campos del proyecto de Google Cloud en el archivo configurations.yaml, consulta el archivo README.md de single VM example.
Si es necesario para tu producto, personaliza campos adicionales, como passwords, deployInput y postDeploy. Estos campos se encuentran debajo de DeploymentSpec en el archivo configurations.yaml. Para obtener más información sobre los campos disponibles para la personalización, consulta la documentación de referencia de Autogen.

Genera tu paquete de implementación

Después de crear y personalizar la especificación de Autogen, usa la especificación para generar los archivos de plantilla de Deployment Manager para tu paquete de implementación. Para almacenar el paquete, súbelo al bucket de Cloud Storage.

Para generar y subir tu paquete de implementación, sigue estos pasos:

Establece la ubicación de salida del paquete de implementación en tu bucket de Cloud Storage:

Nota: Puedes usar el siguiente comando si usaste uno de los Autogen specification examples en el repositorio marketplace-tools. Si creaste tu especificación de Autogen de forma manual, debes editar el archivo de especificación directamente para actualizar la ubicación de salida.
```
mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
```
Donde BUCKET_NAME es el nombre del bucket que creaste para el paquete y OBJECT es el nombre que proporcionas para el objeto de Cloud Storage, sujeto a lineamientos para asignar nombres.

Genera el paquete de implementación:

mpdev apply -f $PACKAGE/configurations.yaml

El paquete de implementación generado se comprimirá y subirá a tu bucket.

Para verificar que configuraste la plantilla correctamente, crea una implementación ejecutando el siguiente comando:

  TMPDIR=$(mktemp -d)
  unzip $PACKAGE/template.zip -d $TMPDIR
  gcloud deployment-manager deployments create $PACKAGE --config $TMPDIR/test_config.yaml

Envía tu paquete de implementación para revisión en Producer Portal

Después de crear y configurar tu paquete de implementación, debes enviarlo a Producer Portal para que el equipo de Cloud Marketplace pueda revisarlo y aprobarlo.

En Producer Portal, ve a la sección Paquete de implementación.
En Especifica la ubicación de tu objeto de Cloud Storage, selecciona el objeto del paquete de despliegue que subiste anteriormente.
Haz clic en Validate. El proceso de validación puede tardar hasta dos horas en completarse, y puedes salir de la pantalla mientras se completa.
Una vez que Producer Portal haya leído correctamente tu paquete de implementación, puedes hacer clic enVista previa de la implementación para ver cómo el cliente ve la configuración de tu VM.
Una vez que se complete correctamente la validación, haz clic en Enviar para enviar el paquete de implementación a revisión. Después de que envíes el paquete, Google puede tardar hasta dos semanas en revisarlo y aprobarlo.

Configura tu imagen de VM para la implementación de Terraform

Comprende cómo los clientes ven tus paquetes de implementación