Aprovisiona recursos de Compute Engine con Terraform

HashiCorp Terraform es una herramienta de infraestructura como código (IaC) que te permite aprovisionar y administrar la infraestructura de nube. Terraform proporciona complementos llamados proveedores que te permiten interactuar con proveedores de servicios en la nube y otras APIs. Puedes usar el proveedor de Terraform para Google Cloud para aprovisionar y administrar recursos de Google Cloud, incluido Compute Engine.

En esta página, se presenta el uso de Terraform con Compute Engine, incluida una introducción a su funcionamiento y algunos recursos para comenzar a usarlo con Google Cloud. También encontrarás vínculos a documentos de referencia de Terraform para Compute Engine, ejemplos de código y guías para usar Terraform con el objetivo de aprovisionar recursos de Compute Engine.

Para obtener instrucciones sobre cómo comenzar a usar Terraform para Google Cloud, consulta Cómo instalar y configurar Terraform o la guía de inicio rápido de Terraform para Google Cloud.

Cómo funciona Terraform

Terraform tiene una sintaxis declarativa y orientada a la configuración que puedes usar para describir la infraestructura que deseas aprovisionar en tu proyecto de Google Cloud. Después de crear esta configuración en uno o más archivos de configuración de Terraform, puedes usar la CLI de Terraform para aplicarla a tus recursos de Compute Engine.

En los siguientes pasos, se explica cómo funciona Terraform:

1. Describes la infraestructura que deseas aprovisionar en un archivo de configuración de Terraform. No es necesario que escribas código que describa cómo aprovisionar la infraestructura. Terraform aprovisiona la infraestructura por ti.
2. Ejecuta el comando terraform plan, que evalúa tu configuración y genera un plan de ejecución. Puedes revisar el plan y realizar cambios según sea necesario.

3. Luego, ejecuta el comando terraform apply, que realiza las siguientes acciones:

   1. Aprovisiona tu infraestructura según tu plan de ejecución mediante la invocación de las APIs de Compute Engine correspondientes en segundo plano.
   2. Crea un archivo de estado de Terraform, que es un archivo JSON que asigna los recursos del archivo de configuración a los recursos de la infraestructura del mundo real. Terraform usa este archivo para mantener un registro del estado más reciente de tu infraestructura y determinar cuándo crear, actualizar y destruir recursos.

   3. Luego, cuando ejecutes terraform apply, Terraform usa la asignación en el archivo de estado para comparar la infraestructura existente con el código y realizar actualizaciones según sea necesario:

      • Si un objeto de recurso se define en el archivo de configuración, pero no existe en el archivo de estado, Terraform lo crea.
      • Si existe un objeto de recurso en el archivo de estado, pero tiene una configuración diferente de tu archivo de configuración, Terraform actualiza el recurso para que coincida con tu archivo de configuración.
      • Si un objeto de recurso en el archivo de estado coincide con tu archivo de configuración, Terraform deja el recurso sin cambios.

Recursos de Terraform para Compute Engine

Los recursos son los elementos fundamentales del lenguaje de Terraform. Cada bloque de recursos describe uno o más objetos de infraestructura, como redes virtuales o instancias de procesamiento.

En la siguiente tabla, se enumeran los recursos de Terraform disponibles para Compute Engine:

Recursos de Terraform

Fuentes de datos

