보고서 그룹 생성(buildspec)보고서 그룹 만들기(콘솔)보고서 그룹 생성(CLI)보고서 그룹 생성(AWS CloudFormation)

보고서 그룹 만들기

CodeBuild 콘솔, AWS CLI또는 buildspec 파일을 사용하여 보고서 그룹을 생성할 수 있습니다. IAM 역할에는 보고서 그룹을 생성하는 데 필요한 권한이 있어야 합니다. 자세한 내용은 테스트 보고서 권한 단원을 참조하십시오.

주제

보고서 그룹 생성(buildspec)
보고서 그룹 만들기(콘솔)
보고서 그룹 생성(CLI)
보고서 그룹 생성(AWS CloudFormation)

보고서 그룹 생성(buildspec)

buildspec을 사용하여 만든 보고서 그룹은 원시 테스트 결과 파일을 내보내지 않습니다. 보고서 그룹을 보고 내보내기 설정을 지정할 수 있습니다. 자세한 내용은 보고서 그룹 업데이트 단원을 참조하십시오.

buildspec 파일을 사용하여 보고서 그룹을 생성하려면

AWS 계정의 보고서 그룹과 연결되지 않은 보고서 그룹 이름을 선택합니다.
이 이름으로 buildspec 파일의 reports 섹션을 구성합니다. 이 예제에서 보고서 그룹 이름은 new-report-group 이고 사용 테스트 사례는 JUnit 프레임워크로 생성됩니다.
```
reports:
 new-report-group: #surefire junit reports
   files:
     - '**/*'
   base-directory: 'surefire/target/surefire-reports'
```
빌드 사양의 환경 변수를 사용하여 보고서 그룹 이름을 지정할 수도 있습니다.
```
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'
```
자세한 내용은 테스트 파일 지정 및 Reports syntax in the buildspec file 단원을 참조하세요.
commands 섹션에서, 테스트를 실행할 명령을 지정합니다. 자세한 내용은 테스트 명령 지정 단원을 참조하십시오.
빌드를 실행합니다. 빌드가 완료되면 project-name-report-group-name 형식을 사용하는 이름으로 새 보고서 그룹이 만들어집니다. 자세한 내용은 보고서 그룹 이름 지정 단원을 참조하십시오.

보고서 그룹 만들기(콘솔)

다음 절차에 따라 를 사용하여 보고서 그룹을 생성합니다 AWS Management Console.

보고서 그룹을 생성하려면

https://console.aws.amazon.com/codesuite/codebuild/home 에서 AWS CodeBuild 콘솔을 엽니다.
탐색 창에서 Report groups(보고서 그룹)을 선택합니다.
Create report(보고서 그룹 생성)를 선택합니다.
보고서 그룹 이름은 보고서 그룹의 이름을 입력합니다.
(선택 사항) 태그 에 지원 AWS 서비스가 사용할 태그의 이름과 값을 입력합니다. [Add row]를 사용하여 태그를 추가합니다. 최대 50개의 태그를 추가할 수 있습니다.
테스트 보고서 결과의 원시 데이터를 Amazon S3 버킷에 업로드하려면
1. Amazon S3로 내보내기를 선택합니다.
2. S3 버킷 이름은 S3 버킷의 이름을 입력합니다.
3. (선택 사항) S3 버킷 소유자의 경우 S3 버킷을 소유한 계정의 AWS 계정 식별자를 입력합니다. 이 속성을 사용하여 빌드를 실행하는 계정이 아닌 다른 계정이 소유한 Amazon S3 버킷으로 보고서 데이터를 내보낼 수 있습니다.
4. 경로 접두사는 테스트 결과를 업로드할 S3 버킷의 경로를 입력합니다.
5. 원시 테스트 결과 데이터 파일을 압축하려면 Compress test result data in a zip file(테스트 결과 데이터를 zip 파일로 압축)을 선택합니다.
6. 추가 구성을 확장하여 암호화 옵션을 표시합니다. 다음 중 하나를 선택합니다.
  - Amazon S3용 를 사용하기 AWS 관리형 키 위한 기본 AWS 관리형 키입니다. 자세한 내용은 AWS Key Management Service 사용 설명서의 고객 관리CMKs형을 참조하세요. 이것은 기본 암호화 옵션입니다.
  - 생성하여 구성하는 고객 관리형 키를 사용할 사용자 지정 키를 선택합니다. AWS KMS 암호화 키 에 암호화 키ARN의 를 입력합니다. 형식은 arn:aws:kms:<region-id>: <aws-account-id>:key/<key-id>입니다. 자세한 내용은 AWS Key Management Service 사용 설명서의 KMS 키 생성을 참조하세요.
  - 아티팩트 암호화를 비활성화하여 암호화를 비활성화합니다. 테스트 결과를 공유하거나 정적 웹사이트에 게시할 경우에 이를 선택할 수 있습니다. (동적 웹사이트에서 테스트 결과를 해독하는 코드를 실행할 수 있습니다.)
  유휴 데이터 암호화에 대한 자세한 내용은 데이터 암호화 단원을 참조하십시오.
