Docker Build Push Action (Cómo funciona para desarrolladores)

Automatización sin fricciones

Construir y enviar imágenes Docker manualmente está expuesto, es propenso a errores y consume tiempo. Automatizar estos pasos asegura predictibilidad y añade horas al final de la línea, especialmente cuando el equipo escala o cuando las actualizaciones son más frecuentes.

Integración sin fricciones

La acción Docker Build Push funciona de forma inmediata con los repositorios de GitHub para crear flujos de trabajo relacionados con eventos como empujes de código, solicitudes de extracción o un cronograma.

Construcción estándar de imágenes

La automatización asegura que cada vez que se construyan imágenes Docker, sean iguales; así, reduciendo errores/discrepancias en múltiples entornos como desarrollo, prueba y producción.

Despliegue sencillo

Con la construcción automática de imágenes Docker con la construcción, y su envío a los repositorios, el despliegue puede ser relativamente sencillo. Herramientas como Kubernetes o Docker Swarm pueden ser usadas para sacar o construir imágenes multi-plataforma directamente desde el registro Docker, y así reducir el tiempo de inactividad.

Cómo funciona la acción push de compilación de Docker

La acción Build and Push Docker realiza tres cosas básicas:

1. Configurar el inicio de sesión de Docker: Autenticación del registro de contenedores para enviar imágenes Docker de manera segura.
2. Construcción de la imagen: Ejecuta comandos de construcción Docker usando un archivo Dockerfile que contiene instrucciones.
3. Envío al registro: Envía la imagen construida a un registro de contenedor objetivo.

Estos pasos se definen en un archivo de flujo de trabajo de GitHub Actions (.github/workflows/your-workflow.yml), donde se especifican disparadores, configuraciones de construcción y credenciales de registro.

Implementar la acción de push de compilación de Docker

1: Preparar tu repositorio

• Añadir un archivo Dockerfile que describa la aplicación containerizada.
• Añadir cualquier archivo de configuración o script requerido para la construcción.

# Use Node.js as the base image
FROM node:14

# Set the working directory
WORKDIR /app

# Copy package.json and install dependencies
COPY package.json .
RUN npm install

# Copy the application code
COPY . .

# Expose the application’s port
EXPOSE 3000

# Start the application
CMD ["npm", "start"]

2: Añadir credenciales de registro como secretos de GitHub

Para construir y enviar imágenes Docker a un registro de contenedor, necesitas credenciales. Añade estos como secretos de GitHub:

• Ingresa en la configuración de tu repositorio en GitHub.
• Ve a Secretos y Variables > Acciones.

Añade los siguientes secretos:

• USERNAME: Tu nombre de usuario de Docker Hub.
• PASSWORD: Tu token de acceso o contraseña de Docker Hub.

Para otros registros, esto es similar pero a veces requiere credenciales adicionales, por ejemplo, AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY para Amazon ECR.

3: Crear el flujo de trabajo de GitHub Actions

Añadir la línea de abajo en el archivo de flujo de trabajo YAML en .github/workflows/docker-build-push.yml.

name: Docker Build and Push

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      # Step 1: Check out the repository
      - name: Checkout code
        uses: actions/checkout@v3

      # Step 2: Log in to Docker Hub
      - name: Log in to Docker Hub
        uses: docker/login-action@v2
        with:
          username: ${{ secrets.USERNAME }}
          password: ${{ secrets.PASSWORD }}

      # Step 3: Build and push the Docker image
      - name: Build and push
        uses: docker/build-push-action@v4
        with:
          context: .
          push: true
          tags: username/repository:latest

name: Docker Build and Push

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      # Step 1: Check out the repository
      - name: Checkout code
        uses: actions/checkout@v3

      # Step 2: Log in to Docker Hub
      - name: Log in to Docker Hub
        uses: docker/login-action@v2
        with:
          username: ${{ secrets.USERNAME }}
          password: ${{ secrets.PASSWORD }}

      # Step 3: Build and push the Docker image
      - name: Build and push
        uses: docker/build-push-action@v4
        with:
          context: .
          push: true
          tags: username/repository:latest

Enviar a Main: El flujo de trabajo se activará cada envío que ocurra en la rama principal.

Revisar código: Utilizar la acción actions/checkout para revisar el repositorio.

Iniciar sesión en el registro: Autenticarse con Docker Hub usando los secretos proporcionados.

Construir y Enviar: Ejecuta la Acción Docker Build Push que construirá la imagen desde el directorio actual hasta el contexto y la enviará a nombredeusuario/repositorio: última.

Enviar el archivo del flujo de trabajo a tu repositorio. Con un simple envío, el flujo de trabajo se activará para construir la imagen y enviarla a tu registro especificado.