Los productos de máquinas virtuales (VM) que se ofrecen a través de Google Cloud Marketplace son instancias de VM personalizadas que puedes ejecutar en Compute Engine. Para obtener una descripción general de los conceptos de Compute Engine, consulta la documentación de Compute Engine.
Algunos productos de VM en Google Cloud Marketplace admiten la implementación a través de la interfaz de línea de comandos (CLI) con Terraform, una herramienta de código abierto para aprovisionar y administrar infraestructura. Para obtener más información sobre Terraform, consulta Comienza a usar Terraform.
Descripción general
En esta página, se describen los pasos para implementar productos de VM a través de la CLI con Terraform. A grandes rasgos, debes hacer lo siguiente:
Visita la sección pertinente de la ficha del producto en Google Cloud Marketplace.
De manera opcional, selecciona o crea la cuenta de servicio que deseas usar para la implementación desde la línea de comandos.
De manera opcional, configura la identidad temporal como cuenta de servicio.
Configura tu entorno de
gcloudpara Terraform.Descarga el módulo o el fragmento de código de Terraform que usas para implementar el producto de VM a través de la CLI.
Usa el módulo o el fragmento de código para implementar el producto de VM.
Visita la pestaña de implementación de línea de comandos
Para comenzar a implementar un producto de VM a través de la CLI, haz lo siguiente:
En Cloud Marketplace, visita la página de la ficha del producto de VM que deseas implementar a través de la CLI.
Haz clic en el botón Lanzar o en Implementar con la CLI para visitar la pestaña Implementación con la línea de comandos.
(Opcional) Selecciona o crea tu cuenta de servicio
En la pestaña Implementación desde la línea de comandos, puedes seleccionar o crear la cuenta de servicio que deseas usar para la implementación desde la línea de comandos. Si no seleccionaste ni creaste una cuenta de servicio en la pestaña Implementación de línea de comandos cuando generaste tu fragmento de código, debes editar manualmente el fragmento de Terraform generado para agregar una cuenta de servicio antes de usarlo. Para obtener más información sobre las cuentas de servicio, consulta Crea y administra cuentas de servicio.
Si deseas implementar un producto de VM de Cloud Marketplace a través de la CLI, la cuenta de servicio que uses debe tener el rol de administrador de Compute (roles/compute.admin) de Identity and Access Management (IAM).
Si creas una cuenta de servicio nueva desde la pestaña Implementación de línea de comandos, Google Cloud Marketplace otorga automáticamente este rol a la cuenta de servicio nueva. Si seleccionas una cuenta de servicio existente en la pestaña Implementación desde la línea de comandos, debes verificar que la cuenta de servicio tenga este rol.
Para seleccionar o crear tu cuenta de servicio, sigue estos pasos:
En la pestaña Implementación desde la línea de comandos de la ficha del producto de VM en Google Cloud Marketplace, en Configura una cuenta de servicio (opcional), haz clic en el botón Configurar.
En Cuenta de servicio que solicita permisos, puedes hacer clic en Seleccionar una cuenta de servicio existente o Crear una nueva cuenta de servicio.
Selecciona una cuenta de servicio existente
Para seleccionar una cuenta de servicio existente, sigue estos pasos:
En Selecciona una cuenta de servicio, elige la cuenta de servicio que deseas usar. La lista contiene todas tus cuentas de servicio existentes que tienen el rol de administrador de Compute (
roles/compute.admin).Si ninguna de tus cuentas de servicio existentes tiene el rol de administrador de Compute (
roles/compute.admin), la lista estará vacía. Si la lista está vacía, puedes otorgar este rol a una de tus cuentas de servicio existentes y, luego, volver a esta pestaña, o bien puedes crear una cuenta de servicio nueva.Haz clic en el botón Enviar.
Crear una nueva cuenta de servicio
Para crear una cuenta de servicio nueva, sigue estos pasos:
Elige un nombre para tu cuenta de servicio y agrégalo en el campo Nombre de la cuenta de servicio.
Elige un ID para tu cuenta de servicio y agrégalo en el campo ID de cuenta de servicio.
Agrega una descripción para tu cuenta de servicio en el campo Descripción de la cuenta de servicio.
Haz clic en el botón Crear cuenta de servicio.
Después de crear tu cuenta de servicio, puedes seguir administrando el control de acceso de la cuenta de servicio con IAM.
(Opcional) Configura la identidad temporal como cuenta de servicio
Te recomendamos que uses la identidad temporal como cuenta de servicio para administrar el acceso a tu implementación de línea de comandos. Si usas la suplantación, en lugar de crear claves de cuentas de servicio que cualquiera pueda usar para acceder a tu implementación, administras el acceso otorgando o revocando el rol de IAM de Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) a principales específicos.
Para obtener información sobre cómo otorgar y revocar roles en una cuenta de servicio, consulta Administra el acceso a las cuentas de servicio. Para obtener más información sobre la identidad temporal como cuenta de servicio, consulta Identidad temporal como cuenta de servicio.
Configura tu entorno de gcloud para Terraform
En la pestaña Implementación desde la línea de comandos, en Configura gcloud, verás una serie de comandos. Para configurar tu entorno de gcloud para Terraform, puedes copiar y ejecutar los comandos proporcionados.
Descarga el módulo de Terraform
Usas un módulo de Terraform incluido o un fragmento de código generado para implementar un producto de VM a través de la CLI, según cómo esté configurado el producto de VM. Para verificar si usas un módulo incluido o un fragmento de código generado para implementar un producto de VM, visita la pestaña Implementación desde la línea de comandos de la ficha del producto en Cloud Marketplace. Si usas un módulo incluido para implementar el producto, verás un botón Descargar. Si usas un fragmento de código generado para implementar el producto, verás un botón Generar código.
Para descargar el módulo incluido o el fragmento de código generado, completa los siguientes pasos:
Módulo de Terraform incluido
En la pestaña Implementación de la línea de comandos de la ficha de Cloud Marketplace del producto de VM, haz clic en el botón Descargar. Esto descarga un archivo ZIP que contiene el módulo de Terraform que usas.
Extrae el módulo de Terraform del archivo ZIP que descargaste.
Fragmento de código generado
En la pestaña Implementación de la línea de comandos de la ficha de Cloud Marketplace del producto de VM, haz clic en el botón Generar código. Esto genera un fragmento de código que puedes copiar y usar con Terraform para implementar una VM con Terraform.
Para copiar el fragmento de código generado, haz clic en Copiar en el portapapeles.
Usa el módulo incluido o el fragmento de código generado para implementar el producto de VM.
Para usar el módulo incluido o el fragmento de código generado para implementar el producto de VM a través de la CLI, completa los siguientes pasos:
Módulo de Terraform incluido
En el módulo de Terraform que descargaste, busca el archivo
README.md.Sigue las instrucciones específicas del producto que se indican en el archivo
README.md.Mientras sigues las instrucciones específicas del producto, si tienes problemas, puedes intentar implementar el módulo ejecutando los siguientes comandos:
terraform initterraform apply
Fragmento de código generado
Verifica que el fragmento de código generado incluya la cuenta de servicio que deseas usar. Si configuraste una cuenta de servicio para tu implementación de línea de comandos, la información de esa cuenta de servicio se incluye en el fragmento de código generado. Si no configuraste una cuenta de servicio, debes editar el fragmento de código generado para especificar la cuenta de servicio que deseas usar.
Crea un archivo nuevo llamado
main.tfen la máquina en la que instalaste Terraform.Pega el fragmento de código generado, con las modificaciones que le hayas hecho, en el archivo
main.tfque creaste.Ejecuta los siguientes comandos:
terraform initterraform apply
Próximos pasos
Para obtener información sobre cómo administrar las implementaciones de la CLI de los productos de VM, visita Administra las implementaciones de la CLI de los productos de VM.