Si decides admitir la implementación con Deployment Manager en tu producto de máquina virtual, debes completar los pasos que se indican a continuación.
Determinar cómo crear un paquete de despliegue
Te recomendamos que uses la opción de configuración guiada del Portal para productores para crear tu paquete de implementación directamente en la Google Cloud consola.
La configuración guiada admite productos de máquinas virtuales sencillos, como implementaciones de una sola máquina virtual con reglas de firewall básicas, pero no admite algunas funciones complejas, como las implementaciones con varias máquinas virtuales y los campos de configuración personalizados. Si necesitas funciones que no admite la configuración guiada, puedes usar la herramienta de código abierto mpdev
para crear tu paquete de implementación o personalizar uno ya creado añadiéndole funciones adicionales.
No recomendamos usar plantillas de implementación personalizadas que hayas creado sin usar la consola de Google Cloud ni la herramienta Autogen de Deployment Manager con Cloud Marketplace. Te recomendamos que crees tu paquete de implementación directamente en la Google Cloud consola.
Cambiar entre la configuración guiada y la manual
Si usas la opción de configuración guiada del portal para productores y, más adelante, quieres cambiar a la configuración manual de tu paquete de implementación, haz clic en Ir a configuración manual.
Cuando cambies, podrás descargar la especificación de Autogen del paquete de implementación que hayas creado en la configuración guiada para usarla como base de tu configuración manual.
Completar la configuración guiada
Para terminar de configurar y enviar un paquete de implementación sencillo mediante la consolaGoogle Cloud , sigue estos pasos:
En el portal Producer, ve a la sección Paquete de implementación.
En Configuración de Deployment Manager, junto al campo de entrada Contenedor de Cloud Storage, haz clic en Examinar.
Si ya has creado un segmento de Cloud Storage, selecciónalo aquí.
Si no tienes ningún segmento de Cloud Storage, haz clic en el icono Crear segmento. Cuando creas un nuevo segmento, puedes hacer lo siguiente:
- Selecciona un nombre para el segmento.
- Especifica en qué región o regiones se almacenan los datos del segmento.
- Especifica la clase de almacenamiento de tus datos.
- Determina el nivel de granularidad que se aplicará a los permisos de gestión de identidades y accesos (IAM) de los datos del segmento.
- Configura los ajustes avanzados opcionales, como el cifrado o las políticas de conservación de datos.
Habilita la gestión de versiones de objetos en tu segmento de Cloud Storage.
Para guardar los ajustes del segmento y seguir configurando el paquete de implementación, haga 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 máquina virtual, así como el tamaño y el tipo de su disco de arranque.
En Especificar sistema operativo, debe indicar el nombre y la versión del SO que usa la imagen de VM, así como el número de versión de la imagen de VM.
En Configurar acceso a la VM, puedes especificar las URLs del sitio y del administrador, así como un nombre de usuario y una contraseña que los usuarios podrán usar para acceder a la VM después de la implementación.
Opcionalmente, en Configurar red, puede especificar los ajustes de Reenvío de IP y configurar las reglas del Cortafuegos.
Opcionalmente, en Define next steps (Define los pasos siguientes), puedes proporcionar instrucciones a los usuarios de tu producto para guiarlos en los primeros pasos. Estas instrucciones se mostrarán a los clientes después de que implementen tu producto.
Después de completar los pasos anteriores, haga clic en Generar para crear el paquete de implementación.
Si necesitas hacer más cambios en el paquete de implementación más adelante, puedes hacer clic en Editar para modificarlo y, a continuación, en Generar para volver a generar el paquete de implementación con los cambios aplicados.
Si tiene previsto cambiar a la configuración manual, puede hacer clic en Descargar para descargar la especificación de Autogen del paquete de implementación que ha creado en la configuración guiada y usarla como base para la configuración manual.
Envía el paquete de implementación a revisión en Producer Portal. Una vez que hayas enviado 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
para generar las plantillas de Deployment Manager de tu paquete de implementación. La herramienta genera el paquete de despliegue a partir de una especificación de Autogen que contiene las entradas de configuración de tu producto de VM.
A grandes rasgos, para generar y enviar tu paquete de implementación, debes hacer lo siguiente:
- Crea y configura un segmento de Cloud Storage para almacenar y gestionar el acceso al paquete de implementación.
- Crea una especificación Autogen que incluya los detalles de la imagen y los requisitos de implementación de tu producto de máquina virtual.
- Genera el paquete de implementación a partir de tu especificación de Autogen y sube el paquete al segmento de Cloud Storage.
- Envía el paquete de implementación a revisión en el portal del productor. 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 el paquete de implementación.
Antes de empezar
Si usas mpdev
para crear tu paquete de implementación, sigue estos pasos:
Instala la herramienta
mpdev
siguiendo las instrucciones del repositoriomarketplace-tools
.Descarga el SDK de Google Cloud.
Crea tu segmento de Cloud Storage
Debes crear el segmento de Cloud Storage en el mismo Google Cloud proyecto público que usas para el Portal del Productor y configurar el segmento de las siguientes formas:
- Habilita la gestión de versiones de objetos en el segmento para proteger tu paquete de implementación de eliminaciones o sobrescrituras.
- Asigna el rol Lector de objetos de Storage (
roles/storage.objectViewer
) acloud-commerce-marketplace-onboarding@twosync-src.google.com
.
Para crear y configurar un segmento 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 le asignas al nuevo segmento, sujeto a los requisitos de nomenclatura.
Crear tu especificación de Autogen
Para crear tu especificación de Autogen, te recomendamos que uses el archivo single
VM example
del repositorio marketplace-tools
como especificación inicial de Autogen y, a continuación, personalices la especificación con los detalles de configuración de tu VM.
En casos prácticos más complejos, puedes configurar la función de autocompletar en algunos entornos de desarrollo integrados (IDEs)
para editar y validar archivos configurations.yaml
.
Para crear tu especificación de Autogen desde la single VM example
, sigue estos pasos:
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
.Actualiza la especificación con los detalles de configuración de tu VM modificando el archivo
configurations.yaml
con la siguiente información:- El nombre de la imagen de VM.
- El
ID
del proyecto público Google Cloud que aloja tu imagen de VM, que es el mismo proyecto que usas en Producer Portal.
Para saber cómo actualizar los campos de imagen de VM y de proyecto en el archivo Google Cloud , consulta el archivo
README.md
desingle VM example
.configurations.yaml
Si es necesario para tu producto, personaliza otros campos, como
passwords
,deployInput
ypostDeploy
. Estos campos se encuentran en la secciónDeploymentSpec
del archivoconfigurations.yaml
. Para obtener más información sobre los campos que se pueden personalizar, consulte la documentación de referencia de Autogen.
Generar el paquete de implementación
Una vez que hayas creado y personalizado la especificación de Autogen, úsala para generar los archivos de plantilla de Deployment Manager de tu paquete de implementación. Para almacenar el paquete, súbelo al segmento de Cloud Storage.
Para generar y subir tu paquete de implementación, sigue estos pasos:
Define la ubicación de salida del paquete de implementación en tu segmento de Cloud Storage:
mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
Donde BUCKET_NAME es el nombre del segmento que has creado para el paquete y OBJECT es el nombre que le asignas al objeto de Cloud Storage, sujeto a las directrices de nomenclatura.
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 contenedor.
Para verificar que ha configurado la plantilla correctamente, cree 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
Enviar un paquete de despliegue a revisión en Producer Portal
Una vez que hayas creado y configurado tu paquete de implementación, debes enviarlo al Portal para Productores para que el equipo de Cloud Marketplace pueda revisarlo y aprobarlo.
En el portal Producer, ve a la sección Paquete de implementación.
En Especifica la ubicación del objeto de Cloud Storage, selecciona el objeto del paquete de implementación que has subido anteriormente.
Haz clic en Validar. El proceso de validación puede tardar hasta dos horas en completarse. Puedes salir de la pantalla mientras se completa.
Una vez que el portal del productor haya leído correctamente el paquete de implementación, puede hacer clic en Vista previa de la implementación para ver cómo ve el cliente la configuración de su máquina virtual.
Una vez que se haya completado la validación, haga clic en Enviar para enviar el paquete de implementación a revisión. Una vez que hayas enviado el paquete, Google puede tardar hasta dos semanas en revisarlo y aprobarlo.