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 información general sobre los conceptos de Compute Engine, consulta la documentación de Compute Engine.
Algunos productos de máquinas virtuales de Google Cloud Marketplace admiten el despliegue a través de la interfaz de línea de comandos (CLI) mediante Terraform, una herramienta de código abierto para aprovisionar y gestionar infraestructuras. Para obtener más información sobre Terraform, consulta el artículo Empezar a usar Terraform.
Información general
En esta página se describen los pasos para desplegar productos de máquinas virtuales a través de la CLI mediante Terraform. En términos generales, puede hacer lo siguiente:
Visita la sección correspondiente de la ficha de Google Cloud Marketplace del producto.
De forma opcional, selecciona o crea la cuenta de servicio que quieras usar para la implementación de la línea de comandos.
Opcionalmente, configura la suplantación de identidad de la cuenta de servicio.
Configura tu entorno de
gcloud
para Terraform.Descarga el módulo o el fragmento de código de Terraform que usas para desplegar el producto de máquina virtual a través de la CLI.
Usa el módulo o el fragmento de código para desplegar el producto de VM.
Ve a la pestaña de implementación de línea de comandos
Para empezar a desplegar un producto de máquina virtual a través de la CLI, sigue estos pasos:
En Cloud Marketplace, ve a la página de la ficha del producto de VM que quieras implementar a través de la CLI.
Haga clic en el botón Iniciar o en Implementar con CLI para ir a la pestaña Implementación con línea de comandos.
(Opcional) Selecciona o crea tu cuenta de servicio
En la pestaña Implementación mediante línea de comandos, puedes seleccionar o crear la cuenta de servicio que quieras usar para la implementación mediante línea de comandos. Si no has seleccionado ni creado una cuenta de servicio en la pestaña Implementación mediante línea de comandos al generar el fragmento de código, debes editar manualmente el fragmento de Terraform generado para añadir una cuenta de servicio antes de usarlo. Para obtener más información sobre las cuentas de servicio, consulta el artículo Crear y gestionar cuentas de servicio.
Si quieres implementar un producto de VM de Cloud Marketplace a través de la CLI, la cuenta de servicio que utilices debe tener el rol de gestión de identidades y accesos (IAM) Administrador de Compute (roles/compute.admin
).
Si creas una cuenta de servicio en la pestaña Despliegue de línea de comandos, Google Cloud Marketplace le asignará automáticamente este rol a la nueva cuenta de servicio. Si seleccionas una cuenta de servicio en la pestaña Implementación mediante 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 mediante línea de comandos de la ficha de Google Cloud Marketplace del producto de VM, vaya a Configurar una cuenta de servicio (opcional) y haga clic en el botón Configurar.
En Cuenta de servicio que solicita permisos, puedes hacer clic en Seleccionar una cuenta de servicio disponible o en Crear una cuenta de servicio.
Seleccionar una cuenta de servicio disponible
Para seleccionar una cuenta de servicio disponible, sigue estos pasos:
En Seleccionar una cuenta de servicio, elija la cuenta de servicio que quiera usar. La lista contiene todas las cuentas de servicio que tienen el rol Administrador de Compute (
roles/compute.admin
).Si ninguna de tus cuentas de servicio tiene el rol Administrador de Compute (
roles/compute.admin
), la lista estará vacía. Si la lista está vacía, puedes conceder este rol a una de tus cuentas de servicio y, a continuación, volver a esta pestaña. También puedes crear una cuenta de servicio.Haz clic en el botón Enviar.
Crear una cuenta de servicio
Para crear una cuenta de servicio, sigue estos pasos:
Elige un nombre para la cuenta de servicio y añádelo en el campo Nombre de cuenta de servicio.
Elige un ID para tu cuenta de servicio y añádelo en el campo ID de cuenta de servicio.
Añade una descripción de la cuenta de servicio en el campo Descripción de la cuenta de servicio.
Haz clic en el botón Crear cuenta de servicio.
Una vez que hayas creado tu cuenta de servicio, podrás seguir gestionando el control de acceso de la cuenta de servicio mediante la gestión de identidades y accesos.
(Opcional) Configurar la suplantación de identidad de cuenta de servicio
Te recomendamos que utilices la suplantación de identidad de cuenta de servicio para gestionar el acceso a tu implementación de línea de comandos. Si usas la suplantación de identidad, en lugar de crear claves de cuenta de servicio que cualquier persona pueda usar para acceder a tu implementación, gestionas el acceso concediendo o revocando el rol de gestión de identidades y accesos Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator
) a principales específicos.
Para saber cómo asignar y revocar roles en cuentas de servicio, consulta el artículo Gestionar el acceso a cuentas de servicio. Para obtener más información sobre la suplantación de identidad de cuentas de servicio, consulta el artículo Suplantación de identidad de cuentas de servicio.
Configurar el entorno de gcloud para Terraform
En la pestaña Implementación mediante línea de comandos, en Configurar gcloud, verás una serie de comandos. Para configurar tu entorno de gcloud
para Terraform, puedes copiar y ejecutar los comandos proporcionados.
Descargar el módulo de Terraform
Para desplegar un producto de VM a través de la CLI, puedes usar un módulo de Terraform incluido o un fragmento de código generado, en función de cómo esté configurado el producto de VM. Para verificar si usas un módulo incluido o un fragmento de código generado para desplegar un producto de máquina virtual, ve a la pestaña Despliegue de línea de comandos de la ficha de Cloud Marketplace del producto. Si usas un módulo incluido para implementar el producto, verás el botón Descargar. Si usas un fragmento de código generado para implementar el producto, verás el botón Generar código.
Para descargar el módulo incluido o el fragmento de código generado, sigue estos pasos:
Módulo de Terraform incluido
En la pestaña Implementación mediante línea de comandos de la ficha de Cloud Marketplace del producto de VM, haga clic en el botón Descargar. Se descargará un archivo ZIP que contiene el módulo de Terraform que uses.
Extrae el módulo de Terraform del archivo ZIP que has descargado.
Fragmento de código generado
En la pestaña Implementación mediante línea de comandos de la ficha de Cloud Marketplace del producto de VM, haga clic en el botón Generar código. De esta forma, se genera un fragmento de código que puedes copiar y usar con Terraform para desplegar 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 desplegar el producto de VM a través de la CLI, sigue estos pasos:
Módulo de Terraform incluido
En el módulo de Terraform que has descargado, 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 algún problema, puedes probar a implementar el módulo ejecutando los siguientes comandos:
terraform init
terraform apply
Fragmento de código generado
Verifica que el fragmento de código generado incluya la cuenta de servicio que quieras usar. Si has configurado 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 has configurado una cuenta de servicio, debes editar el fragmento de código generado para especificar la cuenta de servicio que quieras usar.
Crea un archivo llamado
main.tf
en la máquina en la que hayas instalado Terraform.Pega el fragmento de código generado, con las modificaciones que hayas hecho, en el archivo
main.tf
que has creado.Ejecuta estos comandos:
terraform init
terraform apply
Pasos siguientes
Para obtener información sobre cómo gestionar las implementaciones de CLI de productos de VM, consulte Gestionar las implementaciones de CLI de productos de VM.