google_compute_address google_compute_attached_disk google_compute_autoscaler google_compute_backend_bucket google_compute_backend_bucket_iam google_compute_backend_bucket_signed_url_key google_compute_backend_service google_compute_backend_service_iam google_compute_backend_service_signed_url_key google_compute_disk google_compute_disk_async_replication google_compute_disk_iam google_compute_disk_resource_policy_attachment google_compute_external_vpn_gateway google_compute_firewall google_compute_firewall_policy google_compute_firewall_policy_association google_compute_firewall_policy_rule google_compute_forwarding_rule google_compute_global_address google_compute_global_forwarding_rule google_compute_global_network_endpoint google_compute_global_network_endpoint_group google_compute_ha_vpn_gateway google_compute_health_check google_compute_http_health_check google_compute_https_health_check google_compute_image google_compute_image_iam google_compute_instance google_compute_instance_from_machine_image google_compute_instance_from_template google_compute_instance_group google_compute_instance_group_manager google_compute_instance_group_membership google_compute_instance_group_named_port google_compute_instance_iam google_compute_instance_settings google_compute_instance_template google_compute_interconnect google_compute_interconnect_attachment google_compute_machine_image google_compute_machine_image_iam google_compute_managed_ssl_certificate google_compute_network google_compute_network_attachment google_compute_network_edge_security_service google_compute_network_endpoint google_compute_network_endpoint_group google_compute_network_endpoints google_compute_network_firewall_policy google_compute_network_firewall_policy_association google_compute_network_firewall_policy_rule google_compute_network_peering google_compute_network_peering_routes_config google_compute_node_group google_compute_node_template google_compute_organization_security_policy google_compute_organization_security_policy_association google_compute_organization_security_policy_rule google_compute_packet_mirroring google_compute_per_instance_config google_compute_project_cloud_armor_tier google_compute_project_default_network_tier google_compute_project_metadata google_compute_project_metadata_item google_compute_public_advertised_prefix google_compute_public_delegated_prefix google_compute_region_autoscaler google_compute_region_backend_service google_compute_region_backend_service_iam google_compute_region_commitment google_compute_region_disk google_compute_region_disk_iam google_compute_region_disk_resource_policy_attachment google_compute_region_health_check google_compute_region_instance_group_manager google_compute_region_instance_template google_compute_region_network_endpoint google_compute_region_network_endpoint_group google_compute_region_network_firewall_policy google_compute_region_network_firewall_policy_association google_compute_region_network_firewall_policy_rule google_compute_region_per_instance_config google_compute_region_security_policy google_compute_region_security_policy_rule google_compute_region_ssl_certificate google_compute_region_ssl_policy google_compute_region_target_http_proxy google_compute_region_target_https_proxy google_compute_region_target_tcp_proxy google_compute_region_url_map google_compute_reservation google_compute_resource_policy google_compute_route google_compute_router google_compute_router_interface google_compute_router_nat google_compute_router_peer google_compute_security_policy google_compute_security_policy_rule google_compute_service_attachment google_compute_shared_vpc_host_project google_compute_shared_vpc_service_project google_compute_snapshot google_compute_snapshot_iam google_compute_ssl_certificate google_compute_ssl_policy google_compute_subnetwork google_compute_subnetwork_iam google_compute_target_grpc_proxy google_compute_target_http_proxy google_compute_target_https_proxy google_compute_target_instance google_compute_target_pool google_compute_target_ssl_proxy google_compute_target_tcp_proxy google_compute_url_map google_compute_vpn_gateway google_compute_vpn_tunnel google_usage_export_bucket

google_compute_address google_compute_addresses google_compute_backend_bucket google_compute_backend_bucket_iam_policy google_compute_backend_service google_compute_backend_service_iam_policy google_compute_default_service_account google_compute_disk google_compute_disk_iam_policy google_compute_forwarding_rule google_compute_forwarding_rules google_compute_global_address google_compute_global_forwarding_rule google_compute_ha_vpn_gateway google_compute_health_check google_compute_image google_compute_image_iam_policy google_compute_instance google_compute_instance_group google_compute_instance_group_manager google_compute_instance_iam_policy google_compute_instance_serial_port google_compute_instance_template google_compute_lb_ip_ranges google_compute_machine_image_iam_policy google_compute_machine_types google_compute_network google_compute_network_endpoint_group google_compute_network_peering google_compute_networks google_compute_node_types google_compute_region_backend_service_iam_policy google_compute_region_disk google_compute_region_disk_iam_policy google_compute_region_instance_group google_compute_region_instance_template google_compute_region_network_endpoint_group google_compute_region_ssl_certificate google_compute_regions google_compute_reservation google_compute_resource_policy google_compute_router google_compute_router_nat google_compute_router_status google_compute_security_policy google_compute_snapshot google_compute_snapshot_iam_policy google_compute_ssl_certificate google_compute_ssl_policy google_compute_subnetwork google_compute_subnetwork_iam_policy google_compute_subnetworks google_compute_vpn_gateway google_compute_zones

