ドキュメント

Adobe Commerce Cloud の実稼動環境へのデプロイメント中に、Composer 認証資格情報エラーが発生する

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

URL が必要な認証（HTTP 401））などのコンポーザー認証資格情報エラーが発生した場合。クラウドインフラストラクチャ上のAdobe Commerceの実稼動環境へのデプロイメント中に 生する場合は、まず、実稼動デプロイメントのビルドフェーズ中に、auth.json ファイルまたは同等の認証資格情報にアクセスできることを確認します。 その後、env:COMPOSER_AUTH の環境レベル変数を修正するか（推奨）、auth.json ファイルを手動で作成してデプロイできます。

説明 description

環境

クラウドインフラストラクチャー上のAdobe Commerce、実稼働およびステージング環境

問題

環境にデプロイしようとすると、URL 必要な認証（HTTP 401）が原因でデプロイメントプロセスが停止します。composer 認証資格情報に関連する エラー。

同じ資格情報が auth.json ファイルでローカルまたは別の環境で機能しますが、別の環境へのデプロイ中に失敗します。

解決策 resolution

注意 : Composer の認証情報を見つけるには、『Adobe Commerce インストール ガイド』の ​ 認証キーの取得 ​ を参照してください。

この問題を解決するには、次の手順に従います。

実稼動デプロイメントのビルド段階で、auth.json ファイルまたは同等の認証資格情報にアクセスできることを確認します。

この問題を解決するには、次の 2 つのオプションをお勧めします。

オプション 1：環境レベル変数 env:COMPOSER_AUTH 修正（推奨）

  1. env:COMPOSER_AUTH に対して正しい資格情報が設定されていることを確認します。
  2. クラウドプロジェクト UI の左上にある歯車アイコンをクリックしてグローバル設定にアクセスし、「 変数 」タブを選択します。
  3. 必ず「ビルド時に使用可能」を選択し、「実行時に使用可能 の選択を解除します。 Commerce on Cloud Infrastructure ガイドの ​ 認証キー ​ を参照してください。

オプション 1 で問題が解決しない場合は、オプション 2 に進みます。

オプション 2：ファイルを手動で作成およびデプロイ auth.json る

  1. サーバーに SSH で接続します。

  2. 次を使用して、現在の env:COMPOSER_AUTH 変数のコンテンツを取得します。

    echo $COMPOSER_AUTH

  3. 上記の手順からすべてのコンテンツをコピーします（JSON 形式）。

  4. これらの内容を含んだ auth.json という新しいファイルを作成します。

  5. 新しく作成したこの auth.json ファイルをリポジトリのルートディレクトリにコミットします。

  6. 新しいデプロイメントをトリガーします。

上記のいずれかのオプションを使用すると、composer の認証資格情報に関連する問題が発生することなく、問題が発生した環境に正常にデプロイできます。

さらにサポートが必要な場合や、これらのソリューションの実装中に問題が発生した場合は、Adobe Commerce テクニカルサポートでチケットを開く ​ ことで追加のサポートを受けることができます。

関連資料

Can't access Adobe Commerce on cloud repo: 403 Forbidden または 404 Not Found エラーがデプロイ時に発生する ​

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f