文件Commerce雲端基礎結構上的 Commerce 指南

部署至測試與生產

Last update: Tue Jul 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
  • undefined

部署和上線的程式從開發開始，接著是測試，最後是在生產環境中上線。 Adobe提供端對端環境解決方案，確保設定的一致性。 每個環境都支援對店面進行直接URL存取，以及對CLI命令進行管理員和SSH存取。

當您準備好部署存放區時，必須先在中繼環境中完成部署和測試，才能部署到生產環境。 本節提供建置和部署程式、移轉資料和內容以及測試的深入指示和資訊。

TIP
Adobe建議在部署之前建立環境的備份。

此外，您可以使用New Relic🔗啟用追蹤部署，以監視部署事件，並協助您分析部署之間的效能。

入門部署流程

Adobe建議從master分支建立staging分支，以最支援您的入門計劃開發與部署。 然後，您有四個使用中環境中的兩個已準備就緒： master用於生產，以及staging用於暫存。

如需程式的詳細資訊，請參閱入門開發與部署工作流程。

專業部署流程

Pro隨附大型整合環境，其中包含兩個作用中的分支：全域master分支、中繼及生產分支。 當您建立專案時，程式碼已準備好進行分支、開發及推送，以建置和部署您的網站。 雖然整合環境可以有許多分支，但每個環境的測試與生產只有一個分支。

如需程式的詳細資訊，請參閱Pro開發及部署工作流程。

將程式碼部署到中繼環境

中繼環境提供接近生產的環境，包括資料庫、網頁伺服器和所有服務，包括Fastly和New Relic。 您可以透過Cloud Console或雲端CLI命令，透過終端機應用程式完全推送、合併及部署。

使用Cloud Console部署程式碼

Cloud Console提供可在整合、測試和生產環境中建立、管理和部署程式碼的功能，以供入門和專業計畫使用。

若為Pro專案，請將整合分支部署至測試環境：

  1. 登入您的專案。

  2. 選取integration分支。

  3. 選取​ 合併 ​選項以部署到暫存環境。

    合併 {width="150"}

  4. 在測試環境中完成所有測試。

  5. 當暫存準備就緒時，請選取​ 合併 ​選項以部署到生產環境。

首先，將開發分支部署到暫存環境：

  1. 登入您的專案。

  2. 選取準備的程式碼分支。

  3. 選取​ 合併 ​選項以部署到暫存環境。

    合併 {width="150"}

  4. 在測試環境中完成所有測試。

  5. 當暫存準備就緒時，請選取​ 合併 ​選項以部署至生產環境(master)。

使用命令列部署程式碼

雲端CLI提供部署程式碼的命令。 您需要SSH和Git存取權才能存取專案。

步驟1：部署和測試整合環境

  1. 登入專案後，請檢視整合環境：

    code language-bash 
    magento-cloud environment:checkout <environment-ID>

  2. 將您的本機整合環境與遠端環境同步：

    code language-bash 
    magento-cloud environment:synchronize <environment-ID>

  3. 建立環境的快照作為備份：

    code language-bash 
    magento-cloud snapshot: create -e <environment-ID>

  4. 視需要更新本機分支中的程式碼。

  5. 新增、提交和推送變更至環境。

    code language-bash 
    git add -A && git commit -m "Commit message" && git push origin <environment-ID>

  6. 完成網站測試。

步驟2：合併對測試環境的變更並進行部署

  1. 請檢視測試環境：

    code language-bash 
    magento-cloud environment:checkout <environment-ID>

  2. 將您的本機中繼環境與遠端環境同步：

    code language-bash 
    magento-cloud environment:synchronize <environment-ID>

  3. 建立環境的快照作為備份：

    code language-bash 
    magento-cloud snapshot: create -e <environment-ID>

  4. 將整合環境合併至預備以進行部署：

    code language-bash 
    magento-cloud environment:merge <integration-ID>

  5. 完成網站測試。

步驟3：部署到生產

  1. 出庫、同步處理及建立本機生產環境的快照。

  2. 將中繼環境合併至生產環境以進行部署：

    code language-bash 
    magento-cloud environment:merge <staging-ID>

  3. 完成網站測試。

移轉靜態檔案

靜態檔案儲存在mounts中。 將檔案從來源掛載位置（例如您的本機環境）移轉至目的地掛載位置的方法有兩種。 這兩種方法都使用rsync公用程式，但Adobe建議使用magento-cloud CLI在本機和遠端環境之間移動檔案。 而且Adobe建議在將檔案從遠端來源移動到其他遠端位置時使用rsync方法。

使用CLI移轉檔案

您可以使用mount:upload和mount:download CLI命令，在本機和遠端環境之間移轉檔案。 這兩個命令都使用rsync公用程式，但CLI命令提供根據雲端基礎結構環境上的Adobe Commerce量身打造的選項和提示。 例如，如果您使用不含選項的簡單指令，CLI會提示您選取要上載或下載的掛載或掛載。

magento-cloud mount:download

範例回應：

Enter a number to choose a mount to download from:
  [0] app/etc
  [1] pub/static
  [2] var
  [3] pub/media
  [4] All mounts
 > 3

Target directory: ~/pub/media/

Downloading files from the remote mount pub/media to pub/media

Are you sure you want to continue? [Y/n] Y

若要將檔案從本機pub/media/資料夾上傳到目前環境的遠端pub/media/資料夾：

magento-cloud mount:upload --source /path/to/project/pub/media/ --mount pub/media/

範例回應：

Uploading files from pub/media to the remote mount pub/media

Are you sure you want to continue? [Y/n] Y

  building file list ...   done
  ./
  sample-file.jpeg

  sent 8.43K bytes  received 48 bytes  3.39K bytes/sec
  total size is 154.57K  speedup is 18.23

