El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia
HOME Mis cursos Finalizados
◄ Anterior
◄

Introducción a los Módulos

Siguiente ►
►

¿Qué son los Módulos en Terraform?

Los módulos en Terraform son un conjunto de archivos de configuración que se agrupan para gestionar recursos relacionados. Los módulos permiten organizar y reutilizar el código de Terraform, facilitando la gestión de infraestructuras complejas y promoviendo la reutilización de configuraciones.

Conceptos Clave

  • Módulo raíz: Es el módulo principal que se ejecuta cuando se aplica una configuración de Terraform. Incluye todos los archivos .tf en el directorio de trabajo.
  • Módulo hijo: Es un módulo que se invoca desde otro módulo (puede ser el módulo raíz u otro módulo hijo).
  • Reutilización: Los módulos permiten reutilizar configuraciones de infraestructura, lo que reduce la duplicación de código y facilita el mantenimiento.

Estructura de un Módulo

Un módulo en Terraform generalmente contiene los siguientes archivos:

  • main.tf: Define los recursos principales del módulo.
  • variables.tf: Define las variables de entrada del módulo.
  • outputs.tf: Define las salidas del módulo.
  • README.md: Documentación del módulo (opcional pero recomendado).

Ejemplo de Estructura de Módulo

my-module/
├── main.tf
├── variables.tf
├── outputs.tf
└── README.md

Creando un Módulo Simple

Vamos a crear un módulo simple que gestione un recurso de AWS S3 bucket.

Paso 1: Crear el Directorio del Módulo

Crea un directorio llamado s3_bucket_module y dentro de este directorio, crea los archivos main.tf, variables.tf y outputs.tf.

Paso 2: Definir el Recurso en main.tf

// main.tf
resource "aws_s3_bucket" "example" {
  bucket = var.bucket_name
  acl    = var.acl

  tags = {
    Name        = var.bucket_name
    Environment = var.environment
  }
}

Paso 3: Definir las Variables en variables.tf

// variables.tf
variable "bucket_name" {
  description = "The name of the S3 bucket"
  type        = string
}

variable "acl" {
  description = "The ACL of the S3 bucket"
  type        = string
  default     = "private"
}

variable "environment" {
  description = "The environment for the S3 bucket"
  type        = string
  default     = "dev"
}

Paso 4: Definir las Salidas en outputs.tf

// outputs.tf
output "bucket_arn" {
  description = "The ARN of the S3 bucket"
  value       = aws_s3_bucket.example.arn
}

output "bucket_name" {
  description = "The name of the S3 bucket"
  value       = aws_s3_bucket.example.bucket
}

Usando el Módulo

Para usar el módulo que acabamos de crear, necesitamos invocarlo desde otro archivo de configuración de Terraform.

Ejemplo de Uso del Módulo

// main.tf
module "s3_bucket" {
  source      = "./s3_bucket_module"
  bucket_name = "my-unique-bucket-name"
  acl         = "private"
  environment = "production"
}

En este ejemplo, estamos invocando el módulo s3_bucket_module y pasando los valores necesarios para las variables definidas en variables.tf.

Ejercicio Práctico

Ejercicio

  1. Crea un módulo llamado ec2_instance_module que gestione una instancia de EC2 en AWS.
  2. Define las variables necesarias para el módulo, como instance_type, ami, y key_name.
  3. Define las salidas del módulo, como instance_id y public_ip.

Solución

Estructura del Módulo

ec2_instance_module/
├── main.tf
├── variables.tf
├── outputs.tf
└── README.md

main.tf

// main.tf
resource "aws_instance" "example" {
  ami           = var.ami
  instance_type = var.instance_type
  key_name      = var.key_name

  tags = {
    Name = "ExampleInstance"
  }
}

variables.tf

// variables.tf
variable "ami" {
  description = "The AMI to use for the instance"
  type        = string
}

variable "instance_type" {
  description = "The type of instance to use"
  type        = string
  default     = "t2.micro"
}

variable "key_name" {
  description = "The key name to use for the instance"
  type        = string
}

outputs.tf

// outputs.tf
output "instance_id" {
  description = "The ID of the EC2 instance"
  value       = aws_instance.example.id
}

output "public_ip" {
  description = "The public IP of the EC2 instance"
  value       = aws_instance.example.public_ip
}

Resumen

En esta sección, hemos aprendido qué son los módulos en Terraform, cómo estructurarlos y cómo crear y usar un módulo simple. Los módulos son una herramienta poderosa para organizar y reutilizar configuraciones de infraestructura, lo que facilita la gestión de infraestructuras complejas. En la próxima sección, profundizaremos en cómo crear y usar módulos más avanzados.

◄ Anterior
◄
Siguiente ►
►
El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia
© Copyright 2024. Todos los derechos reservados