

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Laporan pengujian di AWS CodeBuild
<a name="test-reporting"></a>

Anda dapat membuat laporan CodeBuild yang berisi detail tentang pengujian yang dijalankan selama build. Anda dapat membuat pengujian seperti pengujian unit, pengujian konfigurasi, dan pengujian fungsional. 

Format file laporan pengujian berikut didukung:
+ Mentimun JSON (.json)
+ JUnit XML (.xml)
+ NUnit XML (.xml)
+ NUnit3 XML (.xml)
+ TestNG XML (.xml)
+ Studio Visual TRX (.trx)
+ Studio Visual TRX XML (.xml)

**catatan**  
 Versi terbaru yang didukung `cucumber-js` adalah 7.3.2. 

Buat kasus pengujian Anda dengan kerangka pengujian apa pun yang dapat membuat file laporan dalam salah satu format ini (misalnya, JUnit plugin Surefire, TestNG, atau Mentimun).

Untuk membuat laporan pengujian, Anda menambahkan nama grup laporan ke file buildspec proyek build dengan informasi tentang kasus pengujian Anda. Saat Anda menjalankan proyek build, kasus pengujian dijalankan dan laporan pengujian dibuat. Laporan pengujian baru dibuat dalam grup laporan setiap kali kasus uji dijalankan. Anda tidak perlu membuat grup laporan sebelum menjalankan pengujian. Jika Anda menentukan nama grup laporan, CodeBuild buat grup laporan untuk Anda saat menjalankan laporan. Jika Anda ingin menggunakan grup laporan yang sudah ada, Anda menentukan ARN dalam file buildspec.

Anda dapat menggunakan laporan pengujian untuk membantu memecahkan masalah selama proses build. Jika Anda memiliki banyak laporan pengujian dari beberapa build proyek build, Anda dapat menggunakan laporan pengujian untuk melihat tren dan tingkat pengujian dan kegagalan untuk membantu mengoptimalkan build. 

Laporan kedaluwarsa dalam 30 hari setelah dibuat. Anda tidak dapat melihat laporan pengujian yang kedaluwarsa. Jika ingin menyimpan laporan pengujian selama lebih dari 30 hari, Anda dapat mengekspor file data mentah hasil pengujian ke bucket Amazon S3. File uji yang diekspor tidak kedaluwarsa. Informasi tentang bucket S3 ditentukan saat Anda membuat grup laporan.

**catatan**  
Peran CodeBuild layanan yang ditentukan dalam proyek digunakan untuk izin untuk mengunggah ke bucket S3.

**Topics**
+ [

# Buat laporan pengujian
](report-create.md)
+ [

# Buat laporan cakupan kode
](code-coverage-report.md)
+ [

# Temukan laporan secara otomatis di CodeBuild
](report-auto-discover.md)
+ [

# Melaporkan kelompok
](test-report-group.md)
+ [

# Kerangka kerja uji
](test-framework-reporting.md)
+ [

# Lihat laporan pengujian
](test-view-reports.md)
+ [

# Izin laporan uji
](test-permissions.md)
+ [

# Status laporan uji
](test-report.md)

# Buat laporan pengujian
<a name="report-create"></a>

 Untuk membuat laporan pengujian, Anda menjalankan proyek build yang dikonfigurasi dengan satu hingga lima grup laporan dalam file buildspec. Laporan pengujian dibuat selama proses dijalankan. Ini berisi hasil kasus uji yang ditentukan untuk grup laporan. Laporan pengujian baru dibuat untuk setiap build berikutnya yang menggunakan file buildspec yang sama. 

**Untuk membuat laporan pengujian**

1. Buat proyek build. Untuk informasi, lihat [Buat proyek build di AWS CodeBuild](create-project.md). 

