Crear tu paquete de implementación

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se describen los pasos para crear un paquete de implementación de tu producto de máquina virtual (VM). Debes crear y enviar el paquete de implementación para publicar tu producto en Google Cloud Marketplace.

Una implementación es un conjunto de recursos que se crean y administran juntos, como los recursos necesarios para tu producto. Un paquete de implementación es una especificación para un conjunto de recursos que generalmente se implementan juntos, lo que optimiza el proceso de implementación de ese producto en particular.

En esta guía, usarás Deployment Manager para crear tu paquete de implementación. Deployment Manager te permite crear paquetes de implementación para tus productos de VM mediante archivos de configuración YAML, JSON o ProtoText simples.

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 Google Cloud Console.

La configuración guiada admite productos de VM simples, como implementaciones de VM única con reglas de firewall básicas, pero no admite algunas características complejas, como implementaciones con varias VM y campos de configuración personalizados. Si necesitas características que no son compatibles con la configuración guiada, puedes usar la herramienta de código abierto mpdev para crear tu paquete de implementación o personalizar un paquete existente agregándole capacidades adicionales.

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

Si usas la opción de configuración guiada del portal productor y, luego, deseas cambiar de forma manual a tu paquete de implementación, puedes hacer clic en IR A LA CONFIGURACIÓN MANUAL para cambiar a la configuración manual.

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

Antes de comenzar

  1. Asegúrate de que tu implementación no use Terraform ni tenga dependencias.

  2. Si usas la herramienta de mpdev para crear tu paquete de implementación, completa los siguientes pasos:

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

Cree y envíe su paquete de implementación

En la siguiente sección, se explica cómo crear tu paquete de implementación y enviar el paquete a Google para su revisión.

Crea el paquete de implementación mediante uno de los siguientes métodos:

Crea un paquete de implementación con Google Cloud Console

