MCC - Implementación CI/CD con Github Actions

Pipeline para GitHub Actions: Build y Push de Imágenes Docker Multi-arch

Creación del pipeline para GitHub Actions, que realiza las pruebas de HTML, construye la imagen Docker usando docker buildx para plataformas AMD64 y ARM64, y la publica en Docker Hub.

1. Pre-requisitos

Tener configuradas tus credenciales de Docker Hub en los Secrets de GitHub:

DOCKER_HUB_USERNAME: Tu nombre de usuario de Docker Hub.
DOCKER_HUB_PASSWORD: Tu contraseña o token de Docker Hub.
DOCKER_HUB_REPO: Nombre del repositorio en Docker Hub (por ejemplo: miusuario/mirepositorio).

Puedes agregar estos secrets desde tu repositorio en GitHub, navegando a Settings > Secrets and variables > Actions y añadiéndolos ahí.

2. Configuración de GitHub Actions (.github/workflows/docker_build.yml)

name: Build and Push Docker Image

on:

 push:
   branches:
     - main  # Ejecutar en la rama principal
 pull_request:
   branches:
     - main

jobs:

 # Job para validar el HTML
 html_validation:
   runs-on: ubuntu-latest
   steps:
     - name: Check out the code
       uses: actions/checkout@v3

     - name: Set up Node.js
       uses: actions/setup-node@v3
       with:
         node-version: '14'

     - name: Install htmlhint
       run: npm install -g htmlhint

     - name: Validate HTML
       run: htmlhint public-html/**/*.html  # Cambia según la estructura de tu proyecto

 # Job para construir la imagen Docker multi-arch
 docker_build:
   needs: html_validation
   runs-on: ubuntu-latest
   steps:
     - name: Check out the code
       uses: actions/checkout@v3

     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v2

     - name: Log in to Docker Hub
       uses: docker/login-action@v2
       with:
         username: $Plantilla:Secrets.DOCKER HUB USERNAME
         password: $Plantilla:Secrets.DOCKER HUB PASSWORD

     - name: Build and push Docker image (AMD64, ARM64)
       run: |
         docker buildx create --use
         docker buildx inspect --bootstrap
         docker buildx build --platform linux/amd64,linux/arm64 -t $Plantilla:Secrets.DOCKER HUB REPO:latest --push .

 # (Opcional) Job para verificar que la imagen se ha subido correctamente
 docker_push:
   needs: docker_build
   runs-on: ubuntu-latest
   steps:
     - name: Log in to Docker Hub
       uses: docker/login-action@v2
       with:
         username: $Plantilla:Secrets.DOCKER HUB USERNAME
         password: $Plantilla:Secrets.DOCKER HUB PASSWORD

     - name: Pull the image to verify
       run: docker pull $Plantilla:Secrets.DOCKER HUB REPO:latest

Explicación

Trigger: El workflow se ejecuta cuando hay un push a la rama principal o cuando se abre un pull request a esa rama.
html_validation Job:
- Usa Node.js para instalar htmlhint y validar los archivos HTML ubicados en la carpeta public-html.
- Este job se ejecuta primero, y si falla, el pipeline se detiene.
docker_build Job:
- Se ejecuta solo si el job de validación HTML pasa.
- Usa docker buildx para construir la imagen Docker para ambas arquitecturas (AMD64 y ARM64).
- Publica la imagen directamente en Docker Hub usando --push.
docker_push Job (opcional):
- Este paso verifica que la imagen se haya subido correctamente a Docker Hub haciendo un docker pull de la imagen recién subida.

3. Ajustes Adicionales

Validación de HTML: Puedes ajustar el comando de htmlhint según la estructura de tu proyecto.
Tags en Docker: Puedes usar tags de versión o basados en commits en lugar de latest.

4. Configuración de Secrets en GitHub

Ve a Settings > Secrets and variables > Actions en tu repositorio y añade:

DOCKER_HUB_USERNAME: Tu usuario de Docker Hub.
DOCKER_HUB_PASSWORD: Tu token o contraseña de Docker Hub.
DOCKER_HUB_REPO: El nombre del repositorio en Docker Hub, como miusuario/mirepositorio.

Este pipeline te permite realizar pruebas en el HTML, construir imágenes Docker multi-arch y publicarlas en Docker Hub de manera automatizada con GitHub Actions.