1. Konfigurasikan file buildspec proyek Anda dengan informasi laporan pengujian: 

   1. Tambahkan `reports:` bagian dan tentukan ARN dari grup laporan yang ada, atau nama grup laporan. 

      Jika Anda menentukan ARN, CodeBuild gunakan grup laporan tersebut.

      Jika Anda menentukan nama, CodeBuild membuat grup laporan untuk Anda menggunakan nama proyek Anda, dan nama yang Anda tentukan, dalam format *<project-name>* -*<report-group-name>*. Jika grup laporan bernama sudah ada, CodeBuild gunakan grup laporan tersebut.

   1. Di bawah grup laporan, tentukan lokasi file yang berisi hasil pengujian. Jika Anda menggunakan lebih dari satu grup laporan, tentukan lokasi file hasil pengujian untuk masing-masing grup laporan. Laporan pengujian baru dibuat setiap kali proyek build Anda berjalan. Untuk informasi selengkapnya, lihat [Tentukan file uji](report-group-test-cases.md). 

   1. Di `commands` bagian `post_build` urutan `build` atau, tentukan perintah yang menjalankan kasus pengujian yang Anda tentukan untuk grup laporan Anda. Untuk informasi selengkapnya, lihat [Tentukan perintah uji](report-group-test-case-commands.md). 

   Berikut ini adalah contoh dari bagian buildspec`reports`:

   ```
   reports:
     php-reports:
       files:
         - "reports/php/*.xml"
       file-format: "JUNITXML"
     nunit-reports:
       files:
         - "reports/nunit/*.xml"
       file-format: "NUNITXML"
   ```

1. Jalankan build proyek build. Untuk informasi selengkapnya, lihat [Jalankan AWS CodeBuild build secara manual](run-build.md). 

1. Saat build selesai, pilih build baru yang dijalankan dari **riwayat Build** di halaman project Anda. Pilih **Laporan** untuk melihat laporan pengujian. Untuk informasi selengkapnya, lihat [Melihat laporan pengujian untuk build](test-view-project-reports.md).

# Buat laporan cakupan kode
<a name="code-coverage-report"></a>

CodeBuild memungkinkan Anda menghasilkan laporan cakupan kode untuk pengujian Anda. Laporan cakupan kode berikut disediakan:

Cakupan garis  
Cakupan garis mengukur berapa banyak pernyataan yang dicakup pengujian Anda. Pernyataan adalah instruksi tunggal, tidak termasuk komentar atau persyaratan.  
`line coverage = (total lines covered)/(total number of lines)`

Cakupan cabang  
Cakupan cabang mengukur berapa banyak cabang yang dicakup pengujian Anda dari setiap cabang yang mungkin dari struktur kontrol, seperti `case` pernyataan `if` atau pernyataan.  
`branch coverage = (total branches covered)/(total number of branches)`

Format file laporan cakupan kode berikut didukung:
+ JaCoCo XML
+ SimpleCov JSON¹
+ XML semanggi
+ XML Cobertura
+ INFO LCOV

