Crear tu paquete de implementación

En esta sección, se describen los pasos a fin de crear paquetes de implementación para tu solución. Los paquetes de implementación se suben a través del portal de Partners y son necesarios para enviar tu solución de VM.

Una implementación es un conjunto de recursos que se crean y administran juntos, como los recursos necesarios para tu solución. Un paquete de implementación o una plantilla es una especificación para un conjunto de recursos que generalmente se implementan juntos, lo que optimiza el proceso de implementación de esa solución en particular. Deployment Manager te permite crear paquetes y plantillas de implementación para tus soluciones de VM mediante archivos de configuración simples YAML, JSON o ProtoText.

Si tu solución es una implementación simple de una única instancia de máquina virtual con reglas de firewall básicas, puedes configurar tu paquete de implementación directamente en el portal de Partners.

En la mayoría de los casos prácticos, recomendamos usar la herramienta de código abierto deploymentmanager-autogende Deployment Manager para generar paquetes. Con Deployment Manager Autogen el paquete de implementación incluye las siguientes capacidades:

  • Comprueba las cuotas de CPU y GPU para que los usuarios no puedan implementar tu solución si superan los requisitos de cuota.
  • Actualizaciones del establecimiento dinámico de precios en la página de Deployment Manager.
  • Compatibilidad con VPC compartidas.
  • Compatibilidad con VM con múltiples tarjetas de interfaz de red.
  • La capacidad de evitar que los usuarios elijan tipos de máquinas, GPU o subredes que no están disponibles en la zona que eligen.

Antes de comenzar

 Caution: Your deployment must not use Terraform, or have any dependencies
 on Terraform.

Para hacer esto, ingresa lo siguiente:

alias autogen='docker run \
  --rm \
  --workdir /mounted \
  --mount type=bind,source="$(pwd)",target=/mounted \
  --user $(id -u):$(id -g) \
  gcr.io/cloud-marketplace-tools/dm/autogen'

autogen --help

Crear tu archivo de configuración de Autogen

Recomendamos crear el archivo de configuración inicial con la modificación del ejemplo en la carpeta example-config del repositorio de Autogen.

Los comentarios dentro del archivo de configuración y de los archivos proto (autogen.proto, deployment_package_autogen_spec.proto y marketing_info) proto) contienen información sobre los campos en su interior, incluido cuál de ellos es obligatorio o opcional. Si generas un paquete de implementación para una sola solución, tu archivo de configuración debe seguir las especificaciones del proto DeploymentPackageInput. Si generas un paquete de implementación para varias soluciones, tu archivo de configuración debe seguir las especificaciones del proto BatchInput. Ambas especificaciones se encuentran en autogen.proto.

Para crear el archivo de configuración, cambia cada uno de los campos del archivo de configuración de ejemplo a fin de reflejar la configuración de la solución y, luego, ejecuta Autogen en tu archivo de configuración editado.

Otras opciones de configuración de muestra también están disponibles en la carpeta testdata.

Genera el paquete de implementación

El siguiente es un comando de muestra que lee la especificación en example-config/solution.yaml y genera un paquete en una carpeta llamada solution-folder:

mkdir solution_folder

autogen \
  --input_type YAML \
  --single_input example-config/solution.yaml \
  --output_type PACKAGE \
  --output solution_folder

Para ejecutar Autogen desde la línea de comandos, debes incluir uno de los siguientes dos parámetros:

  • --single_input, si generas un paquete para una solución
  • --batch_input, si generas paquetes para múltiples soluciones

También puedes usar parámetros opcionales como --input_type y --output_type, para especificar qué formatos Autogen lee o escribe. Para obtener información sobre todas las opciones posibles, consulta la documentación de Autogen.

Una vez que se ha creado el paquete de implementación, puedes comprimir la carpeta solution_folder y luego cargar ese archivo comprimido en el portal de Partners.

Crea paquetes simples de Deployment Manager en el portal de Partners

Las soluciones que son implementaciones simples de una única instancia de máquina virtual con reglas de firewall básicas pueden tener sus paquetes de implementación configurados directamente en el portal de Partners.

Para configurar esto, abre el portal de Partners y selecciona tu solución de la lista de soluciones, luego, sigue estos pasos:

  1. Junto a Paquete de implementación, haz clic en Editar.
  2. Selecciona Generar un paquete y, luego, haz clic en Continuar.
  3. Selecciona tu imagen de VM mediante los menús desplegables Proyecto, luego, Imagen y Continuar.
  4. Selecciona la configuración de Tipo de máquina mínimo y Tipo de máquina predeterminado, luego, haz clic en Continuar.
  5. Agrega los siguientes pasos posteriores a la implementación que tus clientes deben seguir y, luego, haz clic en Continuar.
  6. Configura las reglas de firewall y otras opciones de red, si corresponde y, luego, haz clic en Continuar.
  7. Puedes elegir declarar un sitio o URL de administrador. Si tu solución requiere un inicio de sesión, puedes configurar los detalles de inicio de sesión cuando envíes la solución. Haz clic en Continuar.
  8. En Enumerar el contenido del paquete, selecciona el Nombre del sistema operativo y la Versión del sistema operativo del sistema operativo de la imagen de VM. Luego puedes agregar un Nombre y Versión para cada pieza de software adicional que viene incluida como parte de tu solución. Después de haber enumerado todos los contenidos del paquete, haz clic en Continuar.
  9. Una vez que hayas completado los pasos anteriores, tu paquete de solución se muestra en Revisión. Puedes descargar el paquete de solución o hacer clic en Editar JSON para modificarlo manualmente. Haa clic en Guardar para guardar el paquete y volver a tu solución.

Para implementaciones más complejas, puedes crear una implementación desde cero. Si no estás seguro de qué tipo de solución es mejor para tu proyecto, habla con su Ingeniero socio de Google.

Paquetes de implementación desde la vista del cliente

En las siguientes secciones, se muestra el diseño de la pantalla que ven tus clientes cuando implementan la solución, para soluciones basadas en plantillas de solución estándar generadas automáticamente.

Vista del cliente sobre 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 solución, 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 aparecerá tu solución para tus clientes después de que implementarla con éxito.

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