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:
En Producer Portal, ve a la sección Deployment package (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 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.
Asegúrate de Habilita el control de versiones de objetos para tu bucket de Cloud Storage.
Para guardar la configuración del bucket y continuar con la configuración de la implementación haz clic en Configure.
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.
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.
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.
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 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.
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.
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:
- 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 lo siguiente: los detalles de la imagen y los requisitos de implementación para tu producto de VM.
- Genera el paquete de implementación basado en tu Autogen y sube el paquete 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, 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:
Instala la herramienta de
mpdev
. Para ello, sigue las instrucciones del repositoriomarketplace-tools
.
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:
- Habilita el control de versiones de objetos para el bucket para evitar que se borre tu paquete de implementación se sobrescribirá.
- Otorga el Visualizador de objetos de Storage.
(
roles/storage.objectViewer
) paracloud-commerce-marketplace-onboarding@twosync-src.google.com
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:
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
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 elREADME.md
desingle VM example
) .Si es necesario para tu producto, personaliza los campos adicionales, como los siguientes:
passwords
,deployInput
ypostDeploy
. Estos campos se encuentran enDeploymentSpec
en el archivoconfigurations.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:
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.
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.
En Producer Portal, ve a la sección Paquete de implementación.
En Especificar la ubicación del objeto de Cloud Storage, selecciona la implementación de paquete que subiste anteriormente.
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.
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.
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.