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

Si adecuar 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 hacer lo siguiente: crear tu paquete de implementación directamente en la consola de Google Cloud.

La configuración guiada admite productos de VM simples, como una VM única Deployment con reglas básicas de firewall, pero no es compatible con algunas como implementaciones con VMs múltiples y parámetros . Si necesitas funciones que no admite la configuración guiada, puedes usar el herramienta de código abierto mpdev para crear tu paquete de implementación o personalizar uno existente agregándole 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.

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

Si usas la opción de configuración guiada de Producer Portal y más adelante quieres cambia a la configuración manual del paquete de implementación, haz clic Ve 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 usando el comando En la consola de Google Cloud, completa los siguientes pasos:

  1. En Producer Portal, ve a la sección Deployment package (Paquete de implementación).

  2. 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 Crea un bucket nuevo. Cuando creas un bucket nuevo, tienes las siguientes opciones:

    • Selecciona un nombre para el bucket.
    • Especifica en qué región o regiones se almacenan los datos del bucket.
    • Especifica la clase de almacenamiento para tus datos.
    • Determina qué nivel de detalle aplicar al 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.
  3. Asegúrate de Habilita el control de versiones de objetos para tu bucket de Cloud Storage.

  4. Para guardar la configuración del bucket y continuar con la configuración de la implementación haz clic en Configure.

  5. En Elige el tipo de máquina, debes especificar una zona predeterminada. Tipo de máquina mínimo y Tipo de máquina predeterminado para tu VM junto con el tamaño y tipo de su disco de arranque.

  6. En Especifica el 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 VM imagen.

  7. De manera opcional, en Configura el acceso a la VM, puedes especificar el sitio y el administrador. las URLs, junto con un nombre de usuario y una contraseña, que los usuarios pueden usar para acceder la VM después de la implementación.

  8. De forma opcional, en Configurar redes, puedes especificar la configuración de reenvío de IP y configurar reglas de firewall.

  9. De manera opcional, en Definir los próximos pasos, puedes proporcionar instrucciones para lo siguiente: los usuarios de tu producto para guiarlos sobre cómo empezar a usar tu producto. Ellos podrán ver estas instrucciones después de implementar tu producto.

  10. Después de completar los pasos anteriores, haz clic en Generate para crear tu 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 y vuelve 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 de implementación que creaste en la configuración guiada para usarlo como de base para la configuración manual.

  11. Envía el paquete de implementación para su revisión en Producer Portal. Después de enviar el paquete, puede tardar hasta dos semanas para que Google revise y apruebe el paquete.

Completa la configuración manual

En esta sección, se explica cómo usar la herramienta de mpdev para crear un paquete de implementación y enviar el paquete 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 basado en una API de Autogen que contiene las entradas de configuración para tu producto de VM.

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

  1. Crea y configura un bucket de Cloud Storage para almacenar y administrar el acceso al paquete de implementación.
  2. Crea una especificación de Autogen que incluya lo siguiente: los detalles de la imagen y los requisitos de implementación para tu producto de VM.
  3. Genera el paquete de implementación basado en tu Autogen y sube el paquete al bucket de Cloud Storage.
  4. Envía el paquete de implementación para su revisión en Producer Portal Después de enviar el paquete, puede tardar hasta dos semanas para que Google revise y apruebe el paquete.

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:

  1. Instala la herramienta de mpdev. Para ello, sigue las instrucciones del repositorio marketplace-tools.

  2. 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 configurar el bucket de las siguientes maneras:

Para crear y configurar un bucket de Cloud Storage, ejecuta el siguiente comando: 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 nuevo bucket, 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.

Para casos de uso más complejos, puedes configurar el autocompletado en algunas aplicaciones integradas de desarrollo de software (IDE) para ayudar a editar y validar archivos configurations.yaml.

Para crear la especificación de Autogen a partir de single VM example, sigue estos pasos:

  1. Consulta la especificación de Autogen preconfigurada de ejemplo en una instancia directorio:

    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 para el directorio local. Por ejemplo, my-deployment-package

  2. Actualiza la especificación con los detalles de configuración de tu VM. Para ello, haz lo siguiente: Modifica el 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.

    Sigue estos pasos para actualizar los campos de la imagen de VM y del proyecto de Google Cloud en la configurations.yaml (consulta el README.md de single VM example) .

  3. Si es necesario para tu producto, personaliza los campos adicionales, como los siguientes: passwords, deployInput y postDeploy. Estos campos se encuentran en 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 para generar archivos de plantillas de Deployment Manager para tu paquete de implementación. Para almacenar el paquete, súbelo al archivo bucket de Cloud Storage.

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

  1. Establece la ubicación de salida para el paquete de implementación en Cloud Storage bucket:

    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.

  2. 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 enviar el paquete a Producer Portal para que el equipo de Cloud Marketplace pueda revisarlo y aprobar el paquete.

  1. En Producer Portal, ve a la sección Paquete de implementación.

  2. En Especificar la ubicación del objeto de Cloud Storage, selecciona la implementación de paquete que subiste anteriormente.

  3. Haz clic en Validate. El proceso de validación puede tardar hasta dos horas que se complete y podrás salir de la pantalla mientras esté completando el proceso.

  4. Después de que Producer Portal haya leído con éxito tu paquete de implementación, podrás Puedes hacer clic en Vista previa de la implementación para Ver cómo el cliente ve la configuración de tu VM.

  5. Una vez que la validación se complete correctamente, envía la implementación para su revisión, haz clic en Enviar. Después de que envíes el paquete, es posible que Google tardará hasta dos semanas en revisar y aprobar el paquete.