GitHub

登入 AWS 管理主控台並開啟 Amazon Kendra主控台。

從左側導覽窗格中，選擇索引，然後從索引清單中選擇您要使用的索引。

在入門頁面上，選擇新增資料來源。

在新增資料來源頁面上，選擇 GitHub 連接器，然後選擇新增連接器。如果使用第 2 版 （如適用），請選擇 GitHub 連接器搭配「V2.0」標籤。

在指定資料來源詳細資訊頁面上，輸入下列資訊：

1. 在名稱和描述中，針對資料來源名稱 - 輸入資料來源的名稱。您可以包含連字號，但不能包含空格。

2. （選用） 描述 — 輸入資料來源的選用描述。

3. 在預設語言 - 選擇語言來篩選索引的文件。除非您另有指定，否則語言預設為英文。文件中繼資料中指定的語言會覆寫選取的語言。

4. 在標籤中，針對新增標籤 - 包含選用標籤，以搜尋和篩選您的資源或追蹤您的AWS成本。

5. 選擇下一步。

在定義存取和安全性頁面上，輸入下列資訊：

1. GitHub 來源 - 在 GitHub Enterprise Cloud 和 GitHub Enterprise Server 之間進行選擇。

2. GitHub 主機 URL — 例如，GitHub 雲端的主機 URL 可以是 https://api.github.comGitHub 伺服器的主機 URL 可以是 https：//on-prem-host-url/api/v3/。

3. GitHub 組織名稱 — 輸入您的 GitHub 組織名稱。您可以在 GitHub 帳戶中找到組織資訊。

   注意

   GitHub 連接器支援為每個資料來源連接器執行個體爬取單一組織。

4. 授權：如果您有 ACL 並想要將其用於存取控制，請開啟或關閉文件的存取控制清單 (ACL) 資訊。ACL 指定使用者可以和群組存取哪些文件。ACL 資訊用於根據使用者或其群組對文件的存取來篩選搜尋結果。如需詳細資訊，請參閱使用者內容篩選。

5. AWS Secrets Managersecret - 選擇現有的秘密或建立新的Secrets Manager秘密，以存放您的 GitHub 身分驗證登入資料。如果您選擇建立新的秘密，則會AWS Secrets Manager開啟秘密視窗。

   1. 在建立AWSSecrets Manager秘密視窗中輸入下列資訊：

      1. 機密名稱 - 輸入您的機密名稱。字首「AmazonKendra-GitHub-」會自動新增至您的秘密名稱。

      2. 對於 GitHub 字符 - 輸入在 GitHub 中設定的身分驗證憑證值。

   2. 儲存並新增您的秘密。

6. Virtual Private Cloud (VPC) — 您可以選擇使用 VPC。若是如此，您必須新增子網路和 VPC 安全群組。

7. 身分爬蟲程式 - 指定是否開啟 Amazon Kendra的身分爬蟲程式。身分爬蟲程式會使用文件的存取控制清單 (ACL) 資訊，根據使用者或其群組對文件的存取來篩選搜尋結果。如果您有文件的 ACL 並選擇使用您的 ACL，您也可以選擇開啟Amazon Kendra身分爬蟲程式，以設定搜尋結果的使用者內容篩選。否則，如果關閉身分識別編目程式，則所有文件都可公開搜尋。如果您想要使用文件的存取控制，而身分識別編目程式為關閉狀態，您可以改用 PutPrincipalMapping API 來上傳使用者和群組存取資訊，以供使用者內容篩選使用。

8. IAMrole - 選擇現有IAM角色或建立新的IAM角色，以存取您的儲存庫登入資料和索引內容。

   注意

   IAM用於索引的 角色無法用於資料來源。如果您不確定現有角色是否用於索引或常見問答集，請選擇建立新角色以避免錯誤。

9. 選擇下一步。

在設定同步設定頁面上，輸入下列資訊：

1. 選取儲存庫 - 選擇爬取所有儲存庫或選取。

   如果您選擇編目選取儲存庫，請新增儲存庫的名稱，並選擇性地新增任何特定分支的名稱。

2. 內容類型 - 選擇您要從檔案、問題、提取請求等中抓取的內容類型。

3. Regex 模式 - 新增規則表達式模式，以包含或排除特定檔案。

4. 同步模式 - 選擇您希望在資料來源內容變更時更新索引的方式。當您Amazon Kendra第一次使用 同步資料來源時，預設會爬取所有內容並編製索引。如果初始同步失敗，即使您未選擇完全同步做為同步模式選項，仍必須執行資料的完整同步。

   • 完全同步：新編製所有內容的索引，每次資料來源與索引同步時取代現有的內容。

   • 新的、修改過的同步：每次資料來源與索引同步時，僅索引新的和修改的內容。 Amazon Kendra可以使用資料來源的機制來追蹤內容變更，以及自上次同步以來變更的索引內容。

   • 新的、已修改、已刪除的同步：每次資料來源與索引同步時，僅索引新的、已修改和已刪除的內容。Amazon Kendra 可以使用資料來源的機制來追蹤自上次同步以來變更的內容和索引內容。

5. 在頻率的同步執行排程中，選擇同步資料來源內容和更新索引的頻率。

6. 選擇下一步。

在設定欄位映射頁面上，輸入下列資訊：

1. 預設資料來源欄位 - 從您要映射至索引Amazon Kendra的產生預設資料來源欄位中選取 。

2. 新增欄位 - 新增自訂資料來源欄位，以建立要映射的索引欄位名稱和欄位資料類型。

3. 選擇下一步。

在檢閱和建立頁面上，檢查您輸入的資訊是否正確，然後選取新增資料來源。您也可以選擇從此頁面編輯您的資訊。成功新增資料來源後，您的資料來源將顯示在資料來源頁面上。