기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 보고서 그룹 만들기
CodeBuild 콘솔 AWS CLI, 또는 buildspec 파일을 사용하여 보고서 그룹을 생성할 수 있습니다. IAM 역할에는 보고서 그룹을 생성하는 데 필요한 권한이 있어야 합니다. 자세한 내용은 [테스트 보고서 권한](test-permissions.md) 단원을 참조하십시오.
**Topics**
+ [보고서 그룹 생성(buildspec)](#test-report-group-create-buildspec)
+ [보고서 그룹 만들기(콘솔)](#test-report-group-create-console)
+ [보고서 그룹 생성(CLI)](#test-report-group-create-cli)
+ [보고서 그룹 생성(CloudFormation)](#test-report-group-create-cfn)
## 보고서 그룹 생성(buildspec)
buildspec을 사용하여 만든 보고서 그룹은 원시 테스트 결과 파일을 내보내지 않습니다. 보고서 그룹을 보고 내보내기 설정을 지정할 수 있습니다. 자세한 내용은 [보고서 그룹 업데이트](report-group-export-settings.md) 단원을 참조하십시오.
**buildspec 파일을 사용하여 보고서 그룹을 생성하려면**
1. AWS 계정의 보고서 그룹과 연결되지 않은 보고서 그룹 이름을 선택합니다.
1. 이 이름으로 buildspec 파일의 `reports` 섹션을 구성합니다. 이 예에서는 보고서 그룹 이름이 `new-report-group`이고, 사용 테스트 케이스는 JUnit 프레임워크로 생성됩니다.
```
reports:
new-report-group: #surefire junit reports
files:
- '**/*'
base-directory: 'surefire/target/surefire-reports'
```
Buildspec의 환경 변수를 사용하여 보고서 그룹 이름을 지정할 수도 있습니다.
```
version: 0.2
env:
variables:
REPORT_GROUP_NAME: "new-report-group"
phases:
build:
commands:
- ...
...
reports:
$REPORT_GROUP_NAME:
files:
- '**/*'
base-directory: 'surefire/target/surefire-reports'
```
자세한 내용은 [테스트 파일 지정](report-group-test-cases.md) 및 [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file) 섹션을 참조하세요.
1. `commands` 섹션에서, 테스트를 실행할 명령을 지정합니다. 자세한 내용은 [테스트 명령 지정](report-group-test-case-commands.md) 단원을 참조하십시오.
1. 빌드를 실행합니다. 빌드가 완료되면 `project-name-report-group-name` 형식을 사용하는 이름으로 새 보고서 그룹이 만들어집니다. 자세한 내용은 [보고서 그룹 이름 지정](test-report-group-naming.md) 단원을 참조하십시오.
## 보고서 그룹 만들기(콘솔)
다음 절차에서는 AWS Management Console을 사용하여 보고서 그룹을 생성합니다.
**보고서 그룹을 생성하려면**
1. [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) AWS CodeBuild 콘솔을 엽니다.
1. 탐색 창에서 **Report groups(보고서 그룹)**을 선택합니다.
1. **Create report(보고서 그룹 생성)**를 선택합니다.
1. **보고서 그룹 이름**은 보고서 그룹의 이름을 입력합니다.
1. (선택 사항) **태그**에 지원 AWS 서비스에서 사용할 태그의 이름과 값을 입력합니다. [**Add row**]를 사용하여 태그를 추가합니다. 최대 50개의 태그를 추가할 수 있습니다.
1. 테스트 보고서 결과의 원시 데이터를 Amazon S3 버킷에 업로드하려면
1. **Amazon S3로 내보내기**를 선택합니다.
1. **S3 버킷 이름**은 S3 버킷의 이름을 입력합니다.
1. (선택 사항) **S3 버킷 소유자**의 경우 S3 버킷을 소유한 계정의 AWS 계정 식별자를 입력합니다. 이 속성을 사용하여 빌드를 실행하는 계정이 아닌 다른 계정이 소유한 Amazon S3 버킷으로 보고서 데이터를 내보낼 수 있습니다.
1. **경로 접두사**는 테스트 결과를 업로드할 S3 버킷의 경로를 입력합니다.
1. 원시 테스트 결과 데이터 파일을 압축하려면 **Compress test result data in a zip file(테스트 결과 데이터를 zip 파일로 압축)**을 선택합니다.
1. **추가 구성을** 확장하여 암호화 옵션을 표시합니다. 다음 중 하나를 선택합니다.
+ Amazon S3용를 사용하기 AWS 관리형 키 위한 **기본 AWS 관리형 키**입니다. 자세한 내용은AWS Key Management Service 사용 설명서의 [고객 관리형 CMK](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk)를 참조하세요.** 이것은 기본 암호화 옵션입니다.
+ 생성하여 구성하는 고객 관리형 키를 사용할 **사용자 지정 키를 선택**합니다. **AWS KMS 암호화 키**는 암호화 키의 ARN을 입력합니다. 형식은 ` arn:aws:kms:: :key/ `입니다. 자세한 내용을 알아보려면AWS Key Management Service 사용 설명서의 [KMS 키 생성](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html)을 참조하세요.**
+ **아티팩트 암호화를 비활성화하여** 암호화를 비활성화합니다. 테스트 결과를 공유하거나 정적 웹사이트에 게시할 경우에 이를 선택할 수 있습니다. (동적 웹사이트에서 테스트 결과를 해독하는 코드를 실행할 수 있습니다.)
유휴 데이터 암호화에 대한 자세한 내용은 [데이터 암호화](security-encryption.md) 단원을 참조하십시오.
**참고**
프로젝트에 지정된 CodeBuild 서비스 역할은 S3 버킷에 업로드하는 권한에 사용됩니다.
1. **Create report(보고서 그룹 생성)**를 선택합니다.
## 보고서 그룹 생성(CLI)
다음 절차에서는 AWS CLI을 사용하여 보고서 그룹을 생성합니다.
**보고서 그룹을 생성하려면**
1. `CreateReportGroup.json`이라는 이름의 파일을 만듭니다.
1. 요구 사항에 따라 다음 JSON 코드 조각 중 하나를 `CreateReportGroup.json`에 복사합니다.
+ 다음 JSON을 사용하여 테스트 보고서 그룹이 원시 테스트 결과 파일을 Amazon S3 버킷으로 내보내도록 지정합니다.
```
{
"name": "",
"type": "TEST",
"exportConfig": {
"exportConfigType": "S3",
"s3Destination": {
"bucket": "",
"bucketOwner": "",
"path": "",
"packaging": "NONE | ZIP",
"encryptionDisabled": "false",
"encryptionKey": ""
},
"tags": [
{
"key": "tag-key",
"value": "tag-value"
}
]
}
}
```
+ **은 Amazon S3 버킷 이름으로 바꾸고, **는 파일을 내보낼 버킷의 경로로 바꿉니다.
+ 내보낸 파일을 압축하려면 `packaging`을 `ZIP`로 지정합니다. 아닌 경우에는 `NONE`로 지정합니다.
+ `bucketOwner`는 선택 사항으로 빌드를 실행하는 계정이 아닌 다른 계정이 Amazon S3 버킷을 소유한 경우에만 필요합니다.
+ 내보낸 파일을 암호화할지 여부를 지정할 때 `encryptionDisabled`을 사용합니다. 내보낸 파일을 암호화할 경우에는 고객 관리형 키를 입력합니다. 자세한 내용은 [보고서 그룹 업데이트](report-group-export-settings.md) 단원을 참조하십시오.
+ 다음 JSON을 사용하여 테스트 보고서가 원시 테스트 파일을 내보내지 않도록 지정합니다.
```
{
"name": "",
"type": "TEST",
"exportConfig": {
"exportConfigType": "NO_EXPORT"
}
}
```
**참고**
프로젝트에 지정된 CodeBuild 서비스 역할은 S3 버킷에 업로드하는 권한에 사용됩니다.
1. 다음 명령을 실행합니다.
```
aws codebuild create-report-group --cli-input-json file://CreateReportGroupInput.json
```
## 보고서 그룹 생성(CloudFormation)
다음 지침에 따라 CloudFormation 템플릿을 사용하여 보고서 그룹을 생성합니다.
** CloudFormation 템플릿을 사용하여 보고서 그룹을 생성하려면**
CloudFormation 템플릿 파일을 사용하여 보고서 그룹을 생성하고 프로비저닝할 수 있습니다. 자세한 내용은 [CloudFormation 사용자 안내서](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)를 참조하세요.
다음 CloudFormation YAML 템플릿은 원시 테스트 결과 파일을 내보내지 않는 보고서 그룹을 생성합니다.
```
Resources:
CodeBuildReportGroup:
Type: AWS::CodeBuild::ReportGroup
Properties:
Name: my-report-group-name
Type: TEST
ExportConfig:
ExportConfigType: NO_EXPORT
```
다음 CloudFormation YAML 템플릿은 원시 테스트 결과 파일을 Amazon S3 버킷으로 내보내는 보고서 그룹을 생성합니다.
```
Resources:
CodeBuildReportGroup:
Type: AWS::CodeBuild::ReportGroup
Properties:
Name: my-report-group-name
Type: TEST
ExportConfig:
ExportConfigType: S3
S3Destination:
Bucket: amzn-s3-demo-bucket
Path: path-to-folder-for-exported-files
Packaging: ZIP
EncryptionKey: my-KMS-encryption-key
EncryptionDisabled: false
```
**참고**
프로젝트에 지정된 CodeBuild 서비스 역할은 S3 버킷에 업로드하는 권한에 사용됩니다.