在 Cloud Manager 中新增私人存放庫 private-repositories
了解如何設定 Cloud Manager 以搭配使用您自己的私人 GitHub 存放庫。
概觀 overview
透過設定 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
的新檔案,並將密碼檔案內容貼到該檔案並儲存。 -
當安裝好應用程式且密碼檔案位於存放庫後,您可以點選或按一下 私人存放庫所有權驗證 對話框中的 驗證。
可以按任何順序安裝應用程式並建立密碼檔案。但是,必須先完成這兩個步驟才能進行驗證。
在驗證之前,存放庫將以紅色圖示列出,表示它尚未驗證且不能使用。
請注意,類型 欄可以輕鬆識別 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 應用程式,這將移除所有存放庫的提取要求驗證。
- 在生產全端管道上使用私人存放庫時,不會建立和推送 Git 標記。
- 當新提交被推送到所選分支時,使用私人存放庫和提交建置觸發器的管道不會自動啟動。
- 成品重複使用功能不適用於私人存放庫。