docker-ci-cd

Docker CI/CD スキル

CI/CD パイプラインに Docker を統合し、イメージのビルド、セキュリティスキャン、デプロイを自動化します。

目的

GitHub Actions、GitLab CI、その他の CI/CD プラットフォームを使って、Docker のワークフローを自動化します。

パラメーター

パラメーター	型	必須	デフォルト	説明
platform	列挙型	いいえ	github	github/gitlab/jenkins
registry	文字列	いいえ	ghcr.io	コンテナレジストリ
scan	真偽値	いいえ	true	セキュリティスキャンを含める

GitHub Actions

完全なワークフロー

name: Docker Build and Deploy

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: write

    steps:
      - uses: actions/checkout@v4

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Login to Registry
        if: github.event_name != 'pull_request'
        uses: docker/login-action@v3
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Extract metadata
        id: meta
        uses: docker/metadata-action@v5
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
          tags: |
            type=sha
            type=ref,event=branch
            type=semver,pattern={{version}}

      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
          push: ${{ github.event_name != 'pull_request' }}
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
          cache-from: type=gha
          cache-to: type=gha,mode=max

      - name: Scan for vulnerabilities
        uses: aquasecurity/trivy-action@master
        with:
          image-ref: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:sha-${{ github.sha }}
          exit-code: '1'
          severity: 'CRITICAL,HIGH'

マルチアーキテクチャビルド

- name: Set up QEMU
  uses: docker/setup-qemu-action@v3

- name: Build multi-arch
  uses: docker/build-push-action@v5
  with:
    platforms: linux/amd64,linux/arm64
    push: true
    tags: ${{ steps.meta.outputs.tags }}

GitLab CI

# .gitlab-ci.yml
stages:
  - build
  - scan
  - deploy

variables:
  DOCKER_IMAGE: $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA

build:
  stage: build
  image: docker:24
  services:
    - docker:24-dind
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker build -t $DOCKER_IMAGE .
    - docker push $DOCKER_IMAGE

scan:
  stage: scan
  image:
    name: aquasec/trivy
    entrypoint: [""]
  script:
    - trivy image --exit-code 1 --severity CRITICAL $DOCKER_IMAGE

deploy:
  stage: deploy
  script:
    - ssh deploy@server "docker pull $DOCKER_IMAGE && docker compose up -d"
  only:
    - main

ベストプラクティス

キャッシュ

# GitHub Actions BuildKit cache
cache-from: type=gha
cache-to: type=gha,mode=max

# GitLab cache
cache:
  key: docker-$CI_COMMIT_REF_SLUG
  paths:
    - .docker-cache

セキュリティ

# Scan before push
- name: Scan
  run: trivy image --exit-code 1 --severity CRITICAL $IMAGE

# Sign images (cosign)
- name: Sign
  run: cosign sign $IMAGE

エラー処理

よくあるエラー

エラー	原因	解決策
unauthorized	認証情報が正しくありません	レジストリへのログインを確認してください
rate limit	Docker Hub の制限	認証済みのプルを使用してください
cache miss	初回のビルド	キャッシュが作成されます

フォールバック戦略

1. キャッシュが破損している場合は、キャッシュなしでビルドします
2. プライマリレジストリがダウンした場合は、フォールバックレジストリを使用します
3. 失敗した場合は、前のバージョンをデプロイします

トラブルシューティング

デバッグチェックリスト

• レジストリの認証情報は有効ですか？
• Docker デーモンは実行中ですか？
• ビルドコンテキストは正しいですか？
• Dockerfile は存在しますか？

使用方法

Skill("docker-ci-cd")

アセット

• assets/github-actions-docker.yaml - GitHub Actions のテンプレート
• scripts/build-and-push.sh - ビルドスクリプト

関連スキル

• docker-production
• docker-security