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

Funciones de Terraform

Siguiente ►
►

Introducción

Las funciones en Terraform son herramientas poderosas que permiten manipular y transformar datos dentro de las configuraciones de Terraform. Estas funciones pueden ser utilizadas para realizar operaciones matemáticas, manipular cadenas de texto, trabajar con listas y mapas, y mucho más. En este módulo, exploraremos las funciones más comunes y cómo utilizarlas en tus configuraciones de Terraform.

Tipos de Funciones

Terraform proporciona una amplia variedad de funciones que se pueden clasificar en las siguientes categorías:

  1. Funciones de Cadena: Manipulación de cadenas de texto.
  2. Funciones de Colección: Operaciones en listas y mapas.
  3. Funciones de Control de Tipo: Verificación y conversión de tipos de datos.
  4. Funciones de Fecha y Hora: Manipulación de fechas y horas.
  5. Funciones de Red: Operaciones relacionadas con redes.
  6. Funciones de Operación: Operaciones matemáticas y lógicas.

Funciones de Cadena

Las funciones de cadena permiten manipular y transformar cadenas de texto. Algunas de las funciones más comunes son:

  • upper(string): Convierte una cadena a mayúsculas.
  • lower(string): Convierte una cadena a minúsculas.
  • length(string): Devuelve la longitud de una cadena.
  • substr(string, offset, length): Extrae una subcadena de una cadena.

Ejemplo Práctico

variable "example_string" {
  default = "Hello, Terraform!"
}

output "upper_string" {
  value = upper(var.example_string)
}

output "lower_string" {
  value = lower(var.example_string)
}

output "string_length" {
  value = length(var.example_string)
}

output "substring" {
  value = substr(var.example_string, 7, 9)
}

Explicación:

  • upper(var.example_string): Convierte "Hello, Terraform!" a "HELLO, TERRAFORM!".
  • lower(var.example_string): Convierte "Hello, Terraform!" a "hello, terraform!".
  • length(var.example_string): Devuelve 17, que es la longitud de "Hello, Terraform!".
  • substr(var.example_string, 7, 9): Extrae "Terraform" de "Hello, Terraform!".

Funciones de Colección

Las funciones de colección permiten trabajar con listas y mapas. Algunas de las funciones más comunes son:

  • length(list): Devuelve la longitud de una lista.
  • element(list, index): Devuelve el elemento en el índice especificado.
  • concat(list1, list2, ...): Concatena múltiples listas.
  • merge(map1, map2, ...): Combina múltiples mapas en uno solo.

Ejemplo Práctico

variable "example_list" {
  default = ["one", "two", "three"]
}

variable "example_map" {
  default = {
    key1 = "value1"
    key2 = "value2"
  }
}

output "list_length" {
  value = length(var.example_list)
}

output "second_element" {
  value = element(var.example_list, 1)
}

output "merged_map" {
  value = merge(var.example_map, {key3 = "value3"})
}

Explicación:

  • length(var.example_list): Devuelve 3, que es la longitud de la lista ["one", "two", "three"].
  • element(var.example_list, 1): Devuelve "two", que es el segundo elemento de la lista.
  • merge(var.example_map, {key3 = "value3"}): Devuelve {key1 = "value1", key2 = "value2", key3 = "value3"}.

Funciones de Control de Tipo

Las funciones de control de tipo permiten verificar y convertir tipos de datos. Algunas de las funciones más comunes son:

  • type(value): Devuelve el tipo de un valor.
  • tostring(value): Convierte un valor a una cadena.
  • tolist(value): Convierte un valor a una lista.
  • tomap(value): Convierte un valor a un mapa.

Ejemplo Práctico

variable "example_value" {
  default = 123
}

output "value_type" {
  value = type(var.example_value)
}

output "value_as_string" {
  value = tostring(var.example_value)
}

Explicación:

  • type(var.example_value): Devuelve "number", que es el tipo del valor 123.
  • tostring(var.example_value): Convierte 123 a la cadena "123".

