クラウドインフラストラクチャー上のAdobe Commerceで静的コンテンツを生成できない
静的コンテンツは、クラウドインフラストラクチャ上でAdobe Commerceをデプロイする際に生成されず、多くの場合、環境変数の設定が誤っていることが原因です。 ビルドプロセス中に発生する 「/app/…/.htaccess のシンボリックリンクを作成できません」 エラーや deployed_version.txt ファイルが見つからない、などの問題が発生します。 この問題を解決するには、が有効になってい CLEAN_STATIC_FILES ことを確認し、環境を再デプロイします。
説明 description
環境
クラウドインフラストラクチャー上のAdobe Commerce
問題/症状
- 静的コンテンツがデプロイメント中に生成されない。
- 表示されたエラー：「/app/…/.htaccess のシンボリックリンクを作成できません」。
- ファ
deployed_version.txtルが見つからないか古くなっています。 - 環境間で
CLEAN_STATIC_FILES変数に一貫性がない。
解決策 resolution
この問題を解決するには、次の手順に従います。
-
CLEAN_STATIC_FILES変数をチェックして、有効に設定されていることを確認します（または、未設定のままにして、デフォルトで有効になっています）。 これは、次のいずれかの方法で検証できます。-
SSH 経由（例：ノード 01）でサーバーにアクセスし、次のコマンドを実行します。
code language-none php -r 'echo json_decode(base64_decode($_ENV[ "MAGENTO_CLOUD_VARIABLES"] ))->CLEAN_STATIC_FILES . "\n";' -
リポジトリ内の
.magento.env.yamlファイルで変数を確認します。 -
次の CLI コマンドをローカルで実行します。
code language-none magento-cloud variables:list -p <clusterID> -
Cloud Console （
https://console.adobecommerce.com/username/<cluster ID>/<environment>/settings/variables）にアクセスして、変数を調べます。
-
-
環境間で
CLEAN_STATIC_FILES変数を比較して、不一致を識別し（例えば、ステージングで有効だが実稼動では無効になっている）、一貫性を確保するために有効に調整します。 -
変更を環境にプッシュして、静的コンテンツの再構築と再生成をトリガーにします。
関連資料
- CLEAN_STATIC_FILES （Cloud Infrastructure 上のAdobe Commerce ガイド）
- クラウドインフラストラクチャー上のAdobe Commerce ガイドの 変数リスト。