Guías basadas en Terraform para Compute Engine

En la siguiente tabla, se enumeran las guías prácticas y los instructivos basados en Terraform para Compute Engine:

Guía	Detalles
Crea y inicia una instancia de Compute Engine	Explica cómo crear una instancia de máquina virtual (VM).
Crea una VM con discos SSD locales	Se explica cómo puedes crear una VM con almacenamiento en disco SSD local.
Crea instantáneas de disco	Explica cómo crear instantáneas estándar para crear copias de seguridad de los datos de los discos de forma periódica.
Duplica un disco con clonaciones	Explica cómo crear clones de discos zonales a partir de un disco existente.
Crea y administra discos regionales	Se explica cómo crear y administrar discos regionales.
Crea y usa VMs Spot	Se explica cómo crear y administrar VMs Spot. Las VMs Spot son instancias de VM que son un excedente de capacidad de Compute Engine. Las VMs Spot están disponibles a precios mucho más bajos en comparación con el precio según demanda de las VMs estándar.
Agrega claves SSH a las VMs	Se describe cómo agregar claves SSH a instancias de VM que usan el Acceso al SO y VMs que usan claves SSH basadas en metadatos.
Ejecuta secuencias de comandos de cierre	Explica cómo crear y ejecutar secuencias de comandos de apagado que ejecuten comandos justo antes de que se detenga o reinicie una instancia de VM.
Crea una reserva para un solo proyecto	Explica cómo crear una reserva de un solo proyecto, que solo pueden consumir las instancias de VM del mismo proyecto.
Crea plantillas de instancias	Se describe cómo crear y administrar plantillas de instancias.
Escalamiento según los programas	Describe cómo puedes crear programas de escalamiento para un MIG existente. El ajuste de escala automático basado en los programas te permite mejorar la disponibilidad de tus cargas de trabajo mediante la programación de la capacidad antes de la carga anticipada.
Agrega almacenamiento de Persistent Disk a la VM	Explica cómo crear un volumen de Persistent Disk zonal en blanco que no sea de arranque y conectarlo a tu VM.
Configura Acceso al SO	Obtén información sobre cómo configurar el Acceso al SO.
Cómo conectar un disco que no sea de arranque a una VM	Explica cómo conectar un disco zonal que no sea de arranque a tu VM.
Crear una VM que use una cuenta de servicio administrada por el usuario	Explica cómo crear una instancia de VM que esté configurada para usar una cuenta de servicio administrada por el usuario. Una cuenta de servicio es un tipo especial de cuenta que, por lo general, es usada por una carga de trabajo de aplicación o procesamiento para realizar llamadas autorizadas a la API.
Aumenta el tamaño de un disco persistente	Explica cómo aumentar el tamaño de un disco persistente.
Habilita pantallas virtuales en una VM	Se describe cómo habilitar pantallas virtuales en una instancia de VM.
Crea un MIG en una sola zona	Describe cómo crear un grupo de instancias administrado (MIG) en una sola zona. Ubicar todas las VMs de tu MIG en una sola zona ayuda a minimizar la latencia, lo que es útil para ciertas cargas de trabajo, por ejemplo, cargas de trabajo por lotes.
Crea una instancia de VM con un nombre de host personalizado	Explica cómo crear una instancia de VM con un nombre de host personalizado.
Configura una verificación de estado de la aplicación y una reparación automática	Se describe cómo configurar una verificación de estado basada en aplicaciones para la reparación automática de las VMs de un MIG.
Crea un MIG que use VM interrumpibles	Describe cómo crear un MIG que use instancias de VM interrumpible. Las VMs interrumpibles son útiles si tu carga de trabajo puede tolerar interrupciones y deseas aprovechar los ahorros de costos asociados con las VM interrumpibles.
Agrega y quita VMs en un MIG	Describe cómo agregar y quitar VMs de un MIG.
Crea un MIG con ajuste de escala automático habilitado	Se describe cómo crear un MIG con ajuste de escala automático que agrega y quita VMs de forma automática en función del uso de CPU promedio en el grupo.
Crea un MIG con discos con estado	Describe cómo crear un MIG que use instancias de VM interrumpible. Las VMs interrumpibles son útiles si tu carga de trabajo puede tolerar interrupciones y deseas aprovechar los ahorros de costos asociados con las VM interrumpibles.
Crea instancias de VM de SQL Server	Explica cómo crear instancias de VM de Microsoft SQL Server. SQL Server es un sistema de base de datos que se ejecuta en Windows Server y algunas distribuciones de Linux. Puedes usar SQL Server en Compute Engine como parte del backend de tus aplicaciones, como un entorno de desarrollo y pruebas flexible o en conjunto con tus sistemas locales de copias de seguridad y recuperación ante desastres.
Crea una asignación de política del SO	Se explica cómo crear una asignación de política del SO. Puedes usar las políticas del SO para mantener una configuración de software coherente en las instancias de VM de Linux y Windows.
Configura metadatos con estado en MIG	Describe cómo configurar metadatos con estado en MIG. Los metadatos de instancia son útiles para configurar propiedades de las aplicaciones y comunicarse con ellas, todo esto a través del servidor de metadatos.
Configura discos persistentes con estado en MIG	Explica cómo configurar discos persistentes con estado en MIG. Configurar los discos persistentes para que tengan estado te permite beneficiarte de la reparación automática y las actualizaciones automáticas de una instancia de VM y, a la vez, conservar el estado de los discos.
Configura direcciones IP con estado en MIG	Describe cómo configurar direcciones IP con estado en MIG. Cuando configuras direcciones IP con estado en un MIG, te aseguras de que las direcciones IP se conserven cuando las instancias de VM del grupo se reparan de forma automática, se actualizan y se vuelven a crear.
Establece una forma de distribución objetivo para VM en un MIG regional	Se explica cómo configurar una forma de distribución objetivo para VMs.
Crea un MIG con VMs en varias zonas de una región	Se describe cómo crear un MIG que tiene sus VMs distribuidas en varias zonas de una región. La distribución de la carga de la aplicación en varias zonas protege tu carga de trabajo contra fallas zonales. Nota: Las regiones de México, Montreal y Osaka tienen tres zonas dentro de uno o dos centros de datos físicos. Estas regiones están en proceso de expansión a, al menos, tres centros de datos físicos. Para obtener más información, consulta Ubicaciones de Cloud y ANS de Google Cloud Platform. Para mejorar la confiabilidad de tus cargas de trabajo, considera una implementación multirregional.
Inhabilita y vuelve a habilitar la redistribución proactiva de VM en un MIG regional	Describe cómo inhabilitar y volver a habilitar la redistribución proactiva de VM en un MIG regional. En un MIG regional, para mantener una cantidad par de instancias de VM en las zonas seleccionadas de la región, usa la redistribución proactiva de instancias. Esta configuración maximiza la disponibilidad de tu aplicación en caso de una falla a nivel de zona.

Planos y módulos de Terraform para Compute Engine

Los módulos y los esquemas te ayudan a automatizar el aprovisionamiento y la administración de los recursos de Google Cloud a gran escala. Un módulo es un conjunto reutilizable de archivos de configuración de Terraform que crea una abstracción lógica de los recursos de Terraform. Un esquema es un paquete de módulos implementables y reutilizables, y una política que implementa y documenta una solución específica.

En la siguiente tabla, se enumeran los módulos y los esquemas relacionados con Compute Engine:

Módulo o esquema	Detalles
terraform-google-vm	Colección de submódulos revisados que puedes usar como componentes básicos para aprovisionar VMs en Google Cloud.
terraform-google-startup-scripts	Proporciona una biblioteca de secuencias de comandos de inicio útiles para incorporar en las VMs.
terraform-google-container-vm	Implementa contenedores en instancias de Compute Engine

¿Qué sigue?

• Muestras de código de Terraform para Compute Engine
• Documentación de Terraform en Google Cloud
• Documentación del proveedor de Google Cloud en HashiCorp
• Infraestructura como código para Google Cloud