GitHub: denied: permission_denied: write_packageの解決方法【2025年最新版】

エラーの概要・症状

GitHubを使用している際に、特にDockerイメージをビルドまたはパッケージをプッシュしようとすると、エラーメッセージ「 denied: permission_denied: write_package」が表示されることがあります。このエラーは、リポジトリの設定やパーミッションに関連する問題が原因で発生します。

具体的には、GitHub Actionsを使用してCI/CDパイプラインを構築している際に見られ、ユーザーが必要な権限を持っていない場合や、パッケージの設定が不適切な場合に発生します。結果として、ユーザーはリポジトリへのコードのプッシュやDockerイメージのデプロイができず、作業が滞ってしまうことが多いです。

このエラーが表示される状況は、特に以下のような場合です：

• GitHub Actionsを使用してDockerイメージをビルドする際。
• パッケージに対して書き込み権限が不足している状態。

ユーザーは、エラーが発生するたびにその原因を突き止め、適切な設定を行う必要があります。

このエラーが発生する原因

「 denied: permission_denied: write_package」エラーの主な原因は、以下のような設定ミスや権限の不足です。

1. パッケージのアクセス権の設定ミス: GitHubのパッケージ設定が不適切であり、必要な権限が付与されていない場合にこのエラーが発生します。特に、GitHub Actionsがパッケージにアクセスできるようにする設定が必要です。

2. GITHUB_TOKENの権限不足: GitHub Actions内で使用されるGITHUB_TOKENは、デフォルトで特定の権限しか持っていません。プライベートレポジトリや特定のブランチでの操作には、追加のパーミッションが必要です。

3. リポジトリの設定不備: リポジトリの設定で、Actionsが実行される際の権限が正しく設定されていないことも原因となります。特に、CI/CDパイプラインの中でパッケージに対する書き込み権限が明示されていない場合です。

4. ユーザーの権限不足: GitHubの組織やリポジトリに対するアクセス権限が不足している場合、書き込みが拒否されることがあります。

5. 環境設定の問題: 特に古いバージョンのRubyを使用している場合、エンコーディングの問題が影響することがあります。この場合、Rubyの設定を見直す必要があります。

解決方法1（最も効果的）

手順1-1: パッケージ設定の確認

1. GitHubのリポジトリにアクセスし、リポジトリのトップページに移動します。

2. 右上の「Packages」タブをクリックします。

3. エラーが発生しているパッケージを選択します。

4. 右サイドバーの一番下にある「Package settings」をクリックします。

5. 「Manage Actions access」のセクションで、パッケージの役割を「write」に変更します。

手順1-2: GitHub Actionsの設定を確認

1. .github/workflowsフォルダ内のワークフローファイルを開きます。

2. ジョブの設定に以下の権限を追加します。

   permissions:
     packages: write

1. 変更を保存し、再度GitHub Actionsを実行します。

注意点とトラブルシューティング

• エラーが解消されない場合は、設定を再確認し、必要に応じてリポジトリの権限やユーザーのロールを見直してください。
• もしパッケージがプライベートの場合、組織の管理者にアクセス権の確認を依頼することをお勧めします。

解決方法2（代替手段）

もし上記の方法でエラーが解消されない場合、以下の手順を試してみてください。