在 Cloud Manager 中新增私人存放庫 private-repositories

了解如何設定 Cloud Manager 以搭配使用您自己的私人 GitHub 存放庫。

概觀 overview

透過設定 Cloud Manager 以搭配使用您自己的私人 GitHub 存放庫,您可以透過 Cloud Manager 直接在 GitHub 存放庫中驗證程式碼,無需始終將程式碼與 Adobe 存放庫保持同步。

NOTE
這是公開 GitHub 的專屬功能。不支援自行託管的 GitHub。

設定 configuration

設定包括兩個主要步驟:

新增存放庫 add-repo

  1. 在 Cloud Manager 中,從​ 方案概觀 ​頁面,點選或按一下 存放庫 標籤以切換到​ 存放庫 ​頁面並按一下​ 新增存放庫

  2. 在​ 新增存放庫 ​對話框,選取​ 私人存放庫 ​作為存放庫類型。

  3. 提供存放庫的詳細資訊

    • 存放庫名稱 - 讓人易懂的名稱
    • 存放庫 URL - 存放庫的 URL,必須以 .git 結尾
    • 說明 (選擇性) - 必要時提供存放庫更長的說明

    新增自己的存放庫

  4. 點選或按一下​ 儲存

TIP
如需關於在 Cloud Manager 管理存放庫的詳細資訊,請參閱文件Cloud Manager 存放庫

私人存放庫所有權驗證 validate-ownership

Cloud Manager 現在知道您的 GitHub 存放庫,但仍然需要存取它。若要授予存取權,您需要安裝 Adobe GitHub 應用程式並驗證您擁有指定的存放庫。

  1. 新增您自己的存放庫,私人存放庫所有權驗證 ​對話框隨即開啟。

    私人存放庫所有權驗證

  2. Cloud Manager 使用 GitHub 應用程式與您的存放庫安全地互動。

    • 您 GitHub 組織的擁有者必須安裝位於 https://github.com/apps/cloud-manager-for-aem 的應用程式,並授予存放庫的存取權。
    • 如需深入了解如何完成此操作,請參閱 GitHub 的文件。
  3. 為了提高安全性,您必須在存放庫的預設分支中建立密碼檔案。點選或按一下​ 產生

  4. 點選或按一下​ 確認 ​來確認產生密碼檔案。

    確認密碼產生

  5. 回到​ 私人存放庫所有權驗證 ​視窗中,Cloud Manager 已在​ 密碼檔案內容 ​欄位產生私人檔案內容。複製該欄位中的內容。

    • 密碼檔案的內容只會顯示一次。如果您在關閉此視窗之前未複製內容,則需要重新產生密碼。

    複製密碼檔案內容

  6. 在 GitHub 存放庫的預設分支中建立一個名為 .well-known/adobe/cloud-manager-challenge 的新檔案,並將密碼檔案內容貼到該檔案並儲存。

  7. 當安裝好應用程式且密碼檔案位於存放庫後,您可以點選或按一下​ 私人存放庫所有權驗證 ​對話框中的​ 驗證

可以按任何順序安裝應用程式並建立密碼檔案。但是,必須先完成這兩個步驟才能進行驗證。

在驗證之前,存放庫將以紅色圖示列出,表示它尚未驗證且不能使用。

未經驗證的存放庫

請注意,類型 ​欄可以輕鬆識別 Adobe 提供的存放庫 (Adobe) 和您自己的 GitHub 存放庫 (GitHub)。

如果您需要日後返回存放庫以完成驗證,請在​ 存放庫 ​頁面,在代表剛新增之 GitHub 存放庫的列中,點選或按一下省略符號按鈕,然後從下拉式選單中選取​ 所有權驗證

將私人存放庫與 Cloud Manager 搭配使用 using

在 Cloud Manager 中驗證 GitHub 存放庫後,整合即完成,您可以在 Cloud Manager 中使用該存放庫。

  1. 當您建立提取要求時,GitHub 檢查將自動啟動。

    GitHub 檢查

  2. 對於每個提取要求,全端程式碼品質管道將自動建立。此管道在每次提取要求更新時啟動。

  3. GitHub 檢查保持運作狀態,直到程式碼品質檢查完成。然後程式碼品質結果將傳播到 GitHub 檢查。

    GitHub 程式碼品質檢查

當提取要求關閉或合併時,建立的全端程式碼品質管道將自動刪除。

TIP
有關執行提取請求檢查時透過 GitHub 提供的資訊詳情,請參閱文件「GitHub 檢查附註」。
TIP
您可以控制自動建立的管道以驗證對私人存放庫的每個提取請求。請參閱文件「私人存放庫的 GitHub 檢查設定,了解更多資訊。

將私人存放庫與管道建立關聯 pipelines

經驗證的私人存放庫可以與全端管道建立關聯。

限制 limitations

將私人存放庫與 Cloud Manager 搭配使用時會有某些限制。

  • 您無法暫停 Cloud Manager 的 GitHub 檢查對提取要求進行驗證。
    • 如果 GitHub 存放庫在 Cloud Manager 已經過驗證,為該存放庫建立的提取要求,Cloud Manager 將一律進行驗證。
  • 如果您的 GitHb 組織已移除 Adobe GitHub 應用程式,這將移除所有存放庫的提取要求驗證。
  • 在生產全端管道上使用私人存放庫時,不會建立和推送 Git 標記。
  • 當新提交被推送到所選分支時,使用私人存放庫和提交建置觸發器的管道不會自動啟動。
  • 成品重複使用功能不適用於私人存放庫。
recommendation-more-help
c6cdc82b-cee9-48e0-a6ee-48149d5e72c3