Comienza a usar Terraform

En este instructivo, aprenderás a ejecutar un servidor web simple en Compute Engine y usarás Terraform para aprovisionar los recursos.

En este instructivo, harás lo que se indica a continuación:

  • Usa Terraform para crear una VM en Google Cloud.
  • Inicia un servidor básico de Flask en Python.

Costos

En este instructivo, se usan los siguientes componentes facturables de Google Cloud:

Compute Engine

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios. Es posible que los usuarios nuevos de Google Cloud califiquen para obtener una prueba gratuita.

Cuando finalices este instructivo, podrás borrar los recursos creados para evitar que se te siga facturando. Para obtener más información, consulta Cómo realizar una limpieza.

Antes de comenzar

Prepárate para comenzar el instructivo.

Selecciona o crea un proyecto

  1. En Google Cloud Console, ve a la página del selector de proyectos.

    Ir al selector de proyectos

  2. Selecciona o crea un proyecto de Google Cloud.

Configura los permisos

Asegúrate de tener los permisos de Compute Engine necesarios en tu cuenta de usuario:

  • compute.instance.*
  • compute.firewalls.*

Ir a la página IAM

Obtén más información sobre los roles y permisos.

Habilitación de las API

Habilita las API de Compute Engine and OS Login.

Habilita las API

Iniciar Cloud Shell

Cloud Shell es una máquina virtual de Compute Engine.

Las credenciales de servicio asociadas a esta máquina virtual son automáticas, por lo que no es necesario configurar ni descargar una clave de cuenta de servicio.

Crea la VM de Compute Engine

Primero, define la configuración de la VM en un archivo de configuración de Terraform. Luego, ejecuta los comandos de Terraform para crear la VM en tu proyecto.

Crea el directorio

En Cloud Shell, crea un directorio nuevo. En el directorio nuevo, crea un archivo main.tf para la configuración de Terraform. En el contenido de este archivo, se describen todos los recursos de Google Cloud que se crearán en el proyecto.

mkdir tf-tutorial && cd tf-tutorial
nano main.tf

Crea el recurso de VM de Compute Engine

En esta sección, crearás una sola instancia de Compute Engine que ejecuta Debian. En este instructivo, usarás el tipo de máquina más pequeño disponible. Más adelante, puedes actualizar a un tipo de máquina más grande.

Agrega el siguiente recurso google_compute_instance de Terraform al archivo main.tf que creaste.

# Create a single Compute Engine instance
resource "google_compute_instance" "default" {
  name         = "flask-vm"
  machine_type = "f1-micro"
  zone         = "us-west1-a"
  tags         = ["ssh"]

  metadata = {
    enable-oslogin = "TRUE"
  }
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-9"
    }
  }

  # Install Flask
  metadata_startup_script = "sudo apt-get update; sudo apt-get install -yq build-essential python-pip rsync; pip install flask"

  network_interface {
    network = "default"

    access_config {
      # Include this section to give the VM an external IP address
    }
  }
}

El código de muestra establece la zona de Google Cloud en us-west1-a. Puedes cambiar esto a una zona diferente.

Inicialice Terraform

En este punto, puedes ejecutar terraform init para agregar los complementos necesarios y compilar el directorio .terraform.

terraform init

Resultado:

Initializing the backend...

Initializing provider plugins...
...

Terraform has been successfully initialized!

Valida la configuración de Terraform

De manera opcional, puedes validar el código de Terraform que compilaste hasta ahora. Ejecuta terraform plan, que hace lo siguiente:

  • Verifica que la sintaxis de main.tf sea correcta
  • Muestra una vista previa de los recursos que se crearán
terraform plan

Resultado:

...

Plan: 1 to add, 0 to change, 0 to destroy.

Note: You didn't use the -out option to save this plan, so Terraform can't
guarantee to take exactly these actions if you run "terraform apply" now.

Aplica la configuración

Para crear la VM, ejecuta terraform apply.

terraform apply

Cuando se te solicite, ingresa yes.

Terraform llama a las API de Google Cloud para configurar la VM nueva. Consulta la página de instancias de VM para ver la VM nueva.

Ejecuta un servidor web en Google Cloud

Los siguientes pasos son crear una aplicación web, implementarla en la VM y crear una regla de firewall para permitir solicitudes de clientes a la aplicación web.

