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

スムーズな自動化

Dockerイメージを手作業で作成し、プッシュすることは、公開され、エラーを引き起こしやすく、時間がかかります。 これらのステップを自動化することで予測可能性を確保し、特にチームがスケールしたり更新がより頻繁な場合には、余計な時間を節約します。

スムーズな統合

Docker Build Push Actionは、GitHubリポジトリでコードのプッシュ、プルリクエスト、またはスケジュールなどのイベント周辺のワークフローを作成するために、すぐに使える仕組みとなっています。

標準的なイメージの作成

自動化により、毎回Dockerイメージを作成すると、それらは同じものになります。 したがって、開発、ステージング、プロダクションなどの複数の環境間でのエラーや不整合を減少させます。

簡単なデプロイメント

構築時にDockerイメージを自動作成し、リポジトリにプッシュすることで、デプロイは比較的容易になります。 KubernetesやDocker Swarmのようなツールを使用して、Dockerレジストリから直接またはマルチプラットフォームイメージをプルまたは構築し、ダウンタイムを削減します。

Docker Build Push Actionの仕組み

ビルドとプッシュ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 Secretとして追加する

Dockerイメージをコンテナレジストリに構築・プッシュするには、資格情報が必要です。 これらをGitHub Secretとして追加します：

• 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に認証します。

ビルドとプッシュ： 現在のディレクトリからイメージをビルドしてユーザー名/リポジトリ：latestにプッシュするDocker Build Push Actionを実行します。

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