Funciones de Fecha y Hora

Las funciones de fecha y hora permiten manipular y formatear fechas y horas. Algunas de las funciones más comunes son:

  • timestamp(): Devuelve la hora actual en formato UTC.
  • formatdate(format, timestamp): Formatea una fecha y hora según el formato especificado.

Ejemplo Práctico

output "current_timestamp" {
  value = timestamp()
}

output "formatted_date" {
  value = formatdate("YYYY-MM-DD", timestamp())
}

Explicación:

  • timestamp(): Devuelve la hora actual en formato UTC.
  • formatdate("YYYY-MM-DD", timestamp()): Formatea la fecha actual en el formato "YYYY-MM-DD".

Funciones de Red

Las funciones de red permiten realizar operaciones relacionadas con redes. Algunas de las funciones más comunes son:

  • cidrsubnet(prefix, newbits, netnum): Calcula una subred CIDR.
  • cidrhost(prefix, hostnum): Calcula una dirección IP dentro de una subred CIDR.

Ejemplo Práctico

variable "example_cidr" {
  default = "192.168.0.0/16"
}

output "subnet" {
  value = cidrsubnet(var.example_cidr, 8, 1)
}

output "host_ip" {
  value = cidrhost(var.example_cidr, 10)
}

Explicación:

  • cidrsubnet(var.example_cidr, 8, 1): Calcula la subred "192.168.1.0/24".
  • cidrhost(var.example_cidr, 10): Calcula la dirección IP "192.168.0.10".

Funciones de Operación

Las funciones de operación permiten realizar operaciones matemáticas y lógicas. Algunas de las funciones más comunes son:

  • abs(number): Devuelve el valor absoluto de un número.
  • max(number1, number2, ...): Devuelve el valor máximo de una lista de números.
  • min(number1, number2, ...): Devuelve el valor mínimo de una lista de números.

Ejemplo Práctico

variable "example_numbers" {
  default = [1, -2, 3, -4, 5]
}

output "absolute_value" {
  value = abs(var.example_numbers[1])
}

output "maximum_value" {
  value = max(var.example_numbers...)
}

output "minimum_value" {
  value = min(var.example_numbers...)
}

Explicación:

  • abs(var.example_numbers[1]): Devuelve 2, que es el valor absoluto de -2.
  • max(var.example_numbers...): Devuelve 5, que es el valor máximo de la lista [1, -2, 3, -4, 5].
  • min(var.example_numbers...): Devuelve -4, que es el valor mínimo de la lista [1, -2, 3, -4, 5].

Ejercicio Práctico

Ejercicio

  1. Define una variable de tipo lista con los nombres de tres ciudades.
  2. Usa una función de cadena para convertir todos los nombres de las ciudades a mayúsculas.
  3. Usa una función de colección para obtener el segundo nombre de la lista.
  4. Usa una función de control de tipo para convertir el segundo nombre a una cadena (si no lo es ya).

Solución

variable "cities" {
  default = ["New York", "Los Angeles", "Chicago"]
}

output "cities_upper" {
  value = [for city in var.cities : upper(city)]
}

output "second_city" {
  value = element(var.cities, 1)
}

output "second_city_as_string" {
  value = tostring(element(var.cities, 1))
}

Explicación:

  • upper(city): Convierte cada nombre de ciudad a mayúsculas.
  • element(var.cities, 1): Obtiene "Los Angeles", que es el segundo nombre de la lista.
  • tostring(element(var.cities, 1)): Convierte "Los Angeles" a una cadena (aunque ya lo es).

Conclusión

Las funciones de Terraform son herramientas esenciales para manipular y transformar datos dentro de tus configuraciones. Al dominar estas funciones, puedes crear configuraciones más dinámicas y flexibles. En el próximo módulo, exploraremos los bloques dinámicos y cómo pueden ayudarte a simplificar y optimizar tus configuraciones de Terraform.

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