文件AEM as a Cloud Service使用手冊

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

Last update: Thu Oct 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
  • 開發人員

透過設定Cloud Manager以與您的私人GitHub存放庫整合，您可以直接在GitHub中使用Cloud Manager驗證您的程式碼。 此設定免除了定期將計畫碼與Adobe存放庫同步的需求。

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

設定 configuration

在Cloud Manager中設定私人GitHub存放庫包含兩個步驟：

  1. 將私人GitHub存放庫新增至選取的方案。
  2. 然後，驗證私人GitHub存放庫的所有權。

將私人GitHub存放庫新增到計畫 add-repo

  1. 在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。

  2. 在​ 我的程式 ​主控台上，選取您要連結私人Git存放庫的程式。

  3. 在側邊選單中，在​ 服務 ​下，選取 資料夾圖示 存放庫。

    儲存庫頁面

  4. 在右上角附近的​ 存放庫 ​頁面，按一下​ 新增存放庫。

  5. 在「新增存放庫」對話框內，選取「私人存放庫」作為存放庫類型。

    新增自己的存放庫

  6. 在每個對應欄位中，提供關於存放庫的下列詳細資料：

    table 0-row-2 1-row-2 2-row-2 3-row-2
    欄位 說明
    存放庫名稱 您的新存放庫的生動名稱。
    存放庫 URL 私人存放庫的URL，必須以.git結尾。
    例如，https://github.com/org-name/repo-name.git(URL 路徑僅用於插圖目的)。
    說明 (選填) 存放庫的詳細描述。

  7. 選取​ 儲存。
    現在您可以驗證私人存放庫的所有權。

TIP
如需關於在 Cloud Manager 管理存放庫的詳細資訊，請參閱「Cloud Manager 存放庫」。

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

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

若要驗證私人GitHub存放庫的所有權：

  1. 新增您自己的存放庫後，請依照​ 私人存放庫所有權驗證 ​對話方塊中的剩餘步驟操作。

    私人存放庫所有權驗證

    table 0-row-2 1-row-2 2-row-2
    說明
    步驟1： GitHub應用程式 Cloud Manager會使用GitHub應用程式，安全地與您的私人存放庫互動。
    ·您GitHub組織的所有者必須安裝位於https://github.com/apps/cloud-manager-for-aem的應用程式並授與存放庫的存取權。
    ·如需安裝和授與存取權完成的詳細資訊，請參閱GitHub的檔案。
    步驟2：機密檔案 若要增強安全性，您必須在存放庫的預設分支中建立機密檔案。
    ·按一下​ 產生，然後按一下​ 確認。 Cloud Manager會在​ 機密檔案內容 ​文字欄位中產生私人檔案的內容。
    ·按一下 復製圖示 以複製該欄位中的內容。 密碼檔案的內容只會顯示一次。如果您在關閉此對話方塊之前未複製內容，請重新產生密碼。

  2. 在GitHub存放庫的預設分支中建立名為的新檔案：

    .well-known/adobe/cloud-manager-challenge

  3. 將機密檔案內容貼到您剛建立的新檔案中並儲存。

    安裝應用程式且存放庫中存在機密檔案後，請繼續此步驟。

  4. 在​ 私人存放庫所有權驗證 ​對話方塊中，按一下​ 驗證。

您可以安裝應用程式，並依任何順序建立機密檔案。 不過，必須先完成這兩個步驟才能進行驗證。

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

未經驗證的存放庫

存放庫 ​頁面上資料表中的​ Type ​資料行會識別Adobe提供的存放庫(Adobe)與您自己的私人存放庫(GitHub)。

如果您稍後需要返回存放庫以完成驗證，請在​ 存放庫 ​頁面上，按一下代表您剛剛新增的GitHub存放庫之列中的 更多圖示 。 在下拉式清單中，選取​ 所有權驗證。

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

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

若要透過 Cloud Manager 使用私人存放庫：

  1. 當您建立提取請求時，會自動啟動 GitHub 檢查。

    GitHub 檢查

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

  3. GitHub檢查會維持在執行狀態，直到程式碼品質檢查完成為止。 程式碼品質結果隨後會傳播至 GitHub 檢查。

    GitHub 程式碼品質檢查

當提取請求被合併或關閉時，建立的完整棧疊計畫碼品質管道會自動刪除。

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

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

經過驗證的私人存放庫可以與 全堆疊和前端管道相關聯。

限制 limitations

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

  • 私人存放庫不支援 Web 層和設定管道。
  • 在生產全端管道上使用私人存放庫時，不會建立和推送 Git 標記。
  • 如果AdobeGitHub應用程式從您的GitHub組織移除，其會移除所有存放庫的提取請求驗證功能。
  • 當新提交被推送到所選分支時，使用私人存放庫和提交建置觸發器的管道不會自動啟動。
  • 成品重複使用功能不適用於私人存放庫。
  • 您無法使用Cloud Manager的GitHub檢查來暫停提取請求驗證。
    如果已在Cloud Manager中驗證GitHub存放庫，Cloud Manager會一律嘗試驗證為該存放庫建立的提取請求。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab