[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}
專案結構
雲端基礎結構專案上的Adobe Commerce包含認證和應用程式設定的基本檔案。 根據Adobe Commerce版本，這些檔案可在中以範本的形式提供。 在magento/magento-cloud GitHub存放庫中檢視以Adobe Commerce版本為基礎的雲端範本。
下表說明雲端專案中包含的檔案：
檔案
說明
/.magento/routes.yaml/.magento/services.yaml定義MySQL執行個體(MariaDB)、Redis和OpenSearch或Elasticsearch的組態檔。 請參閱設定服務。
/app/m2-hotfixes用於自訂修補程式。
/update支援模組使用的服務資料夾。
.gitignore指定要忽略的檔案和目錄。 請參閱
.gitignore參考。.magento.app.yaml定義建置應用程式之屬性的組態檔。 請參閱設定應用程式。
.magento.env.yaml建置、部署和部署後階段的設定檔。
ece-tools封裝包含此檔案的範例。 請參閱設定環境。composer.json擷取Adobe Commerce和設定指令碼，以準備您的應用程式。 請參閱必要的封裝。
composer.lock儲存每個套件的版本相依性。 請參閱必要的封裝。
magento-vars.php用來定義多個商店和使用變數的網站。
NOTE
當您將本機變更推送到遠端伺服器時，部署指令碼會使用
.magento目錄中組態檔定義的值，然後指令碼會刪除目錄及其內容。 您的本機開發環境不受影響。應用程式根目錄
應用程式根目錄的位置取決於環境。
- 入門和Pro整合：
/app - 入門產品：
/<project-ID> - Pro暫存：
/<project-ID>_stg - Pro Production：
/<project-ID>
可寫入的目錄
遠端整合、測試和生產環境為唯讀。 基於安全理由，下列目錄是 僅 可寫入的目錄：
varpub/staticpub/mediaapp/etc/tmp
NOTE
在生產和中繼環境中，三節點叢集中的每個節點都有一個
/tmp目錄，不與其他節點共用。忽略檔案
雲端基礎結構專案存放庫中有具有Adobe Commerce的基底.gitignore檔案。 檢視magento-cloud存放庫🔗中的最新.gitignore檔案。 若要新增位於.gitignore清單中的檔案，您可以在暫存認可時使用-f （強制）選項：
git add <path/filename> -f
變更基礎範本
您可使用下列步驟來變更現有專案的結構，以反映雲端基礎結構上Adobe Commerce的最新基礎範本。
-
將專案複製到本機工作站。
-
使用下列
extra區段的值更新composer.json檔案。code language-json "extra": { "magento-force": true "magento-deploystrategy": "copy" } -
新增為基底範本設計的
.gitignore檔案。 例如，如果您需要2.2.6版範本的.gitignore檔案，請使用2.2.6🔗檔案的.gitignore作為參考。 -
清除Git快取。
code language-bash git rm -r --cached . -
新增並認可變更。
code language-bash git add -A && git commit -m "Update base template"
WARNING
當您執行環境的合併、推播或同步處理時，或當您觸發手動重新部署時（期間的Commerce應用程式處於維護模式），部署程式即會開始。 在生產環境中，Adobe建議您在離峰時間完成這項工作，以避免服務中斷。
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938