

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

# 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**
+ [Buat 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)
+ [Buat grup laporan (CloudFormation)](#test-report-group-create-cfn)

## Buat 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 pengaturan 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 kerangka kerja JUnit: 

   ```
   reports:
    new-report-group: #surefire junit reports
      files:
        - '**/*'
      base-directory: 'surefire/target/surefire-reports'
   ```

   Nama grup laporan juga dapat ditentukan dengan menggunakan variabel lingkungan di 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 pengujian](report-group-test-cases.md) dan [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file). 

1. Di `commands` bagian tersebut, tentukan perintah untuk menjalankan tes Anda. Untuk informasi selengkapnya, lihat [Tentukan perintah pengujian](report-group-test-case-commands.md). 

1.  Jalankan build. Ketika build selesai, grup laporan baru dibuat dengan nama yang menggunakan format`project-name-report-group-name`. Untuk informasi selengkapnya, lihat [Penamaan grup laporan](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 ** Grup laporan**. 

1. Pilih ** Buat grup laporan**. 

1. Untuk Nama grup ** laporan**, masukkan nama untuk grup laporan Anda. 

1. (Opsional) Untuk ** Tag**, masukkan nama dan nilai tag apa pun yang ingin AWS digunakan layanan pendukung. Gunakan ** Tambahkan baris ** untuk menambahkan tag. Anda dapat menambahkan hingga 50 tag. 

1. Jika Anda ingin mengunggah data mentah hasil laporan pengujian Anda 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**, AWS masukkan pengenal 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 ** Path prefix**, masukkan path di bucket S3 tempat Anda ingin mengunggah hasil pengujian. 

   1. Pilih ** Kompres data hasil tes dalam file zip ** untuk mengompres file data hasil tes mentah Anda. 

   1. Perluas Konfigurasi ** tambahan ** untuk menampilkan opsi enkripsi. Pilih salah satu cara berikut: 
      + **K AWS unci terkelola default ** untuk menggunakan Kunci yang dikelola AWS untuk Amazon S3. Untuk informasi selengkapnya, lihat CMK yang dikelola [ pelanggan ](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 khusus ** untuk menggunakan kunci yang dikelola 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 diam, lihat[Enkripsi data](security-encryption.md). 
**catatan**  
Per CodeBuild an 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. Tergantung 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**  
Per CodeBuild an 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
   ```

## Buat grup laporan (CloudFormation)
<a name="test-report-group-create-cfn"></a>

Gunakan petunjuk berikut untuk membuat grup laporan menggunakan CloudFormation template

 **Untuk membuat grup laporan menggunakan CloudFormation template ** 

 Anda dapat menggunakan file CloudFormation template 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 YAML 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 YAML 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**  
Per CodeBuild an layanan yang ditentukan dalam proyek digunakan untuk izin untuk mengunggah ke bucket S3.