使用Cloud Console管理分支
您可以使用Cloud Console或magento-cloud
CLI管理環境。 您的專案檔案儲存在Git存放庫中。 您可以使用Git命令來管理您的程式碼,但magento-cloud
CLI的設計是要與平台功能互動,而Git命令則否。 請參閱雲端CLI主題中的Git命令。
此主題討論如何使用Cloud Console來:
- 新增或刪除環境
- 從父環境同步(
git pull
) - 將(
git push
)合併至父環境
master
分支中分支。建立環境
分支策略會使用常見的Git工作流程,您可在其中開發程式碼並在開發分支中新增擴充功能。 請參閱入門者和Pro架構概述。
- 首先,從
master
分支建立staging
分支,然後從staging
分支進行開發。 - 對於Pro,請從
Integration
環境建立開發分支。
您的帳戶支援有限數量的 {width="32"} (active) and an unlimited number of {width="32"} (非使用中)開發分支。 僅使用Cloud Console或雲端CLI新增或刪除分支,以管理作用中或非作用中分支。 刪除分支之前,請先停用該分支,它仍保留在 環境 清單中,做為 非使用中。 您可以稍後重新啟用分支,或是在環境設定或使用Cloud CLI中刪除分支。
如果您需要其他使用中的環境進行開發,請提交支援票證。
若要新增分支:
-
從 所有專案 清單中選取專案。
-
選取環境。
note tip TIP 您的新分支是從此環境複製。 選擇與您要建立之環境類似的父環境。 -
按一下 Branch。
{width="150"}
-
在 分支來源…… 表單中,輸入分支名稱。
環境 名稱 與環境 ID 不同,前提是在環境名稱中使用空格或大寫字母。 環境ID包含所有小寫字母、數字和允許的符號。 環境名稱中的大寫字母會在ID中轉換為小寫;環境名稱中的空格會轉換為破折號。
環境名稱 不能 包含保留給Linux shell或規則運算式的字元。 禁止使用的字元包括大括弧(
{ }
)、括弧、星號(*
)、角括弧(>
)、&符號(&
)、百分比(%
)和其他字元。 -
選取 Environment type。
-
按一下 Create Branch。
-
環境正在部署,請稍候。
部署期間,環境狀態為 處理中。 成功部署後,success 的狀態會變更為綠色核取記號。
建立非使用中分支
您無法從Adobe Commerce Cloud主控台或CLI建立非使用中分支。 如果您想建立非作用中分支,請在Git存放庫上建立它,並在命令上使用environment.Parent
選項進行推送。
git push -o "environment.Parent=<parent branch>" <origin> <branch>
刪除環境
您必須先停用環境,才能刪除環境。 一旦環境處於非使用中狀態,您就可以將其刪除。
若要停用環境:
-
從 所有專案 清單中選取專案。
-
從導覽列 環境 清單中選取環境。
-
按一下頂端導覽列右側的設定圖示,開啟環境設定。
-
在 General 標籤上,向下捲動至 Deactivate environment 區段,然後按一下 Deactivate environment and delete data 並遵循指示。
同步環境
同步環境(或分支)與git pull origin <parent>
相同。 您可以從上層環境同步更新的程式碼。 您可以透過Cloud Console在所有入門和Pro環境中使用此功能。
對於Pro計畫,您可以從測試和生產同步到您的master
分支。 此同步僅提取和推送程式碼,不會提取資料。 若要同步資料,請傾印資料庫資料並將其推送到另一個環境的資料庫。 請參閱移轉及部署靜態檔案和資料。
若要同步環境:
-
從 所有專案 清單中選取專案。
-
在環境清單中,按一下要同步的分支名稱。
-
按一下(同步)。
{width="150"}
-
選取要同步的專案。
- 取代資料 — (資料與檔案)同步來自父分支的資料庫與內容檔案中的變更。
- 合併(Merge) - (程式碼)從父分支同步更新的程式碼。
這樣也會建置CLI指令供您複製和使用。
-
按一下 同步。
與上層環境合併
合併環境(或分支)與git push origin
相同。 您可以合併以將更新後的程式碼從環境推送至其父環境。 您可以將此程式碼合併至master
。 您可以使用merge
命令部署至測試和生產環境。
若要與父環境合併:
-
從 所有專案 清單中選取專案。
-
在環境清單中,按一下要合併的分支名稱。
-
按一下(合併)。
{width="150"}
-
按一下 合併 並確認動作。
檢視記錄
透過Cloud Console,您可以檢閱環境的各種記錄,包括建置、部署和部署歷史記錄。
對於 Starter,您可以檢閱組建和部署記錄檔以及部署歷程記錄。 這些環境包括master
(生產)分支以及從中建立的所有分支。
對於 Pro,您可以在每個環境中檢閱下列記錄:
- 整合 — 建置、部署和部署歷史記錄
- 測試 — 建置記錄檔和部署歷史記錄。 使用SSH登入伺服器以檢視部署記錄。
- 生產 — 建置記錄檔和部署歷史記錄。 使用SSH登入伺服器以檢視部署記錄。
若要檢視Cloud Console 中的記錄檔:
-
從 所有專案 清單中選取專案。
-
選取環境。
環境檢視提供活動清單,其中顯示 最近 個事件,每個嘗試的動作會有一個專案,包括同步、合併、分支、備份等。 按一下 全部 以取得完整的部署歷程記錄。
-
若要檢視建置記錄,請選取帳戶上每個部署記錄的「成功」或「失敗」連結。
從私人Git存放庫提取程式碼
您在雲端基礎結構專案上的Adobe Commerce可包含來自私人Git存放庫的程式碼。 例如,您可能在私人存放庫中擁有自訂模組或主題的程式碼。 若要這麼做,您必須將專案的公開SSH金鑰新增至您的私人Git存放庫,並更新專案composer.json
檔案。
若要將部署金鑰新增至您的私人GitHub存放庫,您必須是該存放庫的管理員。 GitHub允許您僅對一個存放庫使用部署金鑰。
如果您偏好讓專案存取多個存放庫,您可以將SSH金鑰附加至自動使用者帳戶。 因為此帳戶不是由人類使用,所以它稱為電腦使用者。 將電腦帳戶新增為共同作業人員,或將電腦使用者新增至具有存放庫存取權的團隊。
若要尋找您的SSH公開金鑰:
-
從 所有專案 清單中選取專案。
-
按一下上方導覽列右側的設定圖示。
-
在 專案設定 中,按一下 Deploy Key。
-
將部署金鑰複製到剪貼簿,以便用於下列其中一個Git型方法:
輸入您的GitHub部署金鑰
在GitHub上,部署金鑰預設為唯讀。
若要輸入您的專案公開金鑰做為GitHub部署金鑰:
-
以管理員身分登入您的GitHub存放庫。
-
按一下存放庫 Settings 標籤。
note note NOTE 如果沒有看到此選項,表示您不是以存放庫管理員的身分登入,且無法完成此工作。 請要求您的GitHub存放庫管理員執行此操作。 -
在左側導覽的 設定 索引標籤上,按一下 Deploy Keys。
-
按一下 Add deploy key。
-
按照提示操作。
在composer.json
中,使用<user>@<host>:<.git</code>
格式,若使用非標準連線埠,則使用ssh://<user>@<host>:<port>/<path>.git
。
輸入您的Bitbucket部署金鑰
若要輸入您的專案公開金鑰做為Bitbucket部署金鑰:
-
以管理員身分登入您的Bitbucket存放庫。
-
在左側導覽中,按一下 Settings。
-
按一下「一般> Deployment Keys」。
-
按一下 Add Key。
-
按照提示操作。
輸入您的GitLab部署金鑰
若要將專案的公開SSH金鑰新增為GitLab部署金鑰:
-
以擁有者身分登入您的GitLab存放庫。
-
確認已為您的專案啟用 管道 選項:
- 在專案設定中,展開 Visibility, project, features, permissions 區段。
- 必要時,按一下 Pipelines 以啟用選項。
-
將您的公開SSH金鑰新增至CI/CD設定。
- 在左側導覽中,按一下「設定> CI / CD」。
- 按一下部署金鑰 展開 以設定金鑰。
- 在 部署金鑰 表單中,將部署金鑰名稱新增至 Title 欄位,並將您的公開SSH金鑰貼到 Key 欄位。
- 按一下 Add Key 以儲存組態。
保護環境和分支的安全
您可以使用Cloud Console,透過網頁瀏覽器從任何位置存取您的專案和環境。 您可以為生產環境、商店和網站設定安全性。 本節可協助您確保嚴格針對開發人員、DBA等的整合與測試環境的安全性。
保護環境:
-
從 所有專案 清單中選取專案。
-
選取環境並按一下導覽列上的設定圖示。
-
在環境設定 一般 標籤上,按一下 HTTP access control enabled 的 開啟 以啟用安全存取。 您可以在認證或IP位址之間選擇,以篩選存取許可權。
-
若要依認證篩選,請按一下 Add Login,輸入使用者名稱和密碼,然後按一下 Add Login 以新增。
-
若要依IP位址篩選,請在含有
deny
或allow
的清單中輸入IP位址。 例如:code language-text 123.456.789.111/29 allow 123.456.789.112/29 allow 234.123.567.111/29 allow 0.0.0.0/0 deny
-
按一下 Save。 這會重新部署環境以更新安全性和設定。 Adobe建議在完成安全性設定後測試環境。