Agrega una regla de firewall SSH personalizada

La regla de firewall default-allow-ssh en la red default te permite usar SSH para conectarte a la VM. Si prefieres usar tu propia regla de firewall personalizada, puedes agregar el siguiente recurso al final de tu archivo main.tf:

resource "google_compute_firewall" "ssh" {
  name = "allow-ssh"
  allow {
    ports    = ["22"]
    protocol = "tcp"
  }
  direction     = "INGRESS"
  network       = "default"
  priority      = 1000
  source_ranges = ["0.0.0.0/0"]
  target_tags   = ["ssh"]
}

Ejecuta terraform apply para crear la regla de firewall.

Conéctate a la VM con SSH

Conéctate a la VM con SSH para validar que todo esté configurado correctamente en este punto.

  1. Ve a la página Instancias de VM.

  2. Busca la VM con el nombre flask-vm.

  3. En la columna Conectar, haz clic en SSH.

    Se abrirá una ventana de terminal SSH en el navegador para la VM en ejecución.

Para obtener más información, consulta Conéctate a VM.

Compila la app de Flask

Debes compilar una app de Flask en Python para este instructivo a fin de que puedas tener un solo archivo que describa tu servidor web y los extremos de prueba.

  1. En la terminal SSH del navegador, crea un archivo llamado app.py.

    nano app.py
    
  2. Agrega lo siguiente al archivo app.py.

    from flask import Flask
    app = Flask(__name__)
    
    @app.route('/')
    def hello_cloud():
     return 'Hello Cloud!'
    
    app.run(host='0.0.0.0')
    
  3. Ejecuta app.py:

    python app.py
    

    Flask entrega el tráfico en localhost:5000 de forma predeterminada.

  4. Abre una segunda conexión SSH:

    1. Ve a la página Instancias de VM.
    2. Busca la VM llamada flash-vm y haz clic en SSH.
  5. En la segunda conexión SSH, ejecuta curl para confirmar que se muestra el saludo que configuraste en app.py.

    curl http://0.0.0.0:5000
    

    El resultado de este comando es Hello Cloud.

Abre el puerto 5000 en la VM

Para conectarse al servidor web desde tu computadora local, la VM debe tener abierto el puerto 5000. Google Cloud te permite abrir puertos al tráfico mediante reglas de firewall.

Agrega el siguiente recurso google_compute_firewall de Terraform al final del archivo main.tf.

resource "google_compute_firewall" "flask" {
  name    = "flask-app-firewall"
  network = "default"

  allow {
    protocol = "tcp"
    ports    = ["5000"]
  }
  source_ranges = ["0.0.0.0/0"]
}

En Cloud Shell, ejecuta terraform apply para crear la regla de firewall.

Agrega una variable de salida para la URL del servidor web

  1. Al final de main.tf, agrega una variable de salida de Terraform para generar la URL del servidor web:

    // A variable for extracting the external IP address of the VM
    output "Web-server-URL" {
     value = join("",["http://",google_compute_instance.default.network_interface.0.access_config.0.nat_ip,":5000"])
    }
    
  2. Ejecuta terraform apply.

    terraform apply
    

    Cuando se te solicite, ingresa yes. Terraform imprime la dirección IP externa y el puerto 5000 de la VM en la pantalla, de la siguiente manera:

    Web-server-URL = "http://IP_ADDRESS:5000"
    

    En cualquier momento, puedes ejecutar terraform output para mostrar este resultado:

    terraform output
    
  3. Haz clic en la URL del paso anterior y ve el mensaje "Hello Cloud!".

    Esto significa que tu servidor se está ejecutando.

Soluciona problemas

  • Si una API requerida no está habilitada, Terraform muestra un error. El mensaje de error incluye un vínculo para habilitar la API. Después de habilitar la API, puedes volver a ejecutar terraform apply.

  • Si no puedes conectarte a la VM a través de SSH, haz lo siguiente:

Limpia

Después de completar el instructivo, puedes borrar todo lo que creaste para no incurrir en más costos.

Terraform te permite quitar todos los recursos definidos en el archivo de configuración mediante la ejecución del comando terraform destroy:

terraform destroy

Ingresa yes para permitir que Terraform borre tus recursos.

¿Qué sigue?