Infraestructura de Terraform

Terraform es una herramienta de código abierto para infraestructura como código que te permite crear, modificar y mejorar infraestructura de forma segura y predecible.

El generador de infraestructura Terraform crea un proyecto de infraestructura con Terraform. La aplicación generada incluye mejores prácticas de seguridad mediante verificaciones de Checkov.

Uso

Generar un proyecto Terraform

Puedes generar un nuevo proyecto Terraform de dos formas:

VSCode

1. Instale el Nx Console VSCode Plugin si aún no lo ha hecho
2. Abra la consola Nx en VSCode
3. Haga clic en Generate (UI) en la sección "Common Nx Commands"
4. Busque @aws/nx-plugin - terraform#project
5. Complete los parámetros requeridos
   • name: tf-infra
6. Haga clic en Generate

CLI

pnpm

pnpm nx g @aws/nx-plugin:terraform#project --name=tf-infra

yarn

yarn nx g @aws/nx-plugin:terraform#project --name=tf-infra

npm

npx nx g @aws/nx-plugin:terraform#project --name=tf-infra

bun

bunx nx g @aws/nx-plugin:terraform#project --name=tf-infra

También puede realizar una ejecución en seco para ver qué archivos se cambiarían

pnpm

pnpm nx g @aws/nx-plugin:terraform#project --name=tf-infra --dry-run

yarn

yarn nx g @aws/nx-plugin:terraform#project --name=tf-infra --dry-run

npm

npx nx g @aws/nx-plugin:terraform#project --name=tf-infra --dry-run

bun

bunx nx g @aws/nx-plugin:terraform#project --name=tf-infra --dry-run

Opciones

Parámetro	Tipo	Predeterminado	Descripción
name Requerido	string	-	El nombre del proyecto.
type	string	application	Si esto es una lib de terraform (módulos reutilizables) o app (desplegable).
directory	string	packages	El directorio del nuevo proyecto.
subDirectory	string	-	El subdirectorio en el que se coloca el proyecto. Por defecto, este es el nombre del proyecto.

Resultado del generador

El generador crea diferentes estructuras de archivos según el tipo de proyecto:

Tipo Aplicación

Para proyectos de aplicación (--type=application), el generador crea una aplicación Terraform completa con gestión de estado remoto:

• Directoriosrc

  • main.tf Archivo principal de configuración de Terraform
  • providers.tf Configuración de proveedores con backend S3
  • variables.tf Definiciones de variables de entrada
  • outputs.tf Definiciones de valores de salida
  • Directorioenv Archivos de variables específicas del entorno

    • dev.tfvars Variables de entorno de desarrollo
• Directoriobootstrap Configuración de bootstrap para estado remoto

  • main.tf Bucket S3 y políticas para almacenamiento de estado
  • providers.tf Configuración del proveedor AWS
  • variables.tf Definiciones de variables de bootstrap
• project.json Configuración del proyecto y objetivos de construcción

Módulos Terraform compartidos

El generador también crea una biblioteca packages/common/terraform que inicialmente solo agrega un módulo de métricas (crea una pila CloudFormation vacía con metadatos) que se instrumenta automáticamente para que el equipo nx-plugin-for-aws pueda rastrear métricas de uso.

Tipo Biblioteca

Para proyectos de biblioteca (--type=library), el generador crea una estructura más simple para módulos Terraform reutilizables:

• Directoriosrc

  • main.tf Archivo principal del módulo Terraform
• project.json Configuración del proyecto y objetivos de construcción

Aplicación vs biblioteca

Los proyectos de aplicación incluyen capacidades completas de despliegue con gestión de estado remoto, mientras que los proyectos de biblioteca están diseñados para crear módulos Terraform reutilizables que pueden ser consumidos por otros proyectos.

Implementando tu infraestructura Terraform

Puedes comenzar a escribir tu infraestructura Terraform en src/main.tf, por ejemplo:

src/main.tf

locals {
  account_id = data.aws_caller_identity.current.account_id
  aws_region = data.aws_region.current.id
}

resource "null_resource" "print_info" {
  # triggers = {
  #   always_run = timestamp()
  # }

  provisioner "local-exec" {
    command = "echo 'AWS Region: ${local.aws_region}, AWS Account: ${local.account_id}, Environment: ${var.environment}'"
  }
}

