Docker Build Push Action (Wie es für Entwickler funktioniert)

Reibungslose Automatisierung

Das manuelle Erstellen und Pushen von Docker-Images ist exponiert, fehleranfällig und zeitaufwendig. Die Automatisierung dieser Schritte gewährleistet Vorhersagbarkeit und fügt besonders dann Stunden hinzu, wenn das Team skaliert oder Updates häufiger werden.

Reibungslose Integration

Die Docker Build Push Action arbeitet direkt mit GitHub-Repositories, um Workflows rund um Ereignisse wie Code-Änderungen, Pull-Anfragen oder einen Zeitplan zu erstellen.

Standardisiertes Erstellen von Images

Automatisierung stellt sicher, dass jedes Mal, wenn Docker-Images gebaut werden, sie gleich sind; daher werden Fehler/Diskrepanzen über mehrere Umgebungen wie Entwicklung, Staging und Produktion reduziert.

Einfache Implementierung

Mit der automatisierten Erstellung von Docker-Images und deren Push in die Repositories kann die Implementierung relativ einfach werden. Tools wie Kubernetes oder Docker Swarm können verwendet werden, um Multi-Plattform-Images direkt aus dem Docker-Register zu ziehen oder zu erstellen, und reduzieren somit die Ausfallzeiten.

Wie die Docker Build Push Action funktioniert

Die Build und Push Docker Action macht drei Kernaufgaben:

1. Richten Sie Docker-Anmeldung ein: Container-Register-Authentifizierung, um Docker-Bilder sicher zu pushen.
2. Image Build: Führt Docker-Build-Befehle mithilfe einer Dockerfile aus, die Anweisungen enthält.
3. Push zum Register: Es pusht das erstellte Image zu einem Ziel-Container-Register.

Diese Schritte werden in einer GitHub Actions Workflow-Datei (.github/workflows/your-workflow.yml) definiert, in der Sie Trigger, Build-Konfigurationen und Registry-Anmeldeinformationen angeben.

Implementierung der Docker Build Push Action

1: Bereiten Sie Ihr Repository vor

• Fügen Sie eine Dockerfile hinzu, die die containerisierte Anwendung beschreibt.
• Fügen Sie alle Konfigurationsdateien oder Skripte hinzu, die für den Build erforderlich sind.

# 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: Fügen Sie Registry-Anmeldeinformationen als GitHub-Geheimnisse hinzu

Um Docker-Images zu einem Container-Register zu erstellen und zu pushen, benötigen Sie Anmeldeinformationen. Fügen Sie diese als GitHub-Geheimnisse hinzu:

• Gehen Sie zu Ihren Repository-Einstellungen auf GitHub.
• Gehen Sie zu Geheimnisse und Variablen > Aktionen.

Fügen Sie die folgenden Geheimnisse hinzu:

• USERNAME: Ihr Docker Hub-Benutzername.
• PASSWORD: Ihr Docker Hub-Zugriffstoken oder Passwort.

Für andere Register ist dies ähnlich, erfordert jedoch manchmal zusätzliche Anmeldeinformationen, zum Beispiel AWS_ACCESS_KEY_ID und AWS_SECRET_ACCESS_KEY für Amazon ECR.

3: Erstellen Sie einen GitHub Actions Workflow

Fügen Sie die folgende Zeile in die YAML-Workflow-Datei in .github/workflows/docker-build-push.yml ein.

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

Push zur Main: Der Workflow wird bei jedem Push ausgelöst, der im Haupt-Branch erfolgt.

Checkout-Code: Verwenden Sie die actions/checkout-Aktion, um das Repository auszuchecken.

Login to Registry: Authenticate with Docker Hub using the provided secrets.

Build und Push: Es läuft die Docker Build Push Action, die das Image aus dem aktuellen Verzeichnis bis zum Kontext baut und es an username/repository:latest pusht.

Commit the workflow file to your repository. Mit einem einfachen Push wird der Workflow ausgelöst, um das Image zu erstellen und es in Ihr angegebenes Register zu pushen.