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

透過設定Cloud Manager與託管於github.com的私人GitHub存放庫整合,您可以使用Cloud Manager直接在GitHub中驗證您的程式碼。 此頁面適用於github.com上託管的任何存放庫,不論GitHub計畫為何(免費、Pro、Team或Enterprise Cloud)。 此設定免除了定期將程式碼與Adobe存放庫同步的需求。

IMPORTANT
Cloud Manager會根據存放庫的託管位置,以下列兩種方式之一驗證GitHub存放庫所有權:
  • 此頁面適用於github.com上託管的任何存放庫,不論GitHub計畫為何(免費、Pro、Team或Enterprise Cloud)。 這些存放庫會使用Adobe GitHub應用程式來驗證擁有權。 不需要webhook設定,因為Cloud Manager會直接透過應用程式整合。

  • 若要新增下列任何存放庫型別,請參閱在Cloud Manager中新增外部存放庫。 這些存放庫會使用PAT (個人存取權杖)和手動設定的webhook來驗證所有權。

    • GitHub Enterprise Server (自行託管的GitHub版本)存放庫。
    • GitLab (gitlab.com和自託管版本的GitLab)存放庫。
    • Bitbucket (只有bitbucket.org,雲端版本)存放庫。 自2024年2月15日起,已不再使用自行託管的Bitbucket版本。
    • Azure DevOps (dev.azure.com)存放庫。

設定 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使用私人GitHub存放庫:

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

    GitHub 檢查

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

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

    GitHub 程式碼品質檢查

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

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

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

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

限制 limitations

下列限制適用於搭配Cloud Manager使用私人存放庫。

  • 在生產全端管道上使用私人存放庫時,不會建立和推送 Git 標記。
  • 如果從您的GitHub組織移除Adobe GitHub應用程式,它就會移除所有存放庫的提取請求驗證功能。
  • 當新認可推送至選取的分支時,使用私人GitHub存放庫和「在認可」組建觸發器的管道不會自動啟動。
  • 成品重複使用功能不適用於私人存放庫。
  • 您無法使用 Cloud Manager 的 GitHub 檢查來暫停提取請求驗證。 如果已在Cloud Manager中驗證GitHub存放庫,Cloud Manager會一律嘗試驗證為該存放庫建立的提取請求。
  • 如果您的GitHub組織強制執行IP限制,請開啟支援案例以取得必須允許的IP位址清單。
recommendation-more-help
experience-manager-cloud-service-help-main-toc