참고
프로젝트에 지정된 CodeBuild 서비스 역할은 S3 버킷에 업로드할 수 있는 권한에 사용됩니다.
Create report(보고서 그룹 생성)를 선택합니다.

보고서 그룹 생성(CLI)

다음 절차에 따라 를 사용하여 보고서 그룹을 생성합니다 AWS CLI.

보고서 그룹을 생성하려면

CreateReportGroup.json이라는 이름의 파일을 만듭니다.
요구 사항에 따라 다음 JSON 코드 조각 중 하나를 에 복사합니다CreateReportGroup.json.
- 다음을 사용하여 테스트 보고서 그룹이 원시 테스트 결과 파일을 Amazon S3 버킷으로 내보내도록 JSON 지정합니다.
```
{
  "name": "<report-name>",
  "type": "TEST",
  "exportConfig": {
    "exportConfigType": "S3",
    "s3Destination": {
      "bucket": "<bucket-name>",
      "bucketOwner": "<bucket-owner>",
      "path": "<path>",
      "packaging": "NONE | ZIP",
      "encryptionDisabled": "false",
      "encryptionKey": "<your-key>"
    },
    "tags": [
      {
        "key": "tag-key",
        "value": "tag-value"
      }
    ]
  }
}
```
  - Replace <bucket-name> Amazon S3 버킷 이름과 <path> 파일을 내보내려는 버킷의 경로.
  - 내보낸 파일을 압축하려면 packaging을 ZIP로 지정합니다. 아닌 경우에는 NONE로 지정합니다.
  - bucketOwner는 선택 사항으로 빌드를 실행하는 계정이 아닌 다른 계정이 Amazon S3 버킷을 소유한 경우에만 필요합니다.
  - 내보낸 파일을 암호화할지 여부를 지정할 때 encryptionDisabled을 사용합니다. 내보낸 파일을 암호화할 경우에는 고객 관리형 키를 입력합니다. 자세한 내용은 보고서 그룹 업데이트 단원을 참조하십시오.
- 다음을 사용하여 테스트 보고서가 원시 테스트 파일을 내보내지 않도록 JSON 지정합니다.
```
{
  "name": "<report-name>",
  "type": "TEST",
  "exportConfig": {
    "exportConfigType": "NO_EXPORT"
  }
}
```
참고
프로젝트에 지정된 CodeBuild 서비스 역할은 S3 버킷에 업로드할 수 있는 권한에 사용됩니다.

다음 명령 실행:


aws codebuild create-report-group --cli-input-json file://CreateReportGroupInput.json

보고서 그룹 생성(AWS CloudFormation)

다음 지침에 따라 템플릿을 사용하여 보고서 그룹을 생성합니다. AWS CloudFormation

템플릿을 사용하여 AWS CloudFormation 보고서 그룹을 생성하려면

AWS CloudFormation 템플릿 파일을 사용하여 보고서 그룹을 생성하고 프로비저닝할 수 있습니다. 자세한 내용은 AWS CloudFormation 사용 설명서를 참조하십시오.

다음 AWS CloudFormation YAML 템플릿은 원시 테스트 결과 파일을 내보내지 않는 보고서 그룹을 생성합니다.


Resources:
  CodeBuildReportGroup:
    Type: AWS::CodeBuild::ReportGroup
    Properties:
      Name: my-report-group-name
      Type: TEST
      ExportConfig:
        ExportConfigType: NO_EXPORT

다음 AWS 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 버킷에 업로드할 수 있는 권한에 사용됩니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

보고서 그룹

보고서 그룹 이름 지정