Docker Build Push Action (開発者向けの仕組み)

摩擦のない自動化

Dockerのイメージを手作業で構築してプッシュするのは、手間がかかり、エラーの原因となりやすく、時間の浪費でもあります。 これらのステップを自動化することで、予測可能性が向上し、チームのスケールアップや更新が頻繁になるときに特にボトムラインに時間を追加します。

摩擦のない統合

Docker Build Push Actionは、GitHubリポジトリとボックスから連携して、コードプッシュ、プルリクエスト、またはスケジュールといったイベントのワークフローを作成します。

イメージの標準ビルド

自動化により、Dockerイメージがビルドされるたびに同じものが確保されます; したがって、開発、ステージング、本番などの複数の環境間でのエラーや不一致が減少します。

簡単なデプロイメント

Dockerイメージの自動ビルドと、リポジトリへのプッシュにより、デプロイメントが比較的簡単になります。 KubernetesやDocker Swarmのようなツールを使って、Dockerレジストリからマルチプラットフォームイメージを直接プルしたりビルドしたりできるため、ダウンタイムを減らせます。

Docker Build Push Actionの動作原理

Build and Push Dockerアクションは3つの基本的なことを行います。

1. Dockerログインのセットアップ: コンテナレジストリ認証を行い、Dockerイメージを安全にプッシュします。
2. イメージビルド: 指示が記載されたDockerfileを使用してDockerビルドコマンドを実行します。
3. レジストリへのプッシュ: ビルドされたイメージをターゲットのコンテナレジストリにプッシュします。

これらのステップはGitHub Actionsワークフローファイル (.github/workflows/your-workflow.yml) に定義され、トリガー、ビルド構成、レジストリの認証情報を指定します。

Docker Build Push Actionを実装する

1: リポジトリの準備

• コンテナ化されたアプリケーションを記述するDockerfileを追加します。
• ビルドに必要な設定ファイルやスクリプトを追加します。

# 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: レジストリの認証情報をGitHub Secretsとして追加する

Dockerイメージをコンテナレジストリにビルドおよびプッシュするには、資格情報が必要です。 これらをGitHub Secretsとして追加します。

• GitHub上のリポジトリ設定に移動します。
• Secrets and Variables > Actionsに進みます。

次のシークレットを追加します。

• USERNAME: Docker Hubのユーザー名。
• PASSWORD: Docker Hubのアクセストークンまたはパスワード。

その他のレジストリでは、これも同様ですが、Amazon ECRの場合のAWS_ACCESS_KEY_IDやAWS_SECRET_ACCESS_KEYのように、追加の認証情報が必要な場合があります。

3: GitHub Actionsワークフローの作成

.github/workflows/docker-build-push.yml内のYAMLワークフローファイルに下記の行を追加します。

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

メインへのプッシュ: ワークフローはメインブランチへのプッシュがあるたびにトリガーされます。

コードをチェックアウト: actions/checkoutアクションを利用してリポジトリをチェックアウトします。

レジストリにログイン: 提供されたシークレットを使用してDocker Hubに認証します。

ビルドとプッシュ: 現在のディレクトリから、最新のコンテキストまでイメージをビルドし、ユーザー名/リポジトリにプッシュするDocker Build Push Actionを実行します。

ワークフローファイルをリポジトリにコミットします。 簡単なプッシュで、ワークフローがトリガーし、イメージをビルドし、指定されたレジストリにプッシュします。