在雲端基礎結構上為Commerce設定遠端儲存
從ece-tools
套件2002.1.5開始,您可以使用環境變數來啟用遠端儲存模組;不過,遠端儲存模組在雲端基礎結構上的Adobe Commerce上有 有限 支援。 Adobe無法完全疑難排解協力廠商儲存配接器服務。
環境變數
REMOTE_STORAGE
變數用於雲端基礎結構專案的部署階段。
REMOTE_STORAGE
- 預設—未設定
- 版本—Commerce 2.4.2和更新版本
設定 儲存配接卡,使用儲存服務(例如AWS S3)將媒體檔案儲存在永久性的遠端儲存容器中。 啟用遠端儲存模組,針對必須共用資源的複雜、多伺服器設定,提升雲端專案的效能。 以下是使用.magento.env.yaml
檔案的遠端儲存設定範例:
stage:
deploy:
REMOTE_STORAGE:
driver: aws-s3 # Required
prefix: cloud # Optional
config:
bucket: my-bucket # Required
region: my-region # Required
key: my-key # Optional
secret: my-secret-key # Optional
使用雲端CLI設定變數
將REMOTE_STORAGE
變數設為環境層級變數,這樣就不會在生產、測試和整合環境之間共用檔案。 在環境層級設定變數,可讓您靈活地在選取的環境上僅使用遠端儲存,例如排除使用遠端儲存的整合環境。
若要使用Cloud CLI新增遠端儲存體變數:
magento-cloud variable:create --level environment --name REMOTE_STORAGE --json true --inheritable false --value '{"driver":"aws-s3","prefix":"uat","config":{"bucket":"aws-bucket-id","region":"eu-west-1","key":"optional-key","secret":"optional-secret"}}'
這會使用指定的JSON組態建立REMOTE_STORAGE
變數。 REMOTE_STORAGE
變數需要JSON字串才能設定遠端儲存空間。 以下是JSON設定的範例:
{
"driver": "aws-s3",
"prefix": "uat",
"config": {
"bucket": "aws-bucket-id",
"region": "aws-region-id",
"key": "optional-key",
"secret": "optional-secret"
}
}
在您建立組態並部署之後,部署記錄檔應包含遠端儲存體組態的相關資訊,例如INFO: Remote storage driver set to: "aws-s3"
使用Project Web介面設定變數
或者,您可以使用Project Web介面將變數新增至適當的環境。
若要使用Project Web介面新增遠端儲存變數:
-
在 Project Web介面 中,從左側選取環境。
-
按一下 設定環境 圖示。
-
在 設定環境 檢視中,按一下 變數 標籤。
-
按一下 新增變數。
-
在 名稱 欄位中,輸入
REMOTE_STORAGE
-
在 Value 欄位中,新增JSON設定。
-
選取 JSON值 和 敏感;取消選取 可由子環境繼承。
-
按一下 新增變數。
使用選擇性驗證
key
和secret
是選用專案。 當您建立變數時,可以選取sensitive
選項以隱藏key
和secret
。 使用此設定時,網頁介面中不會顯示值。 請參閱 雲端基礎結構上的Commerce指南 中的變數可見度。
如果您想使用不同的驗證方法,請從JSON設定中省略key
和secret
。 設定替代驗證方法,並確認伺服器已獲得S3儲存貯體的授權。
同步處理遠端儲存裝置
啟用遠端儲存模組後,將目前的媒體檔案同步至遠端存放區位置。
若要啟動同步處理:
-
使用SSH登入已設定遠端儲存裝置的遠端環境。
-
啟動同步。
bin/magento remote-storage:sync
Fastly設定
如果您選擇在雲端基礎結構專案上搭配Adobe Commerce使用遠端儲存解決方案,請使用 Fastly 檔案中的Amazon S3指南,以確保Fastly影像最佳化可搭配AWS S3使用。
準備您的Fastly認證。 在Pro專案上,使用SSH連線到您的伺服器並從/mnt/shared/fastly_tokens.txt
檔案取得Fastly認證。 測試和生產環境都有獨特的認證。 您必須取得每個環境的認證。
請繼續設定雲端專案的遠端儲存空間,完成下列工作:
-
設定Fastly後端整合。
-
建立AWS S3驗證的VCL邏輯。
-
為AWS S3儲存貯體🔗的後端請求建立VCL邏輯。