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

Uso de Terraform con GitHub Actions

Siguiente ►
►

En este tema, aprenderás cómo integrar Terraform con GitHub Actions para automatizar el despliegue de infraestructura como código (IaC). GitHub Actions es una plataforma de CI/CD que permite automatizar flujos de trabajo directamente desde tu repositorio de GitHub.

Objetivos

  • Entender los conceptos básicos de GitHub Actions.
  • Configurar un flujo de trabajo de GitHub Actions para ejecutar Terraform.
  • Implementar un pipeline de CI/CD para desplegar infraestructura con Terraform.

Conceptos Básicos de GitHub Actions

GitHub Actions permite crear flujos de trabajo personalizados que se ejecutan en respuesta a eventos en tu repositorio de GitHub. Los componentes clave son:

  • Workflows (Flujos de trabajo): Definiciones de procesos automatizados que se ejecutan en respuesta a eventos.
  • Jobs (Trabajos): Un conjunto de pasos que se ejecutan en un mismo entorno.
  • Steps (Pasos): Tareas individuales que se ejecutan como parte de un trabajo.
  • Actions (Acciones): Comandos o scripts que se ejecutan en los pasos.

Configuración del Flujo de Trabajo

Paso 1: Crear un Repositorio de GitHub

  1. Ve a GitHub y crea un nuevo repositorio.
  2. Clona el repositorio en tu máquina local.

Paso 2: Crear un Archivo de Flujo de Trabajo

  1. En tu repositorio, crea un directorio .github/workflows.
  2. Dentro de este directorio, crea un archivo YAML, por ejemplo, terraform.yml.

Ejemplo de Archivo YAML

name: Terraform CI/CD

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  terraform:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Setup Terraform
      uses: hashicorp/setup-terraform@v1
      with:
        terraform_version: 1.0.0

    - name: Terraform Init
      run: terraform init

    - name: Terraform Plan
      run: terraform plan

    - name: Terraform Apply
      if: github.ref == 'refs/heads/main'
      run: terraform apply -auto-approve

Explicación del Archivo YAML

  • name: Nombre del flujo de trabajo.
  • on: Eventos que desencadenan el flujo de trabajo (push y pull_request en la rama main).
  • jobs: Define los trabajos que se ejecutarán.
    • runs-on: Especifica el sistema operativo del entorno de ejecución (ubuntu-latest).
    • steps: Lista de pasos a ejecutar.
      • Checkout code: Usa la acción actions/checkout@v2 para clonar el repositorio.
      • Setup Terraform: Usa la acción hashicorp/setup-terraform@v1 para instalar Terraform.
      • Terraform Init: Ejecuta terraform init para inicializar el directorio de trabajo.
      • Terraform Plan: Ejecuta terraform plan para crear un plan de ejecución.
      • Terraform Apply: Ejecuta terraform apply -auto-approve para aplicar los cambios, solo si la rama es main.

Ejercicio Práctico

Ejercicio 1: Configurar y Ejecutar un Flujo de Trabajo Básico

  1. Crea un archivo main.tf en el directorio raíz de tu repositorio con el siguiente contenido:
provider "aws" {
  region = "us-west-2"
}

resource "aws_s3_bucket" "example" {
  bucket = "my-unique-bucket-name-12345"
  acl    = "private"
}
  1. Añade y comete los cambios en tu repositorio:
git add .
git commit -m "Add Terraform configuration"
git push origin main
  1. Ve a la pestaña "Actions" en tu repositorio de GitHub para ver el flujo de trabajo en acción.

Solución del Ejercicio

Si todo está configurado correctamente, deberías ver que el flujo de trabajo se ejecuta y despliega la infraestructura definida en main.tf.

Retroalimentación y Consejos

  • Errores Comunes:

    • Error de Autenticación: Asegúrate de que tus credenciales de AWS estén configuradas correctamente en GitHub Secrets.
    • Errores de Sintaxis: Verifica que tu archivo YAML no tenga errores de sintaxis.
    • Permisos Insuficientes: Asegúrate de que la cuenta de GitHub tenga los permisos necesarios para ejecutar acciones.

  • Consejos Adicionales:

    • Usa Variables de Entorno: Almacena las credenciales y otros datos sensibles en GitHub Secrets y accede a ellos en tu flujo de trabajo.
    • Pruebas en Ramas de Desarrollo: Ejecuta terraform plan en ramas de desarrollo antes de aplicar cambios en la rama main.

Conclusión

En esta sección, aprendiste cómo integrar Terraform con GitHub Actions para automatizar el despliegue de infraestructura. Configuraste un flujo de trabajo básico que ejecuta comandos de Terraform en respuesta a eventos en tu repositorio. Esta integración te permite implementar un pipeline de CI/CD eficiente y seguro para gestionar tu infraestructura como código.

En el siguiente tema, exploraremos cómo utilizar Terraform Cloud y Enterprise para mejorar aún más la gestión y el despliegue de tu infraestructura.

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