[¹ CodeBuild menerima laporan cakupan kode JSON yang dihasilkan oleh [simplecov, bukan simplecov-json](https://github.com/simplecov-ruby/simplecov).](https://github.com/vicentllongo/simplecov-json)

## Buat laporan cakupan kode
<a name="code-coverage-report-create"></a>

Untuk membuat laporan cakupan kode, Anda menjalankan proyek build yang dikonfigurasi dengan setidaknya satu grup laporan cakupan kode dalam file buildspec. CodeBuild akan menafsirkan hasil cakupan kode dan memberikan laporan cakupan kode untuk dijalankan. Laporan pengujian baru dibuat untuk setiap build berikutnya yang menggunakan file buildspec yang sama. 

**Untuk membuat laporan pengujian**

1. Buat proyek build. Untuk informasi, lihat [Buat proyek build di AWS CodeBuild](create-project.md).

1. Konfigurasikan file buildspec proyek Anda dengan informasi laporan pengujian:

   1. Tambahkan `reports:` bagian dan tentukan nama untuk grup laporan Anda. CodeBuild membuat grup laporan untuk Anda menggunakan nama proyek Anda dan nama yang Anda tentukan dalam format `project-name` -`report-group-name-in-buildspec`. Jika Anda sudah memiliki grup laporan yang ingin Anda gunakan, tentukan ARN-nya. Jika Anda menggunakan nama alih-alih ARN, CodeBuild buat grup laporan baru. Untuk informasi selengkapnya, lihat [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file). 

   1. Di bawah grup laporan, tentukan lokasi file yang berisi hasil cakupan kode. Jika Anda menggunakan lebih dari satu grup laporan, tentukan lokasi file hasil untuk setiap grup laporan. Laporan cakupan kode baru dibuat setiap kali proyek build Anda berjalan. Untuk informasi selengkapnya, lihat [Tentukan file uji](report-group-test-cases.md).

      Ini adalah contoh yang menghasilkan laporan cakupan kode untuk file hasil JaCoCo XHTML yang terletak di test-`results/jacoco-coverage-report.xml`.

      ```
      reports:
        jacoco-report:
          files:
            - 'test-results/jacoco-coverage-report.xml'
          file-format: 'JACOCOXML'
      ```

   1. Di `commands` bagian `post_build` urutan `build` atau, tentukan perintah yang menjalankan analisis cakupan kode. Untuk informasi selengkapnya, lihat [Tentukan perintah uji](report-group-test-case-commands.md). 

1. Jalankan build proyek build. Untuk informasi selengkapnya, lihat [Jalankan AWS CodeBuild build secara manual](run-build.md).

1. Saat build selesai, pilih build baru yang dijalankan dari **riwayat Build** di halaman project Anda. Pilih **Laporan** untuk melihat laporan cakupan kode. Lihat informasi yang lebih lengkap di [Melihat laporan pengujian untuk build](test-view-project-reports.md).

# Temukan laporan secara otomatis di CodeBuild
<a name="report-auto-discover"></a>

Dengan penemuan otomatis, CodeBuild menelusuri semua file build Anda setelah fase build selesai, mencari jenis file laporan yang didukung, dan secara otomatis membuat grup dan laporan laporan cakupan kode dan pengujian baru. Untuk setiap jenis laporan yang ditemukan, CodeBuild buat grup laporan baru dengan pola berikut:

```
<project-name>-<report-file-format>-AutoDiscovered
```

**catatan**  
Jika file laporan yang ditemukan memiliki jenis format yang sama, file tersebut akan ditempatkan ke grup laporan atau laporan yang sama.

Laporan auto-discover dikonfigurasi oleh variabel lingkungan proyek Anda:

`CODEBUILD_CONFIG_AUTO_DISCOVER`  
Variabel ini menentukan apakah report auto-discover dinonaktifkan selama build. Secara default, laporan auto-discover diaktifkan untuk semua build. Untuk menonaktifkan fitur ini, atur `CODEBUILD_CONFIG_AUTO_DISCOVER` ke`false`.

`CODEBUILD_CONFIG_AUTO_DISCOVER_DIR`  
(Opsional) Variabel ini menentukan di mana CodeBuild pencarian file laporan potensial. Perhatikan bahwa secara default, CodeBuild mencari secara `**/*` default.

Variabel lingkungan ini dapat dimodifikasi selama fase build. Misalnya, jika Anda hanya ingin mengaktifkan report auto-discover untuk build di cabang `main` git, Anda dapat memeriksa cabang git selama proses build dan menyetel `CODEBUILD_CONFIG_AUTO_DISCOVER` ke false jika build tidak ada di `main` cabang. Laporan auto-discover dapat dinonaktifkan menggunakan konsol atau menggunakan variabel lingkungan proyek.

**Topics**
+ [

## Konfigurasikan laporan auto-discover menggunakan konsol
](#report-auto-discover-configure-console)
+ [

## Konfigurasikan laporan auto-discover menggunakan variabel lingkungan proyek
](#report-auto-discover-configure-variable)

## Konfigurasikan laporan auto-discover menggunakan konsol
<a name="report-auto-discover-configure-console"></a>

Gunakan prosedur berikut untuk mengonfigurasi laporan penemuan otomatis menggunakan konsol.

**Untuk mengonfigurasi laporan auto-discover menggunakan konsol**

1. Buat proyek build atau pilih proyek build untuk diedit. Untuk informasi, lihat [Buat proyek build di AWS CodeBuild](create-project.md) atau[Ubah pengaturan proyek build di AWS CodeBuild](change-project.md).

1. Di **Lingkungan**, pilih **Konfigurasi tambahan**.

1. Untuk menonaktifkan laporan auto-discover, di **Laporkan auto-discover**, pilih **Nonaktifkan laporan** auto-discover.

1. (Opsional) Di **direktori Auto-discover - opsional**, masukkan pola direktori CodeBuild untuk mencari file format laporan yang didukung. Perhatikan bahwa CodeBuild pencarian secara `**/*` default.

## Konfigurasikan laporan auto-discover menggunakan variabel lingkungan proyek
<a name="report-auto-discover-configure-variable"></a>

Gunakan prosedur berikut untuk mengonfigurasi penemuan otomatis laporan menggunakan variabel lingkungan proyek.

**Untuk mengonfigurasi laporan auto-discover menggunakan variabel lingkungan proyek**

1. Buat proyek build atau pilih proyek build untuk diedit. Untuk informasi, lihat [Buat proyek build di AWS CodeBuild](create-project.md) atau[Ubah pengaturan proyek build di AWS CodeBuild](change-project.md).

1. Dalam **variabel Lingkungan**, lakukan hal berikut:

   1. Untuk menonaktifkan laporan auto-discover, untuk **Nama**, enter **CODEBUILD\$1CONFIG\$1AUTO\$1DISCOVER** dan untuk **Nilai**, masukkan**false**. Ini menonaktifkan laporan auto-discover.

   1. (Opsional) Untuk **Nama**, masukkan **CODEBUILD\$1CONFIG\$1AUTO\$1DISCOVER\$1DIR** dan untuk **Nilai**, masukkan direktori tempat CodeBuild harus mencari file format laporan yang didukung. Misalnya, `output/*xml` mencari `.xml` file di direktori `output`

# Melaporkan kelompok
<a name="test-report-group"></a>

*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
<a name="report-group-create"></a>

 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)
<a name="test-report-group-create-buildspec"></a>

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)
<a name="test-report-group-create-console"></a>

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:<region-id>: <aws-account-id>:key/<key-id> `. 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)
<a name="test-report-group-create-cli"></a>

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": "<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"
           }
         ]
       }
     }
     ```
     + Ganti *<bucket-name>* dengan nama bucket Amazon S3 Anda dan *<path>* 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": "<report-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)
<a name="test-report-group-create-cfn"></a>

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
<a name="test-report-group-naming"></a>

 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
<a name="report-groups-sharing"></a>

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
<a name="report-groups-sharing-share"></a>

 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
<a name="report-groups-sharing-related"></a>

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
<a name="report-groups-sharing-access-prereqs"></a>

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
<a name="report-groups-sharing-unshare"></a>

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
<a name="report-groups-sharing-identify"></a>

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
<a name="report-groups-sharing-perms"></a>

## Izin untuk pemilik
<a name="report-groups-perms-owner"></a>

Pemilik grup laporan dapat mengedit grup laporan dan menentukannya dalam proyek untuk menjalankan laporan.

## Izin untuk konsumen
<a name="report-groups-perms-consumer"></a>

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
<a name="report-group-test-cases"></a>

 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
<a name="report-group-test-case-commands"></a>

 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
<a name="how-to-tag-report-group"></a>

*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
<a name="how-to-tag-report-group-add"></a>

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)
<a name="how-to-tag-report-group-add-console"></a>

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)
<a name="how-to-tag-report-group-add-cli"></a>

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
<a name="how-to-tag-report-group-list"></a>

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)
<a name="how-to-tag-report-group-list-console"></a>

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)
<a name="how-to-tag-report-group-list-cli"></a>

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
<a name="how-to-tag-report-group-update"></a>

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)
<a name="how-to-tag-report-group-update-console"></a>

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)
<a name="how-to-tag-report-group-update-cli"></a>

 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
