GitHub Container Registry (ghcr.io) の使い方

Sat, 28 Feb 2026 12:00:00 +0900

GitHub Container Registry (ghcr.io) は、GitHub が提供するコンテナイメージのレジストリです。 Public Packages であれば無料で利用でき、GitHub Actions と組み合わせることでデータ転送料金も無料になります。

ghcr.io は2通りの使い方があります。

ローカルから Docker CLI を使ってイメージをビルドしてプッシュする方法
GitHub Actions を使ってコードの変更に合わせて自動でイメージをビルドしてプッシュする方法

今回はGitHub Actions を使って自動でイメージをビルドしてプッシュする方法を紹介します。

GitHub Actions から自動でプッシュする

GitHub Actions を使えば、コードをプッシュするだけで自動的にイメージのビルドとプッシュができます。以下はワークフローの例です。

name: Docker Build and Push

on:
  push:
    branches:
      - main

# GHCR へのプッシュには packages: write が必要
permissions:
  contents: read
  packages: write

jobs:
  build-and-push:
    runs-on: ubuntu-latest

    steps:
      # ソースコードをチェックアウト
      - name: Check out code
        uses: actions/checkout@v4

      # ghcr.io にログイン
      - name: Log in to GitHub Container Registry
        uses: docker/login-action@v2
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          # デフォルトの GITHUB_TOKEN を利用
          password: ${{ secrets.GITHUB_TOKEN }}

      # Docker イメージをビルドしてプッシュ
      - name: Build and push Docker image
        uses: docker/build-push-action@v6
        with:
          context: .
          push: true
          tags: ghcr.io/${{ github.repository }}:latest

トラブルシューティング

GitHub Actions から ghcr.io にプッシュする際に、以下のようなエラーが出ました。

Rocky Linuxにcontainerdをインストールする方法

Sun, 30 Jun 2024 16:46:03 +0900

以前Kubernetesクラスタを構築するときに、Rocky Linuxでcontainerdをインストールする方法についてあまり情報がなかったので、とても苦労しました。なので今回はその時に調べた内容を記事にしてみました。

次のコマンドでcontainerdをインストールできます。

# yumにCentOS用のdockerリポジトリを追加する
sudo yum config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# docker-ceリポジトリに含まれているcontainerd.ioのパッケージをインストールする
sudo yum install -y containerd.io

# containerdのデフォルト設定ファイルを生成する
sudo sh -c "containerd config default > /etc/containerd/config.toml"

そして最後にcontainerdを有効化します。

systemctl enable --now containerd.service

参考

Using containerd without docker (Installing containerdの部分)

Docker on kkato.dev

GitHub Container Registry (ghcr.io) の使い方

GitHub Actions から自動でプッシュする

トラブルシューティング

Rocky Linuxにcontainerdをインストールする方法

参考