使用mount:upload和mount:download命令的--help選項檢視更多選項。 例如，在移轉期間有--delete選項可移除無關的檔案。

使用rsync移轉檔案

或者，您可以使用rsync公用程式來移轉檔案。

rsync -azvP <source> <destination>

這個指令使用下列選項：

  • a — 封存
  • 移轉期間壓縮z個檔案
  • v — 詳細資訊
  • P部分進度

請參閱rsync說明。

NOTE
若要直接從遠端環境傳輸媒體，您必須啟用SSH代理程式轉送，請參閱GitHub指南。

若要將靜態檔案直接從遠端環境移轉至遠端環境（快速方法）：

  1. 使用SSH登入來源環境。 請勿使用magento-cloud CLI。 使用-A選項很重要，因為它可啟用驗證代理程式連線的轉送。

    note tip
    TIP
    若要在您的Cloud Console中尋找​ SSH存取 ​連結，請選取環境，然後按一下​ 存取網站。
    code language-bash 
    ssh -A <environment_ssh_link@ssh.region.magento.cloud>

  2. 使用rsync命令將pub/media目錄從您的來源環境複製到不同的遠端環境。

    code language-bash 
    rsync -azvP pub/media/ <destination_environment_ssh_link@ssh.region.magento.cloud>:pub/media/

  3. 登入其他遠端環境，驗證檔案是否已成功移轉。

移轉資料庫

WARNING
資料庫匯入和匯出作業可能需要很長的時間，這會影響網站效能和可用性。 在非尖峰時間排程匯入和匯出作業，以防止生產網站上的效能緩慢或中斷。
recommendation-more-help

先決條件： ​資料庫傾印（請參閱步驟3）應包含資料庫觸發程式。 若要傾印它們，請確認您具有TRIGGER許可權。

IMPORTANT
整合環境資料庫僅供開發測試使用，其中可能包含您不想移轉至中繼和生產環境的資料。

若是持續整合部署，Adobe 不建議 ​將資料從整合移轉至中繼和生產環境。 您可以傳遞測試資料或覆寫重要資料。 任何重要組態都會在建置和部署期間使用組態檔和setup:upgrade命令傳遞。

style
shade-box

Adobe 建議 ​將資料從生產環境移轉至測試環境，以完整測試您的網站並儲存在具有所有服務和設定的近乎生產環境中。

NOTE
若要直接從遠端環境傳輸媒體，您必須啟用ssh代理程式轉送，請參閱GitHub指南。

備份資料庫

建立資料庫備份是最佳作法。 下列程式使用備份資料庫的指引。

若要傾印資料庫：

  1. 使用SSH登入包含要複製的資料庫的遠端環境。

  2. 列出環境關係，並記下資料庫登入資訊。

    code language-bash 
    php -r 'print_r(json_decode(base64_decode($_ENV["MAGENTO_CLOUD_RELATIONSHIPS"]))->database);'

    對於Pro Staging and Production，資料庫的名稱在MAGENTO_CLOUD_RELATIONSHIPS變數中（通常與應用程式名稱和使用者名稱相同）。

  3. 建立資料庫的備份。 若要選擇資料庫傾印的目標目錄，請使用--dump-directory選項。

    對於入門環境和Pro整合環境，請使用main作為資料庫的名稱：

    code language-bash 
    php vendor/bin/ece-tools db-dump main

    傾印選項：

    • --dump-directory=<dir> — 選擇資料庫傾印的目標目錄
    • --remove-definers — 從資料庫傾印移除DEFINER陳述式

  4. 雖然偏好使用ECE-Tools方法，但另一種方法是使用GZIP格式的原生MySQL建立資料庫傾印檔案。

    code language-bash 
    mysqldump -h <database-host> --user=<database-username> --password=<password> --single-transaction --triggers <database-name> | gzip - > /tmp/database.sql.gz

    如果您已在目標環境中設定雙因素驗證，最好排除相關的2FA表格，以避免在資料庫移轉後重新設定：

    code language-bash 
    mysqldump -h <database-host> --user=<database-username> --password=<password> --single-transaction --triggers --ignore-table=<database-name>.tfa_user_config --ignore-table=<database-name>.tfa_country_codes <database-name> | gzip - > /tmp/database.sql.gz

  5. 鍵入logout以終止SSH連線。

刪除並重新建立資料庫

匯入資料時，您必須卸除並建立資料庫。

若要卸除並重新建立資料庫：

  1. 建立SSH通道到遠端環境。

  2. 連線到資料庫服務。

    code language-bash 
    mysql --host=127.0.0.1 --user='<database-username>' --pass='<user-password>' --database='<name>' --port='<port>'

  3. 在MariaDB [main]>提示下，卸除資料庫。

    Starter and Pro整合：

    code language-shell 
    drop database main;

    對於生產：

    code language-shell 
    drop database <cluster-id>;

    對於分段：

    code language-shell 
    drop database <cluster-ID_stg>;

  4. 重新建立資料庫。

    Starter and Pro整合：

    code language-shell 
    create database main;

  5. 匯入資料庫。

    為生產匯入：

    code language-shell 
    zcat <cluster-ID>.sql.gz | sed -e 's/DEFINER[ ]*=[ ]*[^*]*\*/\*/' | mysql -h 127.0.0.1 -p -u <database-username> <database-name>;

    匯入以進行分段：

    code language-shell 
    zcat <cluster-ID_stg>.sql.gz | sed -e 's/DEFINER[ ]*=[ ]*[^*]*\*/\*/' | mysql -h 127.0.0.1 -p -u <database-username> <database-name>;

    這些命令會解壓縮資料庫傾印檔案、移除DEFINER陳述式，並使用指定的認證匯入資料庫。

05f2f56e-ac5d-4931-8cdb-764e60e16f26