# Declara tu infraestructura aquí
resource "aws_s3_bucket" "my_bucket" {
  bucket = "my-unique-bucket-name"
}

Dependencias entre proyectos

Si deseas ejecutar un módulo de otro proyecto (biblioteca), puedes hacerlo de la siguiente manera:

module "lib_module" {
  source = "../../path/to/my-lib/src"
}

Esto actualizará automáticamente el grafo de Nx para agregar una dependencia entre tu aplicación consumidora y tu biblioteca.

Configuración del entorno

Configura variables específicas del entorno en los archivos src/env/*.tfvars.

Para agregar nuevos entornos, crea un nuevo archivo src/env/<entorno>.tfvars con las variables específicas y agrega nuevas entradas para apply, destroy, init, plan en el project.json para la nueva configuración. Por ejemplo, supongamos que queremos agregar un entorno prod:

src/env/prod.tfvars

# Production environment variables
environment = "prod"
region      = "us-west-2"

project.json

{
  "targets": {
        "apply": {
            "executor": "nx:run-commands",
            "defaultConfiguration": "dev",
            "configurations": {
                "dev": {
                    "command": "terraform apply ../../../dist/packages/infra/terraform/dev.tfplan"
                },
                "prod": {
                    "command": "terraform apply ../../../dist/packages/infra/terraform/prod.tfplan"
                }
            },
            "options": {
                "forwardAllArgs": true,
                "cwd": "{projectRoot}/src"
            },
            "dependsOn": ["plan"]
        },
        "destroy": {
            "executor": "nx:run-commands",
            "defaultConfiguration": "dev",
            "configurations": {
                "dev": {
                    "command": "terraform destroy -var-file=env/dev.tfvars"
                },
                "prod": {
                    "command": "terraform destroy -var-file=env/prod.tfvars"
                }
            },
            "options": {
                "forwardAllArgs": true,
                "cwd":"{projectRoot}/src"
            },
            "dependsOn": ["init"]
        },
        "init": {
            "executor": "nx:run-commands",
            "defaultConfiguration": "dev",
            "configurations": {
                "dev": {
                    "command": "terraform init -reconfigure -backend-config=\"region=$(aws configure get region)\" -backend-config=\"bucket=$(aws sts get-caller-identity --query Account --output text)-tf-state-$(aws configure get region)\" -backend-config=\"key=my-scope-my-project/dev/terraform.tfstate\""
                },
                "prod": {
                    "command": "terraform init -reconfigure -backend-config=\"region=$(aws configure get region)\" -backend-config=\"bucket=$(aws sts get-caller-identity --query Account --output text)-tf-state-$(aws configure get region)\" -backend-config=\"key=my-scope-my-project/prod/terraform.tfstate\""
                }
            },
            "options": {
                "forwardAllArgs": true,
                "cwd": "{projectRoot}/src"
            }
        },
        "plan": {
            "executor": "nx:run-commands",
            "defaultConfiguration": "dev",
            "configurations": {
                "dev": {
                    "command": "terraform plan -var-file=env/dev.tfvars -out=../../../dist/packages/infra/terraform/dev.tfplan"
                },
                "prod": {
                    "command": "terraform plan -var-file=env/dev.tfvars -out=../../../dist/packages/infra/terraform/prod.tfplan"
                }
            },
            "options": {
                "forwardAllArgs": true,
                "cwd": "{projectRoot}/src"
            },
            "dependsOn": ["init"]
        }
    }
}

Entorno predeterminado

Por defecto, todos los objetivos asumen el entorno dev, pero puedes especificar un entorno con:

• pnpm
• yarn
• npm
• bun

pnpm nx apply tf-infra --configuration=prod

yarn nx apply tf-infra --configuration=prod

npx nx apply tf-infra --configuration=prod

bunx nx apply tf-infra --configuration=prod

Puedes cambiar de entorno en cualquier momento ya que el estado segmenta automáticamente el tfstate entre entornos.

Bootstrap de estado remoto (solo proyectos aplicación)

Para proyectos de aplicación, antes de desplegar tu infraestructura, necesitas ejecutar el bootstrap del backend de estado remoto. Esto crea un bucket S3 para almacenar tus archivos de estado de Terraform:

pnpm

pnpm nx bootstrap tf-infra

yarn

yarn nx bootstrap tf-infra

npm

npx nx bootstrap tf-infra

bun

bunx nx bootstrap tf-infra

Configuración del perfil de AWS

Asegúrate de que tu perfil de AWS CLI esté configurado para la cuenta/región donde deseas desplegar los recursos de bootstrap.

El objetivo bootstrap solo está disponible para proyectos de tipo aplicación. Los proyectos biblioteca no requieren gestión de estado remoto ya que están diseñados para ser módulos reutilizables.

Objetivos disponibles

Los objetivos disponibles dependen del tipo de proyecto:

Objetivos comunes (aplicación y biblioteca)

Validar tu infraestructura

Puedes validar tu configuración Terraform con el objetivo validate:

pnpm

pnpm nx validate tf-infra

yarn

yarn nx validate tf-infra

npm

npx nx validate tf-infra

bun

bunx nx validate tf-infra

Formatear tu código

Formatea tu código Terraform con el objetivo fmt:

pnpm

pnpm nx fmt tf-infra

yarn

yarn nx fmt tf-infra

npm

npx nx fmt tf-infra

bun

bunx nx fmt tf-infra

Pruebas de seguridad

Ejecuta verificaciones de seguridad en tu infraestructura con Checkov usando el objetivo test:

pnpm

pnpm nx test tf-infra

yarn

yarn nx test tf-infra

npm

npx nx test tf-infra

bun

bunx nx test tf-infra

Encontrarás los resultados de las pruebas de seguridad en la carpeta dist raíz, bajo dist/packages/<mi-proyecto-terraform>/checkov.

Objetivos exclusivos de aplicación

Los siguientes objetivos solo están disponibles para proyectos de tipo aplicación:

Planificar tu infraestructura

Antes de aplicar cambios, puedes ver lo que Terraform hará ejecutando el objetivo plan:

pnpm

pnpm nx plan tf-infra

yarn

yarn nx plan tf-infra

npm

npx nx plan tf-infra

bun

bunx nx plan tf-infra

Esto creará un archivo de plan en dist/packages/<mi-proyecto-terraform>/terraform/dev.tfplan.

Inicializar Terraform

Inicializa tu directorio de trabajo de Terraform con el objetivo init:

pnpm

pnpm nx run tf-infra:init

yarn

yarn nx run tf-infra:init

npm

npx nx run tf-infra:init

bun

bunx nx run tf-infra:init

Desplegar en AWS

Después de planificar, puedes desplegar tu infraestructura en AWS con el objetivo apply:

pnpm

pnpm nx apply tf-infra

yarn

yarn nx apply tf-infra

npm

npx nx apply tf-infra

bun

bunx nx apply tf-infra

Aprobación automática

El comando anterior aplica el plan creado por el objetivo plan. Asegúrate de ejecutar plan primero para revisar los cambios.

Obtener outputs

Recupera valores de salida de tu configuración Terraform:

pnpm

pnpm nx output tf-infra

yarn

yarn nx output tf-infra

npm

npx nx output tf-infra

bun

bunx nx output tf-infra

Destruir infraestructura

Cuando necesites eliminar tu infraestructura, usa el objetivo destroy:

pnpm

pnpm nx destroy tf-infra

yarn

yarn nx destroy tf-infra

npm

npx nx destroy tf-infra

bun

bunx nx destroy tf-infra

Operación destructiva

Esto eliminará permanentemente todos los recursos gestionados por esta configuración Terraform. ¡Usa con precaución!

Destruir recursos de bootstrap

Para eliminar los recursos de bootstrap (bucket S3 para almacenamiento de estado):

pnpm

pnpm nx bootstrap-destroy tf-infra

yarn

yarn nx bootstrap-destroy tf-infra

npm

npx nx bootstrap-destroy tf-infra

bun

bunx nx bootstrap-destroy tf-infra

Más información

Para más información sobre Terraform, consulta la Documentación de Terraform y la Documentación del proveedor AWS.