ドキュメントCommerceCommerce on Cloud

プロジェクト構造

最終更新日： 2025年10月14日

作成対象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Adobe Commerce on cloud インフラストラクチャプロジェクトには、資格情報とアプリケーション設定に必要なファイルが含まれています。 これらのファイルは、Adobe Commerceのバージョンに応じてテンプレートとして使用できます。 magento/magento-cloud GitHub リポジトリ ​のAdobe Commerce バージョンに基づくクラウドテンプレートを参照してください。

次の表に、クラウドプロジェクトに含まれるファイルを示します。

ファイル
説明
/.magento/routes.yaml
wwwをapex ドメインとphp アプリケーションにリダイレクトしてHTTPを提供する設定ファイル。 ​ ルートの設定を参照してください。
/.magento/services.yaml
MySQL インスタンス（MariaDB）、Redis、OpenSearchまたはElasticsearchを定義する設定ファイル。 ​ サービスの設定を参照してください。
/app
code フォルダーはカスタムモジュールに使用されます。 design フォルダーは​ カスタムテーマ ​に使用されます。 etc フォルダーには、アプリケーションの設定ファイルが含まれています。
/m2-hotfixes
カスタムパッチに使用されます。
/update
サポートモジュールで使用されるサービスフォルダー。
.gitignore
無視するファイルとディレクトリを指定します。 .gitignore参照を参照してください。
.magento.app.yaml
アプリケーションを構築するためのプロパティを定義する設定ファイル。 ​ アプリケーションの設定を参照してください。
.magento.env.yaml
ビルド、デプロイ、デプロイ後のフェーズの設定ファイル。 ece-tools パッケージには、このファイルのサンプルが含まれています。 環境の設定を参照してください。
composer.json
アプリケーションを準備するために、Adobe Commerceと設定スクリプトを取得します。 必要なパッケージ ​を参照してください。
composer.lock
各パッケージのバージョン依存関係を保存します。 必要なパッケージ ​を参照してください。
magento-vars.php
変数を使用して複数のストア ​とサイトを定義するために使用します。
NOTE
ローカルの変更をリモート サーバーにプッシュすると、デプロイ スクリプトは.magento ディレクトリ内の設定ファイルで定義された値を使用し、その後、スクリプトはディレクトリとその内容を削除します。 ローカル開発環境は影響を受けません。

アプリケーションのルートディレクトリ

アプリケーションのルートディレクトリの場所は、環境によって異なります。

  • スターターとプロ統合: /app
  • スタータープロダクション: /<project-ID>
  • Pro ステージング: /<project-ID>_stg
  • Pro実稼動: /<project-ID>

書き込み可能なディレクトリ

リモート統合環境、ステージング環境および実稼動環境は読み取り専用です。 次のディレクトリは、セキュリティ上の理由から​ only ​書き込み可能なディレクトリです。

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
実稼動環境とステージング環境では、3 ノードクラスター内の各ノードには、他のノードと共有されていない/tmp ディレクトリがあります。

ファイルを無視

Adobe Commerce on cloud infrastructure プロジェクトリポジトリを持つベース .gitignore ファイルがあります。 magento-cloud リポジトリ 🔗の最新の.gitignore ファイルを参照してください。 .gitignore リストにあるファイルを追加するには、コミットのステージング時に-f （強制）オプションを使用できます。

git add <path/filename> -f

基本テンプレートを変更

次の手順を使用して、既存のプロジェクトの構造を変更し、Adobe Commerce on cloud infrastructureの最新の基本テンプレートを反映させることができます。

  1. プロジェクトをローカルワークステーションに複製します。

  2. extra セクションの次の値でcomposer.json ファイルを更新します。

    code language-json 
    "extra": {
    "magento-force": true
    "magento-deploystrategy": "copy"
}

  3. 基本テンプレート用に設計された.gitignore ファイルを追加します。 例えば、バージョン 2.2.6 テンプレートに.gitignore ファイルが必要な場合は、2.2.6🔗 ファイルの.gitignoreを参照として使用します。

  4. Git キャッシュをクリアします。

    code language-bash 
    git rm -r --cached .

  5. 変更を追加してコミットします。

    code language-bash 
    git add -A && git commit -m "Update base template"
WARNING
デプロイメントプロセスは、環境の結合、プッシュ、同期を実行する場合、またはCommerce アプリケーションがメンテナンスモードになっている手動の再デプロイメントをトリガーする場合に開始します。 実稼動環境の場合、サービスの中断を避けるために、Adobeではオフピーク時にこの作業を行うことをお勧めします。
recommendation-more-help
commerce-on-cloud-help-cloud-guide