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

Si eliges 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 VM y campos de configuración personalizados. Si necesitas funciones que la configuración guiada no admite, puedes usar la herramienta mpdev de código abierto para crear tu paquete de implementación o agregar funciones adicionales a fin de personalizar un paquete existente.

No recomendamos usar las plantillas de implementación personalizadas que creaste sin usar la consola de Google Cloud o la herramienta Autogen de Deployment Manager con Cloud Marketplace. Te recomendamos crear el paquete de implementación directamente en la consola de Google Cloud.

Alterna entre la configuración guiada y la configuración manual

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

Cuando realices el cambio, puedes descargar la especificación de Autogen para el paquete de implementación que creaste en la configuración guiada a fin de usarla como base en la configuración manual.

Completa la configuración guiada

Para terminar de configurar y enviar un paquete de implementación simple con la consola 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 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 Crear bucket nuevo. Cuando creas un bucket nuevo, sucede lo siguiente:
- Selecciona un nombre para el bucket.
- Especifica en qué región o regiones el bucket almacena los datos.
- Especifica la clase de almacenamiento de tus datos.
- Determina qué nivel de detalle aplicar a los permisos de Identity and Access Management (IAM) para los datos del bucket.
- Establece 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 el bucket de Cloud Storage.
Para guardar la configuración del bucket y continuar con la configuración del paquete de implementación, haz clic en Configure (Configurar).
En Elegir el tipo de máquina, debes especificar una Zona predeterminada, un Tipo mínimo de máquina y un Tipo de máquina predeterminado para tu producto de VM, junto con el tamaño y el tipo de disco de arranque.
En Especificar sistema operativo, debes especificar el nombre y la versión del SO que usa tu imagen de VM, así como el número de versión de la imagen de VM.
De manera opcional, en Configura el acceso a las 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 manera opcional, en Configurar redes, puedes especificar la configuración del reenvío de IP y configurar las reglas de Firewall.
De manera opcional, en Define los próximos pasos, puedes proporcionar instrucciones a los usuarios de tu producto para guiarlos a comenzar a usarlo. Podrán ver estas instrucciones después de que implementen el producto.
Después de completar los pasos anteriores, haz clic en Generar para crear el paquete de implementación.

Si necesitas realizar cambios adicionales en tu paquete de implementación más adelante, puedes hacer clic en Editar para realizar cambios y, luego, en Generar para volver a generar tu 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 y usarla como base para la configuración manual.
Envía el paquete de implementación para su revisión en Producer Portal. Una vez que envíes 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 a revisión.

La herramienta mpdev usa Autogen de Deployment Manager a fin de generar las plantillas de Deployment Manager para tu paquete de implementación. La herramienta genera el paquete de implementación basado en una especificación de Autogen que contiene las entradas de configuración para el 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 para tu producto de VM.
Genera el paquete de implementación según la 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 enviar 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 los siguientes 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 Producer Portal y configurarlo de las siguientes maneras:

Habilita el control de versiones de objetos para el bucket a fin de proteger tu paquete de implementación y evitar que se borre o reemplace.
Otorga el rol Visualizador de objetos de Storage (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 de gsutil:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gsutil mb $BUCKET_NAME
  gsutil versioning set on gs://$BUCKET_NAME
  gsutil iam ch "group:cloud-commerce-marketplace-onboarding@twosync-src.google.com:objectViewer" $BUCKET_NAME

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

Crea la 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.

En casos de uso más complejos, puedes configurar el autocompletado en algunos entornos de desarrollo integrados (IDEs) para ayudar a 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
```
En el ejemplo anterior, YOUR_PACKAGE_NAME es el nombre que proporcionas para el directorio local. Por ejemplo, my-deployment-package
Actualiza la especificación con los detalles de configuración de la VM mediante la modificación del archivo configurations.yaml con la siguiente información:
- El nombre de tu imagen de VM.
- El ID para el proyecto público de Google Cloud que aloja tu imagen de VM, que es el mismo proyecto que usas para Producer Portal.
Si deseas conocer los pasos para actualizar la imagen de 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 los campos adicionales, como passwords, deployInput y postDeploy. Estos campos se encuentran en DeploymentSpec, en el archivo configurations.yaml. Si quieres 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, úsala a fin de 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.

Sigue estos pasos para generar y subir tu paquete de implementación:

Establece la ubicación de la 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 la especificación de Autogen de forma manual, debes editar el archivo de especificación directamente para actualizar la ubicación de la 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 comprime y se sube a tu bucket.

Para verificar que configuraste la plantilla de forma correcta, crea una implementación con la ejecución del 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 enviar el paquete 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 implementación que subiste antes.
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 en Deployment Preview para ver cómo el cliente ve tu configuración de VM.
Una vez que la validación se complete con éxito, haz clic en Enviar para enviar el paquete de implementación a revisión. Después de enviar 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.