本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 CodeBuild 中自動探索報告
<a name="report-auto-discover"></a>

透過自動探索，CodeBuild 會在建置階段完成後搜尋所有建置檔案、搜尋任何支援的報告檔案類型，並自動建立新的測試和程式碼涵蓋範圍報告群組和報告。對於任何發現的報告類型，CodeBuild 會使用下列模式建立新的報告群組：

```
<project-name>-<report-file-format>-AutoDiscovered
```

**注意**  
如果發現的報告檔案具有相同的格式類型，則會將其放置在相同的報告群組或報告中。

報告自動探索是由您的專案環境變數設定：

`CODEBUILD_CONFIG_AUTO_DISCOVER`  
此變數會判斷是否在建置期間停用報告自動探索。根據預設，所有組建都會啟用報告自動探索。若要停用此功能，請將 `CODEBUILD_CONFIG_AUTO_DISCOVER`設定為 `false`。

`CODEBUILD_CONFIG_AUTO_DISCOVER_DIR`  
（選用） 此變數決定 CodeBuild 搜尋潛在報告檔案的位置。請注意，根據預設，CodeBuild `**/*` 預設會在 中搜尋。

這些環境變數可以在建置階段期間修改。例如，如果您只想啟用 git `main` 分支上建置的報告自動探索，您可以在建置程序期間檢查 git 分支，如果建置不在`main`分支上，則`CODEBUILD_CONFIG_AUTO_DISCOVER`設定為 false。您可以使用主控台或使用專案環境變數來停用報告自動探索。

**Topics**
+ [使用主控台設定報告自動探索](#report-auto-discover-configure-console)
+ [使用專案環境變數設定報告自動探索](#report-auto-discover-configure-variable)

## 使用主控台設定報告自動探索
<a name="report-auto-discover-configure-console"></a>

使用下列程序，使用主控台設定報告自動探索。

**使用主控台設定報告自動探索**

1. 建立組建專案或選擇要編輯的組建專案。如需詳細資訊，請參閱 [在 中建立建置專案 AWS CodeBuild](create-project.md) 或 [在 中變更建置專案設定 AWS CodeBuild](change-project.md)。

1. 在**環境中**，選取**其他組態**。

1. 若要停用報告自動探索，請在**報告自動探索**中，選取**停用報告自動探索**。

1. （選用） 在**自動探索目錄 - 選用**中，輸入 CodeBuild 的目錄模式以搜尋支援的報告格式檔案。請注意，`**/*`根據預設，CodeBuild 會在 中搜尋。

## 使用專案環境變數設定報告自動探索
<a name="report-auto-discover-configure-variable"></a>

使用下列程序，使用專案環境變數設定報告自動探索。

**使用專案環境變數設定報告自動探索**

1. 建立組建專案或選擇要編輯的組建專案。如需詳細資訊，請參閱 [在 中建立建置專案 AWS CodeBuild](create-project.md) 或 [在 中變更建置專案設定 AWS CodeBuild](change-project.md)。

1. 在**環境變數**中，執行下列動作：

   1. 若要停用報告自動探索，請在**名稱**中輸入 ，**CODEBUILD\$1CONFIG\$1AUTO\$1DISCOVER**並在**值**中輸入 **false**。這會停用報告自動探索。

   1. （選用） 針對**名稱**，輸入 **CODEBUILD\$1CONFIG\$1AUTO\$1DISCOVER\$1DIR** ，針對**值**，輸入 CodeBuild 應搜尋支援報告格式檔案的目錄。例如， 會在 `output`目錄中`output/*xml`搜尋`.xml`檔案