Akcja Docker Build Push (jak to działa dla programistów)

Płynna automatyzacja

Ręczne tworzenie i publikowanie obrazów Docker jest skomplikówane, podatne na błędy i czasochłonne. Automatyzacja tych kroków zapewnia przewidywalność i pozwala zaoszczędzić czas, zwłaszcza gdy zespół się powiększa lub aktualizacje są częstsze.

Płynna integracja

Akcja Docker Build Push działa od razu z repozytoriami GitHub, umożliwiając tworzenie przepływów pracy wokół zdarzeń, takich jak wysyłanie kodu, pull requesty lub harmonogram.

Standardowe tworzenie obrazów

Automatyzacja gwarantuje, że za każdym razem, gdy tworzone są obrazy Docker, są one identyczne; co pozwala ograniczyć błędy i rozbieżności w różnych środowiskach, takich jak środowisko programistyczne, testowe i produkcyjne.

Łatwe wdrożenie

Dzięki automatycznemu tworzeniu obrazów Docker w ramach kompilacji oraz ich przesyłaniu do repozytoriów wdrożenie może stać się stosunkowo łatwe. Narzędzia takie jak Kubernetes lub Docker Swarm mogą służyć do pobierania lub tworzenia obrazów wielopłatformowych bezpośrednio z rejestru Docker, co pozwala skrócić przestoje.

Jak działa akcja Docker Build Push

Akcja Build and Push Docker wykonuje trzy podstawowe czynności:

1. Skonfiguruj logowanie do Docker: uwierzytelnianie w rejestrze kontenerów w celu bezpiecznego przesyłania obrazów Docker.
2. Image Build: Uruchamia polecenia kompilacji Docker przy użyciu pliku Dockerfile zawierającego instrukcje.
3. Push to Registry: Przesyła skompilowany obraz do docelowego rejestru kontenerów.

Kroki te są zdefiniowane w pliku przepływu pracy GitHub Actions (.github/workflows/your-workflow.yml), w którym określa się wyzwałącze, konfiguracje kompilacji oraz poświadczenia rejestru.

Wdrożenie akcji Docker Build Push

1: Przygotuj swoje repozytorium

• Dodaj plik Dockerfile opisujący aplikację w kontenerze.
• Dodaj wszelkie pliki konfiguracyjne lub skrypty wymagańe do kompilacji.

# 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: Dodaj poświadczenia rejestru jako sekrety GitHub

Aby skompilować i przesłać obrazy Docker do rejestru kontenerów, potrzebne są poświadczenia. Dodaj je jako sekrety GitHub:

• Przejdź do ustawień repozytorium na GitHubie.
• Przejdź do Sekrety i zmienne > Działania.

Dodaj następujące sekrety:

• USERNAME: Twoja nazwa użytkownika w serwisie Docker Hub.
• PASSWORD: Twój token dostępu lub hasło do Docker Hub.

W przypadku innych rejestrów sytuacja jest podobna, ale czasami wymagańe są dodatkowe poświadczenia, na przykład AWS_ACCESS_KEY_ID i AWS_SECRET_ACCESS_KEY dla Amazon ECR.

3: Utwórz przepływ pracy GitHub Actions

Dodaj poniższy wiersz do pliku przepływu pracy YAML w .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

Push do gałęzi głównej: Przepływ pracy zostanie uruchomiony przy każdym pushu do gałęzi głównej.

Kod checkout: Użyj akcji actions/checkout, aby wykonać checkout repozytorium.

Zaloguj się do rejestru: Uwierzytelnij się w Docker Hub przy użyciu dostarczonych kluczy.

Build and Push: Uruchamia akcję Docker Build Push, która skompiluje obraz z bieżącego katalogu do momentu zakończenia procesu i prześle go do username/repository: latest.

Zapisz plik przepływu pracy w swoim repozytorium. Wystarczy jedno naciśnięcie, aby uruchomić proces tworzenia obrazu i umieszczenia go w określonym rejestrze.