Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Melaporkan kelompok
*Grup laporan* berisi laporan pengujian dan menentukan setelan bersama. Anda menggunakan file buildspec untuk menentukan kasus uji yang akan dijalankan dan perintah untuk menjalankannya saat dibangun. Untuk setiap grup laporan yang dikonfigurasi dalam proyek build, menjalankan proyek build akan membuat laporan pengujian. Beberapa proses proyek build yang dikonfigurasi dengan grup laporan membuat beberapa laporan pengujian dalam grup laporan tersebut, masing-masing dengan hasil kasus pengujian yang sama yang ditentukan untuk grup laporan tersebut.
Kasus uji ditentukan untuk grup laporan dalam file buildspec proyek build. Anda dapat menentukan hingga lima grup laporan dalam satu proyek build. Saat Anda menjalankan build, semua kasus uji berjalan. Laporan pengujian baru dibuat dengan hasil dari setiap kasus uji yang ditentukan untuk grup laporan. Setiap kali Anda menjalankan build baru, kasus pengujian berjalan dan laporan pengujian baru dibuat dengan hasil pengujian baru.
Grup laporan dapat digunakan di lebih dari satu proyek build. Semua laporan pengujian yang dibuat dengan satu grup laporan memiliki konfigurasi yang sama, seperti opsi ekspor dan izinnya, meskipun laporan pengujian dibuat menggunakan proyek build yang berbeda. Laporan pengujian yang dibuat dengan satu grup laporan di beberapa proyek build dapat berisi hasil dari menjalankan kumpulan kasus pengujian yang berbeda (satu set kasus uji untuk setiap proyek build). Ini karena Anda dapat menentukan file kasus uji yang berbeda untuk grup laporan di setiap file buildspec proyek. Anda juga dapat mengubah file kasus uji untuk grup laporan dalam proyek build dengan mengedit file buildspec. Proses build berikutnya membuat laporan pengujian baru yang berisi hasil file kasus uji di buildspec yang diperbarui.
**Topics**
+ [Membuat grup laporan](report-group-create.md)
+ [Laporkan penamaan grup](test-report-group-naming.md)
+ [Bagikan grup laporan](report-groups-sharing.md)
+ [Tentukan file uji](report-group-test-cases.md)
+ [Tentukan perintah uji](report-group-test-case-commands.md)
+ [Menandai grup laporan di AWS CodeBuild](how-to-tag-report-group.md)
+ [Memperbarui grup laporan](report-group-export-settings.md)
# Membuat grup laporan
Anda dapat menggunakan CodeBuild konsol, file AWS CLI, atau buildspec untuk membuat grup laporan. Peran IAM Anda harus memiliki izin yang diperlukan untuk membuat grup laporan. Untuk informasi selengkapnya, lihat [Izin laporan uji](test-permissions.md).
**Topics**
+ [Membuat grup laporan (buildspec)](#test-report-group-create-buildspec)
+ [Membuat grup laporan (konsol)](#test-report-group-create-console)
+ [Buat grup laporan (CLI)](#test-report-group-create-cli)
+ [Membuat grup laporan (CloudFormation)](#test-report-group-create-cfn)
## Membuat grup laporan (buildspec)
Grup laporan yang dibuat menggunakan buildspec tidak mengekspor file hasil pengujian mentah. Anda dapat melihat grup laporan dan menentukan setelan ekspor. Untuk informasi selengkapnya, lihat [Memperbarui grup laporan](report-group-export-settings.md).
**Untuk membuat grup laporan menggunakan file buildspec**
1. Pilih nama grup laporan yang tidak terkait dengan grup laporan di AWS akun Anda.
1. Konfigurasikan `reports` bagian file buildspec dengan nama ini. Dalam contoh ini, nama grup laporan adalah `new-report-group` dan kasus uji penggunaan dibuat dengan JUnit kerangka kerja:
```
reports:
new-report-group: #surefire junit reports
files:
- '**/*'
base-directory: 'surefire/target/surefire-reports'
```
Nama grup laporan juga dapat ditentukan dengan menggunakan variabel lingkungan dalam 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'
```
Untuk informasi selengkapnya, lihat [Tentukan file uji](report-group-test-cases.md) dan [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file).
1. Di `commands` bagian ini, tentukan perintah untuk menjalankan pengujian Anda. Untuk informasi selengkapnya, lihat [Tentukan perintah uji](report-group-test-case-commands.md).
1. Jalankan build. Ketika build selesai, grup laporan baru akan dibuat dengan nama yang menggunakan format`project-name-report-group-name`. Untuk informasi selengkapnya, lihat [Laporkan penamaan grup](test-report-group-naming.md).
## Membuat grup laporan (konsol)
Gunakan prosedur berikut untuk membuat grup laporan menggunakan Konsol Manajemen AWS.
**Untuk membuat grup laporan**
1. Buka AWS CodeBuild konsol di [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Di panel navigasi, pilih **Laporkan grup**.
1. Pilih **Buat grup laporan**.
1. Untuk **nama grup Laporkan**, masukkan nama untuk grup laporan Anda.
1. (Opsional) Untuk **Tag**, masukkan nama dan nilai tag apa pun yang Anda inginkan untuk digunakan oleh AWS layanan pendukung. Gunakan **Tambah baris** untuk menambahkan tag. Anda dapat menambahkan hingga 50 tanda.
1. Jika Anda ingin mengunggah data mentah hasil laporan pengujian ke bucket Amazon S3:
1. Pilih **Ekspor ke Amazon S3**.
1. Untuk **nama bucket S3**, masukkan nama bucket S3.
1. (Opsional) Untuk **pemilik bucket S3**, masukkan pengenal AWS akun akun yang memiliki bucket S3. Ini memungkinkan data laporan untuk diekspor ke bucket Amazon S3 yang dimiliki oleh akun selain akun yang menjalankan build.
1. Untuk **awalan Path**, masukkan path di bucket S3 tempat Anda ingin mengunggah hasil pengujian.
1. Pilih **Kompres data hasil pengujian dalam file zip** untuk mengompres file data hasil pengujian mentah Anda.
1. Perluas **Konfigurasi tambahan** untuk menampilkan opsi enkripsi. Pilih salah satu cara berikut:
+ **Kunci AWS terkelola default** untuk menggunakan Kunci yang dikelola AWS untuk Amazon S3. Untuk informasi selengkapnya, lihat [Pelanggan yang dikelola CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) di *Panduan AWS Key Management Service Pengguna*. Ini adalah opsi enkripsi default.
+ **Pilih kunci kustom untuk menggunakan kunci terkelola** pelanggan yang Anda buat dan konfigurasikan. Untuk **kunci AWS KMS enkripsi**, masukkan ARN kunci enkripsi Anda. Formatnya adalah ` arn:aws:kms:: :key/ `. Untuk informasi selengkapnya, lihat [Membuat kunci KMS](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) di *Panduan AWS Key Management Service Pengguna*.
+ **Nonaktifkan enkripsi artefak** untuk menonaktifkan enkripsi. Anda dapat memilih ini jika Anda ingin membagikan hasil tes Anda, atau mempublikasikannya ke situs web statis. (Situs web dinamis dapat menjalankan kode untuk mendekripsi hasil pengujian.)
Untuk informasi selengkapnya tentang enkripsi data saat istirahat, lihat[Enkripsi data](security-encryption.md).
**catatan**
Peran CodeBuild layanan yang ditentukan dalam proyek digunakan untuk izin untuk mengunggah ke bucket S3.
1. Pilih **Buat grup laporan**.
## Buat grup laporan (CLI)
Gunakan prosedur berikut untuk membuat grup laporan menggunakan AWS CLI.
**Untuk membuat grup laporan**
1. Buat file bernama `CreateReportGroup.json`.
1. Bergantung pada kebutuhan Anda, salin salah satu cuplikan kode JSON berikut ke: `CreateReportGroup.json`
+ Gunakan JSON berikut untuk menentukan bahwa grup laporan pengujian Anda mengekspor file hasil pengujian mentah ke bucket 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"
}
]
}
}
```
+ Ganti ** dengan nama bucket Amazon S3 Anda dan ** dengan jalur di bucket Anda ke tempat Anda ingin mengekspor file.
+ Jika Anda ingin mengompres file yang diekspor, untuk`packaging`, tentukan`ZIP`. Jika tidak, tentukan`NONE`.
+ `bucketOwner`bersifat opsional dan hanya diperlukan jika bucket Amazon S3 dimiliki oleh akun selain akun yang menjalankan build.
+ Gunakan `encryptionDisabled` untuk menentukan apakah akan mengenkripsi file yang diekspor. Jika Anda mengenkripsi file yang diekspor, masukkan kunci yang dikelola pelanggan Anda. Untuk informasi selengkapnya, lihat [Memperbarui grup laporan](report-group-export-settings.md).
+ Gunakan JSON berikut untuk menentukan bahwa laporan pengujian Anda tidak mengekspor file pengujian mentah:
```
{
"name": "",
"type": "TEST",
"exportConfig": {
"exportConfigType": "NO_EXPORT"
}
}
```
**catatan**
Peran CodeBuild layanan yang ditentukan dalam proyek digunakan untuk izin untuk mengunggah ke bucket S3.
1. Jalankan perintah berikut:
```
aws codebuild create-report-group --cli-input-json file://CreateReportGroupInput.json
```
## Membuat grup laporan (CloudFormation)
Gunakan petunjuk berikut untuk membuat grup laporan menggunakan CloudFormation templat
**Untuk membuat grup laporan menggunakan CloudFormation template**
Anda dapat menggunakan file CloudFormation templat untuk membuat dan menyediakan grup laporan. Untuk informasi selengkapnya, lihat [Panduan Pengguna CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
Template CloudFormation YAMM berikut membuat grup laporan yang tidak mengekspor file hasil pengujian mentah.
```
Resources:
CodeBuildReportGroup:
Type: AWS::CodeBuild::ReportGroup
Properties:
Name: my-report-group-name
Type: TEST
ExportConfig:
ExportConfigType: NO_EXPORT
```
Template CloudFormation YAMAL berikut membuat grup laporan yang mengekspor file hasil pengujian mentah ke bucket 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
```
**catatan**
Peran CodeBuild layanan yang ditentukan dalam proyek digunakan untuk izin untuk mengunggah ke bucket S3.
# Laporkan penamaan grup
Saat Anda menggunakan AWS CLI atau AWS CodeBuild konsol untuk membuat grup laporan, Anda menentukan nama untuk grup laporan. Jika Anda menggunakan buildspec untuk membuat grup laporan baru, itu dinamai menggunakan format. `project-name-report-group-name-specified-in-buildspec` Semua laporan yang dibuat dengan menjalankan build proyek build tersebut milik grup laporan baru yang memiliki nama baru.
Jika Anda tidak CodeBuild ingin membuat grup laporan baru, tentukan ARN grup laporan dalam file buildspec proyek build. Anda dapat menentukan ARN grup laporan di beberapa proyek build. Setelah setiap proyek build berjalan, grup laporan berisi laporan pengujian yang dibuat oleh setiap proyek build.
Misalnya, jika Anda membuat satu grup laporan dengan nama`my-report-group`, lalu menggunakan namanya dalam dua proyek build berbeda bernama `my-project-1` dan `my-project-2` dan membuat build dari kedua proyek, dua grup laporan baru akan dibuat. Hasilnya adalah tiga kelompok laporan dengan nama-nama berikut:
+ `my-report-group`: Tidak memiliki laporan pengujian.
+ `my-project-1-my-report-group`: Berisi laporan dengan hasil pengujian yang dijalankan oleh proyek build bernama`my-project-1`.
+ `my-project-2-my-report-group`: Berisi laporan dengan hasil pengujian yang dijalankan oleh proyek build bernama`my-project-2`.
Jika Anda menggunakan ARN dari grup laporan yang dinamai `my-report-group` di kedua proyek, dan kemudian menjalankan build dari setiap proyek, Anda masih memiliki satu grup laporan (). `my-report-group` Grup laporan tersebut berisi laporan pengujian dengan hasil pengujian yang dijalankan oleh kedua proyek build.
Jika Anda memilih nama grup laporan yang bukan milik grup laporan di AWS akun Anda, lalu menggunakan nama tersebut untuk grup laporan dalam file buildspec dan menjalankan build project build-nya, grup laporan baru akan dibuat. Format nama grup laporan baru adalah`project-name-new-group-name`. Misalnya, jika tidak ada grup laporan di AWS akun Anda dengan nama tersebut`new-report-group`, dan menentukannya dalam proyek build yang disebut`test-project`, build run akan membuat grup laporan baru dengan nama tersebut`test-project-new-report-group`.
# Bagikan grup laporan
Berbagi grup laporan memungkinkan beberapa AWS akun atau pengguna untuk melihat grup laporan, laporan yang belum kedaluwarsa, dan hasil pengujian laporannya. Dalam model ini, akun yang memiliki grup laporan (pemilik) berbagi grup laporan dengan akun lain (konsumen). Konsumen tidak dapat mengedit grup laporan. Laporan kedaluwarsa 30 hari setelah dibuat.
**Topics**
+ [Bagikan grup laporan](#report-groups-sharing-share)
+ [Layanan terkait](#report-groups-sharing-related)
+ [Akses grup laporan yang dibagikan dengan Anda](report-groups-sharing-access-prereqs.md)
+ [Membatalkan berbagi grup laporan bersama](report-groups-sharing-unshare.md)
+ [Identifikasi grup laporan bersama](report-groups-sharing-identify.md)
+ [Izin grup laporan bersama](report-groups-sharing-perms.md)
## Bagikan grup laporan
Saat Anda membagikan grup laporan, konsumen diberikan akses hanya-baca ke grup laporan dan laporannya. Konsumen dapat menggunakan AWS CLI untuk melihat grup laporan, laporannya, dan hasil kasus uji untuk setiap laporan. Konsumen tidak dapat:
+ Melihat grup laporan bersama atau laporannya di CodeBuild konsol.
+ Mengedit grup laporan bersama.
+ Gunakan ARN grup laporan bersama dalam proyek untuk menjalankan laporan. Pembuatan proyek yang menentukan grup laporan bersama gagal.
Anda dapat menggunakan CodeBuild konsol untuk menambahkan grup laporan ke pembagian sumber daya yang ada. Jika ingin menambahkan grup laporan ke pembagian sumber daya baru, Anda harus membuatnya terlebih dahulu di [AWS RAM konsol](https://console.aws.amazon.com/ram).
Untuk berbagi grup laporan dengan unit organisasi atau seluruh organisasi, Anda harus mengaktifkan berbagi dengan AWS Organizations. Untuk informasi lebih lanjut, lihat [ Aktifkan pembagian dengan AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) dalam *Panduan Pengguna AWS RAM *.
Anda dapat menggunakan CodeBuild konsol, AWS RAM konsol, atau AWS CLI untuk berbagi grup laporan yang Anda miliki.
**Prasyarat**
Untuk berbagi grup laporan, AWS akun Anda harus memilikinya. Anda tidak dapat membagikan grup laporan yang telah dibagikan dengan Anda.
**Untuk berbagi grup laporan yang Anda miliki (CodeBuild konsol)**
1. Buka AWS CodeBuild konsol di [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Di panel navigasi, pilih **Laporkan grup**.
1. Pilih proyek yang ingin Anda bagikan, lalu pilih **Bagikan**. Untuk informasi selengkapnya, lihat [Membuat berbagi sumber daya](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create) di *Panduan AWS RAM Pengguna*.
**Untuk berbagi grup laporan yang Anda miliki (AWS RAM konsol)**
Lihat [Membuat berbagi sumber daya](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) di *Panduan AWS RAM Pengguna*.
**Untuk berbagi grup laporan yang Anda miliki (AWS RAM perintah)**
Gunakan perintah [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).
**Untuk berbagi grup laporan yang Anda miliki (CodeBuild perintah)**
Gunakan [put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html)perintah:
1. Buat file bernama `policy.json` dan salin berikut ini ke dalamnya.
------
#### [ 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. Perbarui `policy.json` dengan grup laporan ARN dan pengidentifikasi untuk dibagikan. Contoh berikut memberikan akses read-only ke grup laporan dengan ARN ke Alice dan pengguna root `arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group` untuk akun yang diidentifikasi oleh 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. Jalankan perintah berikut.
```
aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json
```
## Layanan terkait
Berbagi grup laporan terintegrasi dengan AWS Resource Access Manager (AWS RAM), layanan yang memungkinkan Anda berbagi AWS sumber daya dengan AWS akun apa pun atau melalui AWS Organizations. Dengan AWS RAM, Anda berbagi sumber daya yang Anda miliki dengan membuat *pembagian sumber* daya yang menentukan sumber daya dan konsumen untuk dibagikan. Konsumen dapat berupa AWS akun individu, unit organisasi di AWS Organizations, atau seluruh organisasi di AWS Organizations.
Untuk informasi selengkapnya, silakan lihat *Panduan Pengguna [AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/)*.
# Akses grup laporan yang dibagikan dengan Anda
Untuk mengakses grup laporan bersama, peran IAM konsumen memerlukan `BatchGetReportGroups` izin. Anda dapat melampirkan kebijakan berikut ke peran IAM mereka:
```
{
"Effect": "Allow",
"Resource": [
"*"
],
"Action": [
"codebuild:BatchGetReportGroups"
]
}
```
Untuk informasi selengkapnya, lihat [Menggunakan kebijakan berbasis identitas untuk AWS CodeBuild](auth-and-access-control-iam-identity-based-access-control.md).
# Membatalkan berbagi grup laporan bersama
Grup laporan yang tidak dibagikan, termasuk laporan dan hasil uji kasusnya, hanya dapat diakses oleh pemiliknya. Jika Anda membatalkan pembagian grup laporan, AWS akun atau pengguna yang sebelumnya Anda bagikan tidak dapat mengakses grup laporan, laporannya, atau hasil kasus pengujian dalam laporan.
Untuk membatalkan berbagi grup laporan bersama yang Anda miliki, Anda harus menghapusnya dari pembagian sumber daya. Anda dapat menggunakan AWS RAM konsol atau AWS CLI untuk melakukan ini.
**Untuk membatalkan berbagi grup laporan bersama yang Anda miliki (AWS RAM konsol)**
Lihat [Memperbarui Pembagian Sumber Daya](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) di *Panduan Pengguna.AWS RAM *
**Untuk membatalkan berbagi grup laporan bersama yang Anda miliki (AWS RAM perintah)**
Gunakan perintah [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).
**Untuk membatalkan berbagi grup laporan yang Anda miliki CodeBuild perintah)**
Jalankan [delete-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/delete-resource-policy.html)perintah dan tentukan ARN dari grup laporan yang ingin Anda batalkan:
```
aws codebuild delete-resource-policy --resource-arn report-group-arn
```
# Identifikasi grup laporan bersama
Pemilik dan konsumen dapat menggunakan AWS CLI untuk mengidentifikasi grup laporan bersama.
Untuk mengidentifikasi dan mendapatkan informasi tentang grup laporan bersama dan laporannya, gunakan perintah berikut:
+ Untuk melihat grup laporan ARNs yang dibagikan dengan Anda, jalankan`[list-shared-report-groups](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-shared-report-groups.html)`:
```
aws codebuild list-shared-report-groups
```
+ Untuk melihat laporan dalam grup laporan, jalankan `[list-reports-for-report-group](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-reports-for-report-group.html)` menggunakan grup laporan ARN: ARNs
```
aws codebuild list-reports-for-report-group --report-group-arn report-group-arn
```
+ Untuk melihat informasi tentang kasus uji dalam laporan, jalankan `[describe-test-cases](https://docs.aws.amazon.com/cli/latest/reference/codebuild/describe-test-cases.html)` menggunakan laporan ARN:
```
aws codebuild describe-test-cases --report-arn report-arn
```
Outputnya terlihat seperti berikut:
```
{
"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"
}
]
}
```
# Izin grup laporan bersama
## Izin untuk pemilik
Pemilik grup laporan dapat mengedit grup laporan dan menentukannya dalam proyek untuk menjalankan laporan.
## Izin untuk konsumen
Konsumen grup laporan dapat melihat grup laporan, laporannya, dan hasil kasus uji untuk laporannya. Konsumen tidak dapat mengedit grup laporan atau laporannya, dan tidak dapat menggunakannya untuk membuat laporan.
# Tentukan file uji
Anda menentukan file hasil pengujian dan lokasinya untuk setiap grup laporan di `reports` bagian file buildspec project build Anda. Untuk informasi selengkapnya, lihat [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file).
Berikut ini adalah `reports` bagian contoh yang menentukan dua grup laporan untuk proyek build. Satu ditentukan dengan ARN-nya, yang lain dengan nama. `files`Bagian ini menentukan file yang berisi hasil kasus uji. `base-directory`Bagian opsional menentukan direktori tempat file kasus uji berada. `discard-paths`Bagian opsional menentukan apakah jalur untuk menguji file hasil yang diunggah ke bucket Amazon S3 dibuang.
```
reports:
arn:aws:codebuild:your-region:your-aws-account-id:report-group/report-group-name-1: #surefire junit reports
files:
- '**/*'
base-directory: 'surefire/target/surefire-reports'
discard-paths: false
sampleReportGroup: #Cucumber reports from json plugin
files:
- 'cucumber-json/target/cucumber-json-report.json'
file-format: CUCUMBERJSON #Type of the report, defaults to JUNITXML
```
# Tentukan perintah uji
Anda menentukan perintah yang menjalankan kasus pengujian di `commands` bagian file buildspec Anda. Perintah ini menjalankan kasus pengujian yang ditentukan untuk grup laporan Anda di `reports` bagian file buildspec Anda. Berikut ini adalah `commands` bagian contoh yang mencakup perintah untuk menjalankan tes dalam file pengujian:
```
commands:
- echo Running tests for surefire junit
- mvn test -f surefire/pom.xml -fn
- echo
- echo Running tests for cucumber with json plugin
- mvn test -Dcucumber.options="--plugin json:target/cucumber-json-report.json" -f cucumber-json/pom.xml -fn
```
Untuk informasi selengkapnya, lihat [Sintaks Buildspec](build-spec-ref.md#build-spec-ref-syntax).
# Menandai grup laporan di AWS CodeBuild
*Tag* adalah label atribut kustom yang Anda atau AWS tetapkan ke AWS sumber daya. Setiap AWS tag memiliki dua bagian:
+ *Kunci tag* (misalnya, `CostCenter`, `Environment`, `Project`, atau `Secret`). Kunci tanda peka terhadap huruf besar dan kecil.
+ Bidang opsional yang dikenal sebagai *nilai tag* (misalnya, `111122223333`, `Production`, atau nama tim). Mengabaikan nilai tag sama dengan menggunakan rangkaian kosong. Seperti kunci tanda, nilai tanda peka huruf besar dan kecil.
Bersama-sama ini dikenal sebagai pasangan nilai-kunci. Untuk batasan jumlah tag yang dapat Anda miliki di grup laporan dan batasan pada kunci dan nilai tag, lihat[Tag](limits.md#tag-limits).
Tag membantu Anda mengidentifikasi dan mengatur AWS sumber daya Anda. Banyak AWS layanan mendukung penandaan, sehingga Anda dapat menetapkan tag yang sama ke sumber daya dari layanan yang berbeda untuk menunjukkan bahwa sumber daya terkait. Misalnya, Anda dapat menetapkan tag yang sama ke grup CodeBuild laporan yang ditetapkan ke bucket Amazon S3. Untuk informasi lebih lanjut tentang penggunaan tanda, lihat laporan resmi [Praktik terbaik](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf).
Pada tahun CodeBuild, sumber daya utama adalah kelompok laporan dan proyek. Anda dapat menggunakan CodeBuild konsol,, AWS CLI CodeBuild APIs, atau AWS SDKs untuk menambah, mengelola, dan menghapus tag untuk grup laporan. Selain mengidentifikasi, mengatur, dan melacak grup laporan Anda dengan tag, Anda dapat menggunakan tag dalam kebijakan IAM untuk membantu mengontrol siapa yang dapat melihat dan berinteraksi dengan grup laporan Anda. Untuk contoh kebijakan akses berbasis tag, lihat [Menggunakan tag untuk mengontrol akses ke AWS CodeBuild sumber daya](auth-and-access-control-using-tags.md).
**Topics**
+ [Menambahkan tag ke grup laporan](how-to-tag-report-group-add.md)
+ [Melihat tag untuk grup laporan](how-to-tag-report-group-list.md)
+ [Mengedit tag untuk grup laporan](how-to-tag-report-group-update.md)
+ [Menghapus tag dari grup laporan](how-to-tag-report-group-delete.md)
# Menambahkan tag ke grup laporan
Menambahkan tag ke grup laporan dapat membantu Anda mengidentifikasi dan mengatur AWS sumber daya serta mengelola akses ke sana. Pertama, Anda menambahkan satu atau beberapa tag (pasangan nilai kunci) ke grup laporan. Perlu diingat bahwa ada batasan jumlah tag yang dapat Anda miliki di grup laporan. Ada pembatasan pada karakter yang dapat Anda gunakan di bidang kunci dan nilai. Untuk informasi selengkapnya, lihat [Tag](limits.md#tag-limits). Setelah Anda memiliki tag, Anda dapat membuat kebijakan IAM untuk mengelola akses ke grup laporan berdasarkan tag ini. Anda dapat menggunakan CodeBuild konsol atau AWS CLI untuk menambahkan tag ke grup laporan.
**penting**
Menambahkan tag ke grup laporan dapat memengaruhi akses ke grup laporan tersebut. Sebelum menambahkan tag ke grup laporan, pastikan untuk meninjau kebijakan IAM apa pun yang mungkin menggunakan tag untuk mengontrol akses ke sumber daya seperti grup laporan. Untuk contoh kebijakan akses berbasis tag, lihat [Menggunakan tag untuk mengontrol akses ke AWS CodeBuild sumber daya](auth-and-access-control-using-tags.md).
Untuk informasi selengkapnya tentang menambahkan tag ke grup laporan saat Anda membuatnya, lihat[Membuat grup laporan (konsol)](report-group-create.md#test-report-group-create-console).
**Topics**
+ [Menambahkan tag ke grup laporan (konsol)](#how-to-tag-report-group-add-console)
+ [Menambahkan tag ke grup laporan (AWS CLI)](#how-to-tag-report-group-add-cli)
## Menambahkan tag ke grup laporan (konsol)
Anda dapat menggunakan CodeBuild konsol untuk menambahkan satu atau beberapa tag ke grup CodeBuild laporan.
1. Buka CodeBuild konsol di [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Di **Grup laporan**, pilih nama grup laporan tempat Anda ingin menambahkan tag.
1. Pada panel navigasi, silakan pilih **Pengaturan**.
1. Jika tidak ada tag yang ditambahkan ke grup laporan, pilih **Tambah tag**. Anda juga dapat memilih **Edit**, lalu pilih **Tambah tag**.
1. Di **Kunci**, masukkan sebuah nama untuk tag tersebut. Anda dapat menambahkan nilai opsional untuk tag di **Nilai**.
1. (Opsional) Untuk menambahkan tag lain, pilih **Tambahkan tag** lagi.
1. Setelah Anda selesai menambahkan tag, pilih **Kirim**.
## Menambahkan tag ke grup laporan (AWS CLI)
Untuk menambahkan tag ke grup laporan saat Anda membuatnya, lihat[Buat grup laporan (CLI)](report-group-create.md#test-report-group-create-cli). Di`CreateReportGroup.json`, tambahkan tag Anda.
Untuk menambahkan tag ke grup laporan yang ada, lihat [Perbarui grup laporan (CLI)](report-group-export-settings.md#update-report-group-cli) dan tambahkan tag Anda`UpdateReportGroupInput.json`.
Dalam langkah-langkah ini, kami menganggap bahwa Anda telah menginstal versi terbaru dari AWS CLI atau diperbarui ke versi terkini. Untuk informasi lebih lanjut, lihat [Menginstal AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).
# Melihat tag untuk grup laporan
Tag dapat membantu Anda mengidentifikasi dan mengatur AWS sumber daya Anda dan mengelola akses ke sana. Untuk informasi lebih lanjut tentang penggunaan tanda, lihat laporan resmi [Praktik terbaik](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf). Untuk contoh kebijakan akses berbasis tag, lihat [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example).
## Melihat tag untuk grup laporan (konsol)
Anda dapat menggunakan CodeBuild konsol untuk melihat tag yang terkait dengan grup CodeBuild laporan.
1. Buka CodeBuild konsol di [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Di **Grup laporan**, pilih nama grup laporan tempat Anda ingin melihat tag.
1. Pada panel navigasi, silakan pilih **Pengaturan**.
## Melihat tag untuk grup laporan (AWS CLI)
Ikuti langkah-langkah ini untuk menggunakan AWS CLI untuk melihat AWS tag untuk grup laporan. Jika tidak ada tag yang ditambahkan, daftar tag yang dikembalikan kosong.
1. Gunakan konsol atau AWS CLI untuk menemukan ARN grup laporan Anda. Catat itu.
------
#### [ AWS CLI ]
Jalankan perintah berikut.
```
aws list-report-groups
```
Perintah ini mengembalikan informasi berformat JSON mirip dengan berikut ini:
```
{
"reportGroups": [
"arn:aws:codebuild:region:123456789012:report-group/report-group-1",
"arn:aws:codebuild:region:123456789012:report-group/report-group-2",
"arn:aws:codebuild:region:123456789012:report-group/report-group-3"
]
}
```
Grup laporan ARN diakhiri dengan namanya, yang dapat Anda gunakan untuk mengidentifikasi ARN untuk grup laporan Anda.
------
#### [ Console ]
1. Buka CodeBuild konsol di [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Di **Grup laporan**, pilih nama grup laporan Anda dengan tag yang ingin Anda lihat.
1. Di **Konfigurasi**, temukan ARN grup laporan Anda.
------
1. Jalankan perintah berikut. Gunakan ARN yang Anda catat untuk parameter tersebut. `--report-group-arns`
```
aws codebuild batch-get-report-groups --report-group-arns arn:aws:codebuild:region:123456789012:report-group/report-group-name
```
Jika berhasil, perintah ini mengembalikan informasi berformat JSON yang berisi `tags` bagian yang mirip dengan berikut ini:
```
{
...
"tags": {
"Status": "Secret",
"Project": "TestBuild"
}
...
}
```
# Mengedit tag untuk grup laporan
Anda dapat mengubah nilai untuk tag yang terkait dengan grup laporan. Anda juga dapat mengubah nama kunci, yang setara dengan menghapus tag saat ini dan menambahkan tag yang berbeda dengan nama baru dan nilai yang sama dengan kunci lainnya. Perlu diingat bahwa ada batasan pada karakter yang dapat Anda gunakan di bidang kunci dan nilai. Untuk informasi selengkapnya, lihat [Tag](limits.md#tag-limits).
**penting**
Mengedit tag untuk grup laporan dapat memengaruhi akses ke grup laporan tersebut. Sebelum Anda mengedit nama (kunci) atau nilai tag untuk grup laporan, pastikan untuk meninjau kebijakan IAM apa pun yang mungkin menggunakan kunci atau nilai tag untuk mengontrol akses ke sumber daya seperti grup laporan. Untuk contoh kebijakan akses berbasis tag, lihat [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example).
## Mengedit tag untuk grup laporan (konsol)
Anda dapat menggunakan CodeBuild konsol untuk mengedit tag yang terkait dengan grup CodeBuild laporan.
1. Buka CodeBuild konsol di [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Di **Grup laporan**, pilih nama grup laporan tempat Anda ingin mengedit tag.
1. Pada panel navigasi, silakan pilih **Pengaturan**.
1. Pilih **Edit**.
1. Lakukan salah satu tindakan berikut:
+ Untuk mengubah tag, masukkan nama baru di **Kunci**. Mengubah nama tag adalah setara dengan menghapus tag dan menambahkan tag baru dengan nama kunci baru.
+ Untuk mengubah nilai sebuah tag, masukkan nilai baru. Jika Anda ingin mengubah nilai menjadi nol, hapus nilai saat ini dan biarkan bidang kosong.
1. Setelah Anda selesai mengedit tag, pilih **Kirim**.
## Mengedit tag untuk grup laporan (AWS CLI)
Untuk menambahkan, mengubah, atau menghapus tag dari grup laporan, lihat[Perbarui grup laporan (CLI)](report-group-export-settings.md#update-report-group-cli). Perbarui tag di`UpdateReportGroupInput.json`.
# Menghapus tag dari grup laporan
Anda dapat menghapus satu atau beberapa tag yang terkait dengan grup laporan. Menghapus tag tidak menghapus tag dari AWS sumber daya lain yang terkait dengan tag tersebut.
**penting**
Menghapus tag untuk grup laporan dapat memengaruhi akses ke grup laporan tersebut. Sebelum menghapus tag dari grup laporan, pastikan untuk meninjau kebijakan IAM apa pun yang mungkin menggunakan kunci atau nilai tag untuk mengontrol akses ke sumber daya seperti grup laporan. Untuk contoh kebijakan akses berbasis tag, lihat [Menggunakan tag untuk mengontrol akses ke AWS CodeBuild sumber daya](auth-and-access-control-using-tags.md).
## Menghapus tag dari grup laporan (konsol)
Anda dapat menggunakan CodeBuild konsol untuk menghapus asosiasi antara tag dan grup CodeBuild laporan.
1. Buka CodeBuild konsol di [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Di **Grup laporan**, pilih nama grup laporan tempat Anda ingin menghapus tag.
1. Pada panel navigasi, silakan pilih **Pengaturan**.
1. Pilih **Edit**.
1. Temukan tag yang ingin Anda hapus, lalu pilih **Hapus tag**.
1. Setelah Anda selesai menghapus tag, pilih **Kirim**.
## Menghapus tag dari grup laporan (AWS CLI)
Ikuti langkah-langkah berikut untuk menggunakan AWS CLI untuk menghapus tag dari grup CodeBuild laporan. Menghapus tag tidak menghapusnya, tetapi hanya menghapus asosiasi antara tag dan grup laporan.
**catatan**
Jika Anda menghapus grup CodeBuild laporan, semua asosiasi tag akan dihapus dari grup laporan yang dihapus. Anda tidak perlu menghapus tag sebelum menghapus grup laporan.
Untuk menghapus satu atau beberapa tag dari grup laporan, lihat[Mengedit tag untuk grup laporan (AWS CLI)](how-to-tag-report-group-update.md#how-to-tag-report-group-update-cli). Perbarui `tags` bagian dalam data berformat JSON dengan daftar tag yang diperbarui yang tidak berisi tag yang ingin Anda hapus. Jika Anda ingin menghapus semua tag, perbarui `tags` bagian ke:
```
"tags: []"
```
# Memperbarui grup laporan
Saat memperbarui grup laporan, Anda dapat menentukan informasi tentang apakah akan mengekspor data hasil pengujian mentah ke file di bucket Amazon S3. Jika Anda memilih untuk mengekspor ke bucket S3, Anda dapat menentukan hal berikut untuk grup laporan Anda:
+ Apakah file hasil tes mentah dikompresi dalam file ZIP.
+ Apakah file hasil pengujian mentah dienkripsi. Anda dapat menentukan enkripsi dengan salah satu dari berikut ini:
+ An Kunci yang dikelola AWS untuk Amazon S3.
+ Kunci terkelola pelanggan yang Anda buat dan konfigurasikan.
Untuk informasi selengkapnya, lihat [Enkripsi data](security-encryption.md).
Jika Anda menggunakan AWS CLI untuk memperbarui grup laporan, Anda juga dapat memperbarui atau menambahkan tag. Untuk informasi selengkapnya, lihat [Menandai grup laporan di AWS CodeBuildMenandai grup laporan](how-to-tag-report-group.md).
**catatan**
Peran CodeBuild layanan yang ditentukan dalam proyek digunakan untuk izin untuk mengunggah ke bucket S3.
**Topics**
+ [Memperbarui grup laporan (konsol)](#update-report-group-console)
+ [Perbarui grup laporan (CLI)](#update-report-group-cli)
## Memperbarui grup laporan (konsol)
Gunakan prosedur berikut untuk memperbarui grup laporan menggunakan Konsol Manajemen AWS.
**Untuk memperbarui grup laporan**
1. Buka AWS CodeBuild konsol di [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Di panel navigasi, pilih **Laporkan grup**.
1. Pilih grup laporan yang ingin Anda perbarui.
1. Pilih **Edit**.
1. Pilih atau hapus **Cadangan ke Amazon S3**. Jika Anda memilih opsi ini, tentukan pengaturan ekspor Anda:
1. Untuk **nama bucket S3**, masukkan nama bucket S3.
1. Untuk **awalan Path**, masukkan path di bucket S3 tempat Anda ingin mengunggah hasil pengujian.
1. Pilih **Kompres data hasil pengujian dalam file zip** untuk mengompres file data hasil pengujian mentah Anda.
1. Perluas **Konfigurasi tambahan** untuk menampilkan opsi enkripsi. Pilih salah satu cara berikut:
+ **Kunci AWS terkelola default** untuk menggunakan Kunci yang dikelola AWS untuk Amazon S3. Untuk informasi selengkapnya, lihat [Pelanggan yang dikelola CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) di *Panduan AWS Key Management Service Pengguna*. Ini adalah opsi enkripsi default.
+ **Pilih kunci kustom untuk menggunakan kunci terkelola** pelanggan yang Anda buat dan konfigurasikan. Untuk **kunci AWS KMS enkripsi**, masukkan ARN kunci enkripsi Anda. Formatnya adalah ` arn:aws:kms:: :key/ `. Untuk informasi selengkapnya, lihat [Membuat kunci KMS](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) di *Panduan AWS Key Management Service Pengguna*.
+ **Nonaktifkan enkripsi artefak** untuk menonaktifkan enkripsi. Anda dapat memilih ini jika Anda ingin membagikan hasil tes Anda, atau mempublikasikannya ke situs web statis. (Situs web dinamis dapat menjalankan kode untuk mendekripsi hasil pengujian.)
## Perbarui grup laporan (CLI)
Gunakan prosedur berikut untuk memperbarui grup laporan menggunakan AWS CLI.
**Untuk memperbarui grup laporan**
1. Buat file bernama `UpdateReportGroupInput.json`.
1. Salin yang berikut ini ke`UpdateReportGroupInput.json`:
```
{
"arn": "",
"exportConfig": {
"exportConfigType": "S3",
"s3Destination": {
"bucket": "bucket-name",
"path": "path",
"packaging": "NONE | ZIP",
"encryptionDisabled": "false",
"encryptionKey": "your-key"
}
},
"tags": [
{
"key": "tag-key",
"value": "tag-value"
}
]
}
```
1. Masukkan ARN grup laporan Anda di `arn` baris (misalnya,. `"arn":"arn:aws:codebuild:region:123456789012:report-group/report-group-1")`
1. Perbarui `UpdateReportGroupInput.json` dengan pembaruan yang ingin Anda terapkan ke grup laporan Anda.
+ Jika Anda ingin memperbarui grup laporan untuk mengekspor file hasil pengujian mentah ke bucket S3, perbarui `exportConfig` bagian tersebut. Ganti `bucket-name` dengan nama bucket S3 Anda dan `path` dengan jalur di bucket S3 yang ingin Anda ekspor file. Jika Anda ingin mengompres file yang diekspor, untuk`packaging`, tentukan`ZIP`. Jika tidak, tentukan`NONE`. Gunakan `encryptionDisabled` untuk menentukan apakah akan mengenkripsi file yang diekspor. Jika Anda mengenkripsi file yang diekspor, masukkan kunci yang dikelola pelanggan Anda.
+ Jika ingin memperbarui grup laporan agar tidak mengekspor file hasil pengujian mentah ke bucket S3, perbarui `exportConfig` bagian tersebut dengan JSON berikut:
```
{
"exportConfig": {
"exportConfigType": "NO_EXPORT"
}
}
```
+ Jika Anda ingin memperbarui tag grup laporan, perbarui `tags` bagian tersebut. Anda dapat mengubah, menambah, atau menghapus tag. Jika Anda ingin menghapus semua tag, perbarui dengan JSON berikut:
```
"tags": []
```
1. Jalankan perintah berikut:
```
aws codebuild update-report-group \
--cli-input-json file://UpdateReportGroupInput.json
```