Para crear y enviar un paquete de implementación simple con Google Cloud Console, sigue estos pasos:

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

  2. Selecciona la Configuración guiada para soluciones simples y haz clic en CONTINUAR.

  3. En la sección Configurar la especificación de Autogen, junto al campo de entrada etiquetado como Bucket de Cloud Storage, haz clic en BROWSE.

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

    Si no tienes un bucket de Cloud Storage, haz clic en el ícono Crear bucket nuevo. Cuando creas un bucket nuevo, sucede lo siguiente:

    • Selecciona un nombre para el bucket.
    • Especifica las regiones en las que el bucket almacena datos.
    • Especifica la clase de almacenamiento para tus datos.
    • Determinar el nivel de detalle que se aplicará a los permisos de Identity and Access Management (IAM) para los datos del bucket
    • Define una configuración avanzada opcional, como la encriptación o las políticas de retención de datos.
  4. Asegúrate de que el control de versiones de objetos esté habilitado para el bucket de Cloud Storage.

  5. Para guardar la configuración del bucket y comenzar a configurar el paquete de implementación, haz clic en CONFIGURAR.

  6. En Elige la imagen de tu producto, selecciona tu imagen de VM.

    La imagen de VM que selecciones debe ser de la siguiente manera:

    • Asociado con tu proyecto actual de Google Cloud.

    • Debe estar adjuntado a la licencia correcta de su producto. Crea y adjunta esta licencia cuando creas la imagen de VM.

  7. En Elegir tipo de máquina, debes especificar la Zona predeterminada, el Tipo mínimo de máquina y el Tipo de máquina predeterminado para tu producto de VM, junto con el tamaño y tipo de su disco de arranque.

  8. En Especificar sistema operativo, debes especificar 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.

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

  10. De manera opcional, en Configurar Herramientas de redes, puedes especificar la configuración de Reenvío de IP y las reglas de Firewall.

  11. De manera opcional, en Definir pasos siguientes, puedes proporcionar instrucciones para que los usuarios de tu producto guíen a los usuarios a fin de que comiencen a usar el producto. Podrán ver estas instrucciones después de que implementen tu producto.

  12. Después de completar los pasos anteriores, haz clic en GENERAR (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 hacer cambios y, luego, hacer clic en GENERAR para volver a generar tu paquete de implementación con esos cambios aplicados.

    Si planeas cambiar a configuración manual, puedes hacer clic en DESCARGAR a fin de descargar la especificación de Autogen para el paquete de implementación que creaste en la configuración guiada y usarla como base de tu configuración manual.

  13. Envía el paquete de implementación para su revisión en Producer Portal. Luego de que envíes el paquete, Google puede tardar hasta dos semanas en revisarlo y aprobarlo.

Crea un paquete de implementación con mpdev

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

La herramienta de mpdev usa Autogen de Deployment Manager a fin de generar las plantillas de Deployment Manager para el 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 para tu producto de VM.

En un nivel alto, para generar y enviar tu paquete de implementación, debes hacer 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 los detalles de la imagen y los requisitos de implementación para tu producto de VM.
  3. Genera el paquete de implementación según tu especificación de Autogen y sube el paquete al depósito de Cloud Storage.
  4. 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 el paquete de implementación.

Cree su 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 depósito 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 que, 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 prácticos más complejos, puedes configurar el autocompletado en algunos entornos de desarrollo (IDE) integrados para ayudar a editar y validar archivos configurations.yaml.

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

  1. Consulta la especificación de Autogen preconfigurada 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

  2. Actualiza la especificación con los detalles de configuración de la VM. Para ello, modifica el archivo configurations.yaml con la siguiente información:

    • El nombre de la imagen de VM.
    • ID para el proyecto público de Google Cloud que aloja la imagen de VM, que es el mismo proyecto que usas en Producer Portal.

    Si deseas obtener 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.

  3. Si es necesario para tu producto, personaliza los campos adicionales, como passwords, deployInput y postDeploy. Estos campos se encuentran en el DeploymentSpec del archivo configurations.yaml. Si deseas 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, debes usar la especificación a fin de generar los archivos de plantilla de Deployment Manager para tu paquete de implementación. Para almacenar el paquete, debes subirlo al bucket de Cloud Storage.

Para generar y subir tu paquete de implementación, haz lo siguiente:

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

    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 comprime y se sube a su bucket.

Para verificar que la plantilla esté configurada de forma correcta, puedes crear una implementación mediante 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

Si usas Producer Portal para crear tu ficha de producto de Cloud Marketplace, después de crear tu paquete de implementación, debes enviar el paquete a Producer Portal a fin de que el equipo de Cloud Marketplace pueda revisar y aprobar el paquete.

Si deseas enviar tu paquete de implementación para su revisión, haz lo siguiente:

Configuración guiada

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

  2. Si deseas enviar el paquete de implementación para su revisión en Producer Portal, haz clic en ENVIAR. Después de enviar el paquete, Google puede tardar hasta dos semanas en revisarlo y aprobarlo.

Configuración manual

  1. Abre Producer Portal en la consola de Google Cloud:

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
    

    Reemplaza YOUR_PUBLIC_PROJECT_ID por el ID del proyecto público que creaste para Cloud Marketplace, por ejemplo, my-organization-public.

  2. En la lista de productos, haz clic en el nombre del producto.

  3. En la página Descripción general de tu producto, ve a la sección Paquete de implementación y haz clic en EDITAR.

  4. En Especificar la ubicación del objeto de Cloud Storage, selecciona el objeto del paquete de implementación que subiste antes.

  5. Haz clic en VALIDAR. El proceso de validación puede tardar hasta dos horas en completarse y puedes salir de la pantalla mientras se completa.

  6. 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.

  7. Una vez que la validación se complete de forma correcta, a fin de enviar el paquete de implementación para su revisión, haz clic en ENVIAR. Después de enviar el paquete, Google puede tardar hasta dos semanas en revisarlo y aprobarlo.

Paquetes de implementación desde la vista del cliente

En las siguientes secciones, se muestran los diseños de pantalla que tus clientes ven cuando implementan tu producto, para soluciones basadas en paquetes de soluciones estándar generadas de forma automática.

Vista del cliente de la implementación de un paquete

Los elementos de entrada estándar del cliente se muestran en el lado izquierdo de la siguiente captura de pantalla. Se incluyen zone (zona), machine type (tipo de máquina), disk options (opciones de disco) y networking options (opciones de red).

Si la implementación de un cliente requiere varias tarjetas de interfaz de red, puedes agregar interfaces de red adicionales mediante un clic en Agregar interfaz de red.

Para implementar tu producto, tus clientes deben completar los campos de entrada y, luego, hacer clic en Implementar.

Vista del cliente de un paquete implementado

En la siguiente imagen, se muestra cómo se muestra el producto a tus clientes después de que lo implementan de forma correcta.

Los elementos de salida estándar se muestran en el lado derecho de la siguiente captura de pantalla. Se incluyen site address (dirección del sitio), temporary admin password (contraseña de administrador temporal) y, además, instance information (información de la instancia).