기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 보고서 그룹 공유
보고서 그룹 공유를 사용하면 여러 AWS 계정 또는 사용자가 보고서 그룹, 만료되지 않은 보고서 및 보고서의 테스트 결과를 볼 수 있습니다. 이 모델에서는 보고서 그룹을 소유하는 계정(소유자)은 다른 계정(소비자)과 보고서 그룹을 공유합니다. 소비자는 보고서 그룹을 편집할 수 없습니다. 보고서는 생성되고 30일 후에 만료됩니다.
**Topics**
+ [보고서 그룹 공유](#report-groups-sharing-share)
+ [관련 서비스](#report-groups-sharing-related)
+ [사용자와 공유된 보고서 그룹에 액세스](report-groups-sharing-access-prereqs.md)
+ [공유 보고서 그룹 공유 해제](report-groups-sharing-unshare.md)
+ [공유 보고서 그룹 식별](report-groups-sharing-identify.md)
+ [공유 보고서 그룹 권한](report-groups-sharing-perms.md)
## 보고서 그룹 공유
보고서 그룹을 공유하면 소비자에게 보고서 그룹 및 해당 보고서에 대한 읽기 전용 액세스 권한이 부여됩니다. 소비자는 AWS CLI 를 사용하여 각 보고서의 보고서 그룹, 보고서 및 테스트 사례 결과를 볼 수 있습니다. 소비자는 다음을 수행할 수 없습니다.
+ CodeBuild 콘솔에서 공유 보고서 그룹 또는 해당 보고서 보기.
+ 공유 보고서 그룹 편집하기.
+ 프로젝트에서 공유 보고서 그룹의 ARN을 사용하여 보고서 실행하기. 공유 보고서 그룹을 지정하는 프로젝트 빌드가 실패합니다.
CodeBuild 콘솔을 사용하여 기존 리소스 공유에 보고서 그룹을 추가할 수 있습니다. 보고서 그룹을 새 리소스 공유에 추가하려면 먼저 [AWS RAM 콘솔](https://console.aws.amazon.com/ram)에서 보고서 그룹을 만들어야 합니다.
보고서 그룹을 조직 단위 또는 전체 조직과 공유하려면 AWS Organizations와의 공유를 활성화해야 합니다. 자세한 내용은 *AWS RAM 사용 설명서*에서 [AWS Organizations를 사용하여 공유 사용](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html)을 참조하세요.
CodeBuild 콘솔, AWS RAM 콘솔 또는를 사용하여 소유한 보고서 그룹을 AWS CLI 공유할 수 있습니다.
**사전 조건**
보고서 그룹을 공유하려면 AWS 계정이 보고서 그룹을 소유해야 합니다. 사용자와 공유된 보고서 그룹은 공유할 수 없습니다.
**소유한 보고서 그룹을 공유하려면(CodeBuild 콘솔)**
1. [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) AWS CodeBuild 콘솔을 엽니다.
1. 탐색 창에서 **Report groups(보고서 그룹)**을 선택합니다.
1. 공유할 프로젝트를 선택한 다음 **공유**를 선택합니다. 자세한 내용은AWS RAM 사용 설명서의 [리소스 공유 생성](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create)을 참조하세요.**
**소유한 보고서 그룹을 공유하려면(AWS RAM 콘솔)**
AWS RAM 사용 설명서에서 [리소스 공유 생성](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create)을 참조하세요.**
**소유한 보고서 그룹을 공유하려면(AWS RAM 명령)**
[create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) 명령을 사용합니다.
**소유한 보고서 그룹을 공유하려면(CodeBuild 명령)**
[put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html) 명령을 사용합니다.
1. 이름이 `policy.json`인 파일을 만들고 다음으로 복사합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[{
"Effect":"Allow",
"Principal":{
"AWS":"111122223333"
},
"Action":[
"codebuild:BatchGetReportGroups",
"codebuild:BatchGetReports",
"codebuild:ListReportsForReportGroup",
"codebuild:DescribeTestCases"],
"Resource":"arn:aws:iam::*:role/Service*"
}]
}
```
------
1. 보고서 그룹 ARN 및 식별자로 `policy.json`을 업데이트하여 공유합니다. 다음 예제에서는 ARN이 있는 보고서 그룹에 대한 읽기 전용 액세스 권한을 `arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group` Alice와 123456789012로 식별되는 AWS 계정의 루트 사용자에게 부여합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[{
"Effect":"Allow",
"Principal":{
"AWS": [
"arn:aws:iam::123456789012:user/Alice",
"123456789012"
]
},
"Action":[
"codebuild:BatchGetReportGroups",
"codebuild:BatchGetReports",
"codebuild:ListReportsForReportGroup",
"codebuild:DescribeTestCases"],
"Resource":"arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group"
}]
}
```
------
1. 다음 명령을 실행합니다.
```
aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json
```
## 관련 서비스
보고서 그룹 공유는 모든 AWS 계정 또는를 통해 AWS 리소스를 공유할 수 있는 서비스AWS RAM인 AWS Resource Access Manager ()와 통합됩니다 AWS Organizations. 를 사용하면 AWS RAM공유할 리소스와 소비자를 지정하는 *리소스 공유*를 생성하여 소유한 리소스를 공유할 수 있습니다. 소비자는 개별 AWS 계정,의 조직 단위 AWS Organizations또는의 전체 조직일 수 있습니다 AWS Organizations.
자세한 내용은 *[AWS RAM 사용 설명서](https://docs.aws.amazon.com/ram/latest/userguide/)*를 참조하십시오.
# 사용자와 공유된 보고서 그룹에 액세스
공유 보고서 그룹에 액세스하려면 소비자의 IAM 역할에 `BatchGetReportGroups` 권한이 필요합니다. 다음 정책을 해당 IAM 역할에 연결할 수 있습니다.
```
{
"Effect": "Allow",
"Resource": [
"*"
],
"Action": [
"codebuild:BatchGetReportGroups"
]
}
```
자세한 내용은 [에 대한 자격 증명 기반 정책 사용 AWS CodeBuild](auth-and-access-control-iam-identity-based-access-control.md) 단원을 참조하십시오.
# 공유 보고서 그룹 공유 해제
보고서 및 테스트 케이스 결과를 포함해 공유되지 않은 보고서 그룹은 소유자만 액세스할 수 있습니다. 보고서 그룹을 공유 해제하면 이전에 공유한 AWS 계정 또는 사용자가 보고서 그룹, 보고서 또는 보고서의 테스트 사례 결과에 액세스할 수 없습니다.
소유하고 있는 공유된 보고서 그룹의 공유를 해제하려면 리소스 공유에서 제거해야 합니다. AWS RAM 콘솔 또는를 사용하여이 작업을 수행할 수 AWS CLI 있습니다.
**소유한 공유 보고서 그룹을 공유 해제하려면(AWS RAM 콘솔)**
*AWS RAM 사용 설명서*에서 [리소스 공유 업데이트](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update)를 참조하세요.
**소유한 공유 보고서 그룹을 공유 해제하려면(AWS RAM 명령)**
[disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html) 명령을 사용합니다.
**소유한 보고서 그룹 공유를 해제하려면(CodeBuild 명령)**
[delete-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/delete-resource-policy.html) 명령을 실행하고 공유를 해제할 보고서 그룹의 ARN을 지정합니다.
```
aws codebuild delete-resource-policy --resource-arn report-group-arn
```
# 공유 보고서 그룹 식별
소유자와 소비자는 AWS CLI 를 사용하여 공유 보고서 그룹을 식별할 수 있습니다.
공유 보고서 그룹 및 해당 보고서에 대한 정보를 식별하고 가져오려면 다음 명령을 사용합니다.
+ 공유된 보고서 그룹의 ARN을 보려면 `[list-shared-report-groups](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-shared-report-groups.html)`을 실행합니다.
```
aws codebuild list-shared-report-groups
```
+ 보고서 그룹에서 보고서의 ARN을 보려면 보고서 그룹 ARN을 사용하여 `[list-reports-for-report-group](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-reports-for-report-group.html)`을 실행합니다.
```
aws codebuild list-reports-for-report-group --report-group-arn report-group-arn
```
+ 보고서의 테스트 케이스에 대한 정보를 보려면 보고서 ARN을 사용하여 `[describe-test-cases](https://docs.aws.amazon.com/cli/latest/reference/codebuild/describe-test-cases.html)`을 실행합니다.
```
aws codebuild describe-test-cases --report-arn report-arn
```
출력은 다음과 같습니다.
```
{
"testCases": [
{
"status": "FAILED",
"name": "Test case 1",
"expired": 1575916770.0,
"reportArn": "report-arn",
"prefix": "Cucumber tests for agent",
"message": "A test message",
"durationInNanoSeconds": 1540540,
"testRawDataPath": "path-to-output-report-files"
},
{
"status": "SUCCEEDED",
"name": "Test case 2",
"expired": 1575916770.0,
"reportArn": "report-arn",
"prefix": "Cucumber tests for agent",
"message": "A test message",
"durationInNanoSeconds": 1540540,
"testRawDataPath": "path-to-output-report-files"
}
]
}
```
# 공유 보고서 그룹 권한
## 소유자에 대한 권한
보고서 그룹 소유자는 보고서 그룹을 편집하고 프로젝트에서 보고서를 실행할 수 있도록 지정할 수 있습니다.
## 소비자에 대한 권한
보고서 그룹 소비자는 보고서 그룹, 보고서 및 보고서에 대한 테스트 케이스 결과를 볼 수 있습니다. 소비자는 보고서 그룹이나 해당 보고서를 편집할 수 없으며 이를 사용하여 보고서를 만들 수 없습니다.