使用CLI管理分支

若要安裝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