Docker Build Push Action (Comment cela fonctionne pour les développeurs)

Automatisation sans friction

Construire et pousser des images Docker manuellement est exposé, sujet aux erreurs et chronophage. Automatiser ces étapes garantit la prévisibilité et ajoute des heures au résultat net, surtout lorsque l'équipe se développe ou que les mises à jour sont plus fréquentes.

Intégration sans friction

L'action Docker Build Push fonctionne directement avec les dépôts GitHub pour créer des flux de travail autour d'événements tels que les pushs de code, les pull requests ou un calendrier.

Construction standard d'images

L'automatisation garantit que chaque fois que des images Docker sont construites, elles sont identiques ; d'où la réduction des erreurs/écarts à travers plusieurs environnements tels que le développement, la mise en scène et la production.

Déploiement facile

Avec la construction automatique d'images Docker avec la construction, et leur poussée vers les référentiels, le déploiement peut devenir relativement facile. Des outils comme Kubernetes ou Docker Swarm peuvent être utilisés pour tirer ou construire des images multiplateformes directement à partir du registre Docker, réduisant ainsi le temps d'arrêt.

Comment fonctionne l'action Docker Build Push

L'action de construction et de poussée de Docker fait trois choses principales:

1. Configurer la connexion Docker : Authentification du registre de conteneurs pour pousser en toute sécurité des images Docker.
2. Construction d'image : Exécute des commandes de construction Docker en utilisant un Dockerfile qui contient des instructions.
3. Pousser vers le registre : Pousse l'image construite vers un registre de conteneurs cible.

Ces étapes sont définies dans un fichier de workflow GitHub Actions (.github/workflows/your-workflow.yml), où vous spécifiez les déclencheurs, les configurations de construction et les identifiants de registre.

Implémenter l'action Docker Build Push

1 : Préparez votre référentiel

• Ajoutez un Dockerfile décrivant l'application containerisée.
• Ajoutez tous les fichiers de configuration ou scripts nécessaires pour la construction.

# 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 : Ajouter les identifiants de registre en tant que secrets GitHub

Pour construire et pousser des images Docker vers un registre de conteneurs, vous avez besoin d'identifiants. Ajoutez-les en tant que secrets GitHub :

• Allez dans les paramètres de votre référentiel sur GitHub.
• Allez sur Secrets et Variables > Actions.

Ajoutez les secrets suivants :

• USERNAME : Votre nom d'utilisateur Docker Hub.
• PASSWORD: Votre jeton d'accès Docker Hub ou mot de passe.

Pour d'autres registres, c'est similaire mais parfois nécessite des identifiants supplémentaires, par exemple, AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY pour Amazon ECR.

3 : Créer un workflow GitHub Actions

Ajoutez la ligne ci-dessous dans le fichier de workflow YAML à .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

Pousser vers Main : Le workflow se déclenchera à chaque poussée qui se produit sur la branche principale.

Vérifier le code : Utilisez l'action actions/checkout pour vérifier le référentiel.

Connexion au registre : Authentifiez-vous avec Docker Hub en utilisant les secrets fournis.

Construire et pousser : Exécute l'action Docker Build Push pour construire l'image du répertoire actuel vers nomutilisateur/référentiel : latest.

Validez le fichier de workflow dans votre référentiel. Avec une simple poussée, le workflow se déclenchera pour construire l'image et la pousser dans le registre spécifié.