<a name="how-to-tag-report-group-delete"></a>

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)
<a name="how-to-tag-report-group-delete-console"></a>

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)
<a name="how-to-tag-report-group-delete-cli"></a>

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
<a name="report-group-export-settings"></a>

 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)
<a name="update-report-group-console"></a>

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:<region-id>: <aws-account-id>:key/<key-id> `. 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)
<a name="update-report-group-cli"></a>

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
   ```

# Kerangka kerja uji
<a name="test-framework-reporting"></a>

Topik di bagian ini menunjukkan cara mengatur pelaporan pengujian AWS CodeBuild untuk berbagai kerangka pengujian.

**Topics**
+ [

# Siapkan pelaporan pengujian dengan Jasmine
](test-report-jasmine.md)
+ [

# Siapkan pelaporan pengujian dengan Jest
](test-report-jest.md)
+ [

# Siapkan pelaporan pengujian dengan pytest
](test-report-pytest.md)
+ [

# Siapkan pelaporan pengujian dengan RSpec
](test-report-rspec.md)

# Siapkan pelaporan pengujian dengan Jasmine
<a name="test-report-jasmine"></a>

Prosedur berikut menunjukkan cara mengatur pelaporan pengujian AWS CodeBuild dengan kerangka pengujian [JasmineBDD](http://jasmine.github.io/). 

Prosedur ini membutuhkan prasyarat berikut:
+ Anda memiliki CodeBuild proyek yang sudah ada.
+ Proyek Anda adalah proyek Node.js yang disiapkan untuk menggunakan kerangka pengujian Jasmine.

Tambahkan [https://www.npmjs.com/package/jasmine-reporters](https://www.npmjs.com/package/jasmine-reporters)paket ke `devDependencies` bagian `package.json` file proyek Anda. Paket ini memiliki koleksi kelas JavaScript reporter yang dapat digunakan dengan Jasmine. 

```
npm install --save-dev jasmine-reporters
```

Jika belum ada, tambahkan `test` skrip ke `package.json` file proyek Anda. `test`Script memastikan bahwa Jasmine dipanggil ketika **npm test** dijalankan.

```
{
  "scripts": {
    "test": "npx jasmine"
  }
}
```

CodeBuild mendukung reporter tes Jasmine berikut:

**JUnitXmlReporter**  
Digunakan untuk menghasilkan laporan dalam `JunitXml` format.

**NUnitXmlReporter**  
Digunakan untuk menghasilkan laporan dalam `NunitXml` format.

Proyek Node.js dengan Jasmine akan, secara default, memiliki `spec` sub-direktori, yang berisi konfigurasi Jasmine dan skrip pengujian. 

Untuk mengonfigurasi Jasmine untuk menghasilkan laporan dalam `JunitXML` format, buat instance `JUnitXmlReporter` reporter dengan menambahkan kode berikut ke pengujian Anda. 

```
var reporters = require('jasmine-reporters');

var junitReporter = new reporters.JUnitXmlReporter({
  savePath: <test report directory>,
  filePrefix: <report filename>,
  consolidateAll: true
});

jasmine.getEnv().addReporter(junitReporter);
```

Untuk mengonfigurasi Jasmine untuk menghasilkan laporan dalam `NunitXML` format, buat instance `NUnitXmlReporter` reporter dengan menambahkan kode berikut ke pengujian Anda. 

```
var reporters = require('jasmine-reporters');

var nunitReporter = new reporters.NUnitXmlReporter({
  savePath: <test report directory>,
  filePrefix: <report filename>,
  consolidateAll: true
});

jasmine.getEnv().addReporter(nunitReporter)
```

Laporan pengujian diekspor ke file yang ditentukan oleh*<test report directory>*/*<report filename>*.

Dalam `buildspec.yml` file Anda, tambahkan/perbarui bagian berikut.

```
version: 0.2

phases:
  pre_build:
    commands:
      - npm install
  build:
    commands:
      - npm build
      - npm test

reports:
  jasmine_reports:
    files:
      - <report filename>
    file-format: JUNITXML
    base-directory: <test report directory>
```

Jika Anda menggunakan format `NunitXml` laporan, ubah `file-format` nilainya menjadi yang berikut.

```
    file-format: NUNITXML
```

# Siapkan pelaporan pengujian dengan Jest
<a name="test-report-jest"></a>

Prosedur berikut menunjukkan cara mengatur pelaporan pengujian AWS CodeBuild dengan kerangka [pengujian Jest](https://jestjs.io/). 

Prosedur ini membutuhkan prasyarat berikut:
+ Anda memiliki CodeBuild proyek yang sudah ada.
+ Proyek Anda adalah proyek Node.js yang disiapkan untuk menggunakan kerangka pengujian Jest.

Tambahkan [https://www.npmjs.com/package/jest-junit](https://www.npmjs.com/package/jest-junit)paket ke `devDependencies` bagian `package.json` file proyek Anda. CodeBuild menggunakan paket ini untuk menghasilkan laporan dalam `JunitXml` format.

```
npm install --save-dev jest-junit
```

Jika belum ada, tambahkan `test` skrip ke `package.json` file proyek Anda. `test`Skrip memastikan bahwa Jest dipanggil saat **npm test** dijalankan.

```
{
  "scripts": {
    "test": "jest"
  }
}
```

Konfigurasikan Jest untuk menggunakan `JunitXml` reporter dengan menambahkan yang berikut ini ke file konfigurasi Jest Anda. Jika proyek Anda tidak memiliki file konfigurasi Jest, buat file bernama `jest.config.js` di root proyek Anda dan tambahkan yang berikut ini. Laporan pengujian diekspor ke file yang ditentukan oleh*<test report directory>*/*<report filename>*.

```
module.exports = {
  reporters: [
    'default',
    [ 'jest-junit', {
      outputDirectory: <test report directory>,
      outputName: <report filename>,
    } ]
  ]
};
```

Dalam `buildspec.yml` file Anda, tambahkan/perbarui bagian berikut.

```
version: 0.2

phases:
  pre_build:
    commands:
      - npm install
  build:
    commands:
      - npm build
      - npm test

reports:
  jest_reports:
    files:
      - <report filename>
    file-format: JUNITXML
    base-directory: <test report directory>
```

# Siapkan pelaporan pengujian dengan pytest
<a name="test-report-pytest"></a>

Prosedur berikut menunjukkan cara mengatur pelaporan pengujian AWS CodeBuild dengan kerangka [pengujian pytest](https://docs.pytest.org/). 

Prosedur ini membutuhkan prasyarat berikut:
+ Anda memiliki CodeBuild proyek yang sudah ada.
+ Proyek Anda adalah proyek Python yang disiapkan untuk menggunakan kerangka pengujian pytest.

Tambahkan entri berikut ke salah satu `build` atau `post_build` fase `buildspec.yml` file Anda. Kode ini secara otomatis menemukan tes di direktori saat ini dan mengekspor laporan pengujian ke file yang ditentukan oleh*<test report directory>*/. *<report filename>* Laporan menggunakan `JunitXml` format.

```
      - python -m pytest --junitxml=<test report directory>/<report filename>
```

Dalam `buildspec.yml` file Anda, tambahkan/perbarui bagian berikut.

```
version: 0.2

phases:
  install:
    runtime-versions:
      python: 3.7
    commands:
      - pip3 install pytest
  build:
    commands:
      - python -m pytest --junitxml=<test report directory>/<report filename>

reports:
  pytest_reports:
    files:
      - <report filename>
    base-directory: <test report directory>
    file-format: JUNITXML
```

# Siapkan pelaporan pengujian dengan RSpec
<a name="test-report-rspec"></a>

Prosedur berikut menunjukkan cara mengatur pelaporan pengujian AWS CodeBuild dengan [kerangka RSpec pengujian](https://rspec.info/). 

Prosedur ini membutuhkan prasyarat berikut:
+ Anda memiliki CodeBuild proyek yang sudah ada.
+ Proyek Anda adalah proyek Ruby yang disiapkan untuk menggunakan kerangka RSpec pengujian.

Tambahkan/perbarui yang berikut ini di file Anda`buildspec.yml`. Kode ini menjalankan tes di *<test source directory>* direktori dan mengekspor laporan pengujian ke file yang ditentukan oleh*<test report directory>*/*<report filename>*. Laporan menggunakan `JunitXml` format.

```
version: 0.2

phases:
  install:
    runtime-versions:
      ruby: 2.6
  pre_build:
    commands:
      - gem install rspec
      - gem install rspec_junit_formatter
  build:
    commands:
      - rspec <test source directory>/* --format RspecJunitFormatter --out <test report directory>/<report filename>
reports:
    rspec_reports:
        files:
            - <report filename>
        base-directory: <test report directory>
        file-format: JUNITXML
```

# Lihat laporan pengujian
<a name="test-view-reports"></a>

 Anda dapat melihat detail tentang laporan pengujian, seperti informasi tentang kasus uji, nomor lulus dan gagal, dan berapa lama waktu yang dibutuhkan untuk menjalankannya. Anda dapat melihat laporan pengujian yang dikelompokkan berdasarkan build run, grup laporan, atau AWS akun Anda. Pilih laporan pengujian di konsol untuk melihat detail dan hasil kasus pengujiannya. 

 Anda dapat melihat melihat laporan pengujian yang tidak kedaluwarsa. Laporan pengujian kedaluwarsa 30 hari setelah dibuat. Anda tidak dapat melihat laporan kedaluwarsa di CodeBuild. 

**Topics**
+ [

# Melihat laporan pengujian untuk build
](test-view-project-reports.md)
+ [

# Melihat laporan pengujian untuk grup laporan
](test-view-report-group-reports.md)
+ [

# Melihat laporan pengujian di AWS akun Anda
](test-view-account-reports.md)

# Melihat laporan pengujian untuk build
<a name="test-view-project-reports"></a>

**Untuk melihat laporan pengujian untuk build**

1. Buka AWS CodeBuild konsol di [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1.  Temukan build yang ingin Anda lihat. Jika Anda mengetahui proyek yang menjalankan build yang membuat laporan pengujian: 

   1.  Di panel navigasi, pilih **Build projects**, lalu pilih project dengan build yang menjalankan laporan pengujian yang ingin Anda lihat. 

   1.  Pilih **Riwayat build**, lalu pilih build yang menjalankan membuat laporan yang ingin Anda lihat. 

    Anda juga dapat menemukan build dalam riwayat build untuk AWS akun Anda: 

   1.  Di panel navigasi, pilih **Riwayat build**, lalu pilih build yang membuat laporan pengujian yang ingin Anda lihat. 

1. Di halaman build, pilih **Laporan**, lalu pilih laporan pengujian untuk melihat detailnya.

# Melihat laporan pengujian untuk grup laporan
<a name="test-view-report-group-reports"></a>

**Untuk melihat laporan pengujian dalam 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 berisi laporan pengujian yang ingin Anda lihat. 

1.  Pilih laporan pengujian untuk melihat detailnya. 

# Melihat laporan pengujian di AWS akun Anda
<a name="test-view-account-reports"></a>



**Untuk melihat laporan pengujian di AWS akun Anda**

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 **Laporan riwayat**. 

1.  Pilih laporan pengujian untuk melihat detailnya. 

# Izin laporan uji
<a name="test-permissions"></a>

 Topik ini menjelaskan informasi penting tentang izin yang terkait dengan pelaporan pengujian. 

**Topics**
+ [

## Peran IAM untuk laporan pengujian
](#test-permissions-required)
+ [

## Izin untuk operasi pelaporan pengujian
](#test-permissions-related-to-reporting)
+ [

## Contoh izin pelaporan uji
](#test-permissions-examples)

## Peran IAM untuk laporan pengujian
<a name="test-permissions-required"></a>

Untuk menjalankan laporan pengujian, dan memperbarui proyek agar menyertakan laporan pengujian, peran IAM Anda memerlukan izin berikut. Izin ini disertakan dalam kebijakan AWS terkelola yang telah ditentukan sebelumnya. Jika ingin menambahkan pelaporan pengujian ke proyek build yang sudah ada, Anda harus menambahkan izin ini sendiri.
+ `CreateReportGroup` 
+ `CreateReport` 
+ `UpdateReport` 
+ `BatchPutTestCases` 

Untuk menjalankan laporan cakupan kode, peran IAM Anda juga harus menyertakan `BatchPutCodeCoverages` izin.

**catatan**  
`BatchPutTestCases`,`CreateReport`,`UpdateReport`, dan `BatchPutCodeCoverages` bukan izin publik. Anda tidak dapat memanggil AWS CLI perintah atau metode SDK yang sesuai untuk izin ini. 

Untuk memastikan Anda memiliki izin ini, Anda dapat melampirkan kebijakan berikut ke peran IAM Anda: 

```
{
    "Effect": "Allow",
    "Resource": [
        "*"
    ],
    "Action": [
        "codebuild:CreateReportGroup",
        "codebuild:CreateReport",
        "codebuild:UpdateReport",
        "codebuild:BatchPutTestCases",
        "codebuild:BatchPutCodeCoverages"
    ]
}
```

Kami menyarankan Anda membatasi kebijakan ini hanya untuk grup laporan yang harus Anda gunakan. Berikut ini membatasi izin hanya untuk grup laporan dengan keduanya ARNs dalam kebijakan: 

```
{
    "Effect": "Allow",
    "Resource": [
        "arn:aws:codebuild:your-region:your-aws-account-id:report-group/report-group-name-1",
        "arn:aws:codebuild:your-region:your-aws-account-id:report-group/report-group-name-2"
    ],
    "Action": [
        "codebuild:CreateReportGroup",
        "codebuild:CreateReport",
        "codebuild:UpdateReport",
        "codebuild:BatchPutTestCases",
        "codebuild:BatchPutCodeCoverages"
    ]
}
```

Berikut ini membatasi izin untuk hanya melaporkan grup yang dibuat dengan menjalankan build proyek bernama: `my-project` 

```
{
    "Effect": "Allow",
    "Resource": [
        "arn:aws:codebuild:your-region:your-aws-account-id:report-group/my-project-*"
    ],
    "Action": [
        "codebuild:CreateReportGroup",
        "codebuild:CreateReport",
        "codebuild:UpdateReport",
        "codebuild:BatchPutTestCases",
        "codebuild:BatchPutCodeCoverages"
    ]
}
```

**catatan**  
Peran CodeBuild layanan yang ditentukan dalam proyek digunakan untuk izin untuk mengunggah ke bucket S3.

## Izin untuk operasi pelaporan pengujian
<a name="test-permissions-related-to-reporting"></a>

 Anda dapat menentukan izin untuk operasi CodeBuild API pelaporan pengujian berikut: 
+  `BatchGetReportGroups` 
+  `BatchGetReports` 
+  `CreateReportGroup` 
+  `DeleteReportGroup` 
+  `DeleteReport` 
+  `DescribeTestCases` 
+  `ListReportGroups` 
+  `ListReports` 
+  `ListReportsForReportGroup` 
+  `UpdateReportGroup` 

Untuk informasi selengkapnya, lihat [AWS CodeBuild referensi izin](auth-and-access-control-permissions-reference.md).

## Contoh izin pelaporan uji
<a name="test-permissions-examples"></a>

 Untuk informasi tentang kebijakan sampel yang terkait dengan pelaporan pengujian, lihat berikut ini: 
+  [Izinkan pengguna mengubah grup laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-change-report-group) 
+  [Izinkan pengguna membuat grup laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-create-report-group) 
+  [Memungkinkan pengguna untuk menghapus laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-delete-report) 
+  [Izinkan pengguna menghapus grup laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-delete-report-group) 
+  [Memungkinkan pengguna untuk mendapatkan informasi tentang grup laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-get-information-about-report-group) 
+  [Memungkinkan pengguna untuk mendapatkan informasi tentang laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-get-information-about-reports) 
+  [Izinkan pengguna untuk mendapatkan daftar grup laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-report-groups) 
+  [Memungkinkan pengguna untuk mendapatkan daftar laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-reports) 
+  [Memungkinkan pengguna untuk mendapatkan daftar laporan untuk grup laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-reports-for-report-group) 
+  [Memungkinkan pengguna untuk mendapatkan daftar kasus uji untuk laporan](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-get-list-of-test-cases-for-report) 

# Status laporan uji
<a name="test-report"></a>

Status laporan pengujian dapat berupa salah satu dari yang berikut:
+ `GENERATING`: Jalankan kasus uji masih dalam proses.
+ `DELETING`: Laporan pengujian sedang dihapus. Ketika laporan pengujian dihapus, kasus pengujiannya juga dihapus. File data hasil pengujian mentah yang diekspor ke bucket S3 tidak dihapus.
+ `INCOMPLETE`: Laporan pengujian belum selesai. Status ini dapat dikembalikan karena salah satu alasan berikut:
  + Masalah dengan konfigurasi grup laporan yang menentukan kasus uji laporan ini. Misalnya, jalur ke kasus pengujian di bawah grup laporan dalam file buildspec mungkin salah.
  + Pengguna IAM yang menjalankan build tidak memiliki izin untuk menjalankan pengujian. Untuk informasi selengkapnya, lihat [Izin laporan uji](test-permissions.md).
  + Build tidak selesai karena kesalahan yang tidak terkait dengan pengujian.
+ `SUCCEEDED`: Semua kasus uji berhasil.
+ `FAILED`: Beberapa kasus uji tidak berhasil.

Setiap kasus uji mengembalikan status. Status untuk kasus uji dapat berupa salah satu dari yang berikut:
+ `SUCCEEDED`: Kasus uji lulus.
+ `FAILED`: Kasus uji gagal.
+ `ERROR`: Kasus uji menghasilkan kesalahan yang tidak terduga.
+ `SKIPPED`: Kasus uji tidak berjalan.
+ `UNKNOWN`: Kasus uji mengembalikan status selain`SUCCEEDED`,`FAILED`,`ERROR`, atau`SKIPPED`.

Laporan pengujian dapat memiliki maksimal 500 hasil kasus uji. Jika lebih dari 500 kasus uji dijalankan, CodeBuild prioritaskan pengujian dengan status `FAILED` dan potong hasil kasus uji. 