在 Cloud Manager 中新增私人存放庫 private-repositories
透過設定 Cloud Manager 以搭配使用您自己的私人 GitHub 存放庫,您可以透過 Cloud Manager 直接在 GitHub 存放庫中驗證程式碼,無需始終將程式碼與 Adobe 存放庫保持同步。
設定 configuration
設定包括兩個主要步驟:
新增存放庫 add-repo
-
在Cloud Manager中,從 方案總覽 頁面,選取 存放庫 索引標籤以切換至 存放庫 頁面,然後按一下 新增存放庫。
-
在 新增存放庫 對話框,選取 私人存放庫 作為存放庫類型。
-
提供存放庫的詳細資訊
- 存放庫名稱 - 讓人易懂的名稱
- 存放庫 URL - 存放庫的 URL,必須以
.git
結尾 - 說明 (選擇性) - 必要時提供存放庫更長的說明
-
選取「儲存」。
私人存放庫所有權驗證 validate-ownership
Cloud Manager 現在知道您的 GitHub 存放庫,但仍然需要存取它。若要授予存取權,您需要安裝 Adobe GitHub 應用程式並驗證您擁有指定的存放庫。
-
新增您自己的存放庫後,私人存放庫所有權驗證 對話方塊會開啟。
-
Cloud Manager 使用 GitHub 應用程式與您的存放庫安全地互動。
- 您 GitHub 組織的擁有者必須安裝位於
https://github.com/apps/cloud-manager-for-aem
的應用程式,並授予存放庫的存取權。 - 如需有關如何執行此動作的詳細資訊,請參閱GitHub的檔案。
- 您 GitHub 組織的擁有者必須安裝位於
-
為了提高安全性,您必須在存放庫的預設分支中建立密碼檔案。選取 產生。
-
點選或按一下 確認 來確認產生密碼檔案。
-
回到 私人存放庫所有權驗證 視窗中,Cloud Manager 已在 密碼檔案內容 欄位產生私人檔案內容。複製該欄位中的內容。
- 密碼檔案的內容只會顯示一次。如果您在關閉此視窗之前未複製內容,請重新產生密碼。
-
在 GitHub 存放庫的預設分支中建立一個名為
.well-known/adobe/cloud-manager-challenge
的新檔案,並將密碼檔案內容貼到該檔案並儲存。 -
安裝應用程式且密碼檔存在於存放庫後,您可以在 私人存放庫所有權驗證 對話方塊中選取 驗證。
可以按任何順序安裝應用程式並建立密碼檔案。但是,必須先完成這兩個步驟才能進行驗證。
在驗證之前,存放庫將以紅色圖示列出,表示它尚未驗證且尚無法使用。
Type 欄可輕鬆識別Adobe提供的存放庫(Adobe)和您自己的GitHub存放庫(GitHub)。
如果您稍後需要返回存放庫以完成驗證,請在 存放庫 頁面上,選取代表您剛才新增的GitHub存放庫一列中的省略符號按鈕,然後從下拉式選單中選取 所有權驗證。
將私人存放庫與 Cloud Manager 搭配使用 using
在 Cloud Manager 中驗證 GitHub 存放庫後,整合即完成,您可以在 Cloud Manager 中使用該存放庫。
-
當您建立提取要求時,GitHub 檢查將自動啟動。
-
對於每個提取要求,全端程式碼品質管道將自動建立。此管道在每次提取要求更新時啟動。
-
GitHub 檢查保持運作狀態,直到程式碼品質檢查完成。然後程式碼品質結果將傳播到 GitHub 檢查。
當提取要求關閉或合併時,建立的全端程式碼品質管道將自動刪除。
將私人存放庫與管道建立關聯 pipelines
經驗證的私人存放庫可以與全端和前端管道建立關聯。
限制 limitations
將私人存放庫與 Cloud Manager 搭配使用時會有某些限制。
- 您無法使用Cloud Manager的GitHub檢查來暫停提取請求驗證。
- 如果 GitHub 存放庫在 Cloud Manager 已經過驗證,為該存放庫建立的提取要求,Cloud Manager 將一律進行驗證。
- 如果您的 GitHb 組織已移除 Adobe GitHub 應用程式,這將移除所有存放庫的提取要求驗證。
- 私人存放庫不支援 Web 層和設定管道。
- 在生產全端管道上使用私人存放庫時,不會建立和推送 Git 標記。
- 當新提交被推送到所選分支時,使用私人存放庫和提交建置觸發器的管道不會自動啟動。
- 成品重複使用功能不適用於私人存放庫。