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

使用CLI管理分支

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員

若要安裝magento-cloud CLI，請參閱雲端CLI參考。 安裝magento-cloud CLI並設定SSH金鑰以遠端存取雲端基礎結構後，您就可以使用magento-cloud CLI命令來管理專案的環境。 如需有關環境架構的資訊，請參閱入門架構或專業架構。

若要使用Cloud Console管理分支和環境，請參閱使用 Cloud Console管理分支。

使用CLI命令

magento-cloud CLI命令與Git命令類似。 您可以使用這些專案來連線至您的專案並管理您的環境。 雖然您可以從任何目錄執行命令，但建議您從專案目錄執行這些命令。 從專案目錄執行時，您可以省略-p <project-ID>引數。 請參閱雲端CLI參考。

複製專案

下列指示使用magento-cloud CLI指令與Git指令的組合，將專案複製到本機工作站。 若要檢視magento-cloud CLI命令的完整清單，請使用magento-cloud list命令。

IMPORTANT
有些Git命令無法在Adobe Commerce的雲端基礎結構專案中完成動作。 例如，您可以使用Git指令建立分支，但無法建立和啟動新環境。 您必須使用magento-cloud environment:branch <branch-name>命令建立環境，環境才能變成​_作用中_。 或者，您可以使用Cloud Console來建立使用中的環境。 請參閱雲端CLI參考。

若要複製專案master環境：

  1. 使用檔案系統擁有者帳戶登入您的本機工作站。

  2. 變更至網頁伺服器或虛擬主機​ docroot ​目錄。

  3. 使用magento-cloud CLI登入。

    code language-bash 
    magento-cloud login

  4. 列出您的專案。

    code language-bash 
    magento-cloud project:list

  5. 複製專案。

    code language-bash 
    magento-cloud project:get <project-ID>

    出現提示時，請提供目錄名稱。

  6. 變更至magento2目錄。

  7. 列出專案的可用環境。

    code language-bash 
    magento-cloud environment:list
    note important
    IMPORTANT
    magento-cloud environment:list命令顯示環境階層，而git branch命令不顯示。

  8. 擷取遠端分支。

    code language-bash 
    git fetch origin

  9. 提取更新的程式碼。

    code language-bash 
    git pull origin <environment-ID>
TIP
如需在雲端基礎結構上搭配Adobe Commerce使用Git型託管服務的相關資訊，請參閱整合。

建立開發分支

複製專案並更新Adobe Commerce管理員帳戶設定後，您可以分支進行開發。 如前所述，您必須使用magento-cloud environment:branch <branch-name>命令或Cloud Console建立環境，環境才能變成​ 使用中。

  • 對於入門者，請考慮為staging建立分支，然後根據staging分支建立開發分支。
  • 針對Pro，根據Integration分支建立開發分支。

若要建立開發分支：

  1. 在本機工作站上，變更至專案目錄。

  2. 根據專案工作流程建議的分支建立環境。

    code language-bash 
    magento-cloud branch <new-environment-name> integration

  3. 更新相依性。

    code language-bash 
    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader

  4. [選擇性]​建立環境的備份。

合併分支

完成開發後，將此分支合併至父級：

  1. 認可和推送程式碼變更：

    code language-bash 
    git add -A && git commit -m "Add message here"
    code language-bash 
    git push origin <branch-name>

  2. 與上層環境合併：

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

刪除環境

只有在您確定不再需要某個環境時，才將其刪除。 刪除環境後，就無法復原環境。

WARNING
您無法刪除任何專案的master分支。

您必須是專案管理員、環境管理員或帳戶擁有者才能執行此工作。 請參閱管理雲端專案的使用者存取權。

當您刪除環境時，環境會設為​ 非使用中。 程式碼仍可在Git分支中使用，但不再包含服務或資料庫。 若要完全刪除環境，您也必須刪除對應的遠端Git分支。

若要刪除環境：

  1. 在本機工作站上，變更至專案目錄。

  2. 從遠端伺服器擷取更新。

    code language-bash 
    git fetch

  3. 刪除環境分支。

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

    您可以選擇將多個環境ID新增至delete命令，一次刪除多個環境。

    code language-bash 
    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>

  4. 回應刪除本機環境和對應遠端環境的提示。

    code language-none 
    The environment <environment-ID> is currently active: deleting it will delete all associated data.
Are you sure you want to delete the environment <environment-ID>? [Y/n]

    刪除環境會使其處於​ 非作用中 ​狀態。

    code language-none 
    Delete the remote Git branch too? [Y/n]

    刪除遠端Git分支會從專案移除環境。

  5. 等待環境刪除。

    code language-none 
    Deleting environment <environment-ID>
Waiting for the activity...
  Deleting environment <project-id>-<environment-ID>-xxxxxx

  [============================]  1 min (complete)
Activity ID succeeded
Deleted remote Git branch <environment-ID>
Run git fetch --prune to remove deleted branches from your local cache.
TIP
若要啟用非使用中的環境，請使用magento-cloud environment:activate命令。

與遠端環境互動

在您設定SSH金鑰之後，您可以從本機工作區連線到遠端環境，並與您的專案服務互動並修改設定。

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26