보고서 그룹 만들기 - AWS CodeBuild

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

보고서 그룹 만들기

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

보고서 그룹 생성(buildspec)

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

buildspec 파일을 사용하여 보고서 그룹을 생성하려면
  1. AWS 계정의 보고서 그룹과 연결되지 않은 보고서 그룹 이름을 선택합니다.

  2. 이 이름으로 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 단원을 참조하세요.

  3. commands 섹션에서, 테스트를 실행할 명령을 지정합니다. 자세한 내용은 테스트 명령 지정 단원을 참조하십시오.

  4. 빌드를 실행합니다. 빌드가 완료되면 project-name-report-group-name 형식을 사용하는 이름으로 새 보고서 그룹이 만들어집니다. 자세한 내용은 보고서 그룹 이름 지정 단원을 참조하십시오.

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

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

보고서 그룹을 생성하려면
  1. https://console.aws.amazon.com/codesuite/codebuild/home 에서 AWS CodeBuild 콘솔을 엽니다.

  2. 탐색 창에서 Report groups(보고서 그룹)을 선택합니다.

  3. Create report(보고서 그룹 생성)를 선택합니다.

  4. 보고서 그룹 이름은 보고서 그룹의 이름을 입력합니다.

  5. (선택 사항) 태그 에 지원 AWS 서비스가 사용할 태그의 이름과 값을 입력합니다. [Add row]를 사용하여 태그를 추가합니다. 최대 50개의 태그를 추가할 수 있습니다.

  6. 테스트 보고서 결과의 원시 데이터를 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 관리형 키입니다. 자세한 내용은 사용 설명서의 고객 관리CMKs형을 참조하세요. AWS Key Management Service 이것은 기본 암호화 옵션입니다.

      • 생성하여 구성하는 고객 관리형 키를 사용할 사용자 지정 키를 선택합니다. AWS KMS 암호화 키 에 암호화 키ARN의 를 입력합니다. 형식은 arn:aws:kms:<region-id>: <aws-account-id>:key/<key-id> 입니다. 자세한 내용은 AWS Key Management Service 사용 설명서 KMS 키 생성을 참조하세요.

      • 아티팩트 암호화를 비활성화하여 암호화를 비활성화합니다. 테스트 결과를 공유하거나 정적 웹사이트에 게시할 경우에 이를 선택할 수 있습니다. (동적 웹사이트에서 테스트 결과를 해독하는 코드를 실행할 수 있습니다.)

      유휴 데이터 암호화에 대한 자세한 내용은 데이터 암호화 단원을 참조하십시오.

    참고

    프로젝트에 지정된 CodeBuild 서비스 역할은 S3 버킷에 업로드할 수 있는 권한에 사용됩니다.

  7. Create report(보고서 그룹 생성)를 선택합니다.

보고서 그룹 생성(CLI)

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

보고서 그룹을 생성하려면
  1. CreateReportGroup.json이라는 이름의 파일을 만듭니다.

  2. 요구 사항에 따라 다음 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> 파일을 내보내려는 버킷의 경로.

      • 내보낸 파일을 압축하려면 packagingZIP로 지정합니다. 아닌 경우에는 NONE로 지정합니다.

      • bucketOwner는 선택 사항으로 빌드를 실행하는 계정이 아닌 다른 계정이 Amazon S3 버킷을 소유한 경우에만 필요합니다.

      • 내보낸 파일을 암호화할지 여부를 지정할 때 encryptionDisabled을 사용합니다. 내보낸 파일을 암호화할 경우에는 고객 관리형 키를 입력합니다. 자세한 내용은 보고서 그룹 업데이트 단원을 참조하십시오.

    • 다음을 사용하여 테스트 보고서가 원시 테스트 파일을 내보내지 않도록 JSON 지정합니다.

      { "name": "<report-name>", "type": "TEST", "exportConfig": { "exportConfigType": "NO_EXPORT" } }
    참고

    프로젝트에 지정된 CodeBuild 서비스 역할은 S3 버킷에 업로드할 수 있는 권한에 사용됩니다.

  3. 다음 명령 실행:

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