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

# Referensi buildspec build Batch
<a name="batch-build-buildspec"></a>

Topik ini berisi referensi buildspec untuk properti build batch.

## batch
<a name="build-spec.batch"></a>

Pemetaan opsional. Pengaturan pembuatan batch untuk proyek.

**batch/cepat-gagal**  
Tidak wajib. Menentukan perilaku build batch saat satu atau beberapa tugas build gagal.    
`false`  
Nilai default. Semua build yang berjalan akan selesai.   
`true`  
Semua build yang berjalan akan dihentikan ketika salah satu tugas build gagal.

Secara default, semua tugas build batch dijalankan dengan setelan build seperti `env` dan`phases`, yang ditentukan dalam file buildspec. Anda dapat mengganti setelan build default dengan menentukan `env` nilai yang berbeda atau file buildspec yang berbeda dalam parameter. `batch/<batch-type>/buildspec`

Isi `batch` properti bervariasi berdasarkan jenis build batch yang ditentukan. Jenis build batch yang mungkin adalah:
+ [`batch/build-graph`](#build-spec.batch.build-graph)
+ [`batch/build-list`](#build-spec.batch.build-list)
+ [`batch/build-matrix`](#build-spec.batch.build-matrix)
+ [`batch/build-fanout`](#build-spec.batch.build-fanout)

## `batch/build-graph`
<a name="build-spec.batch.build-graph"></a>

Mendefinisikan *grafik build*. Grafik build mendefinisikan sekumpulan tugas yang memiliki dependensi pada tugas lain dalam batch. Untuk informasi selengkapnya, lihat [Membangun grafik](batch-build.md#batch_build_graph).

Elemen ini berisi array tugas build. Setiap tugas build berisi properti berikut.

**pengenal**  
Wajib. Pengidentifikasi tugas.

**buildspec**  
Tidak wajib. Path dan nama file file buildspec yang akan digunakan untuk tugas ini. Jika parameter ini tidak ditentukan, file buildspec saat ini digunakan.

**debug sesi**  
Tidak wajib. Nilai Boolean yang menunjukkan apakah debugging sesi diaktifkan untuk build batch ini. Untuk informasi selengkapnya tentang debugging sesi, lihat[Debug dibangun dengan Session Manager](session-manager.md).    
`false`  
Debugging sesi dinonaktifkan.   
`true`  
Debugging sesi diaktifkan. 

**tergantung pada**  
Tidak wajib. Array pengidentifikasi tugas yang bergantung pada tugas ini. Tugas ini tidak akan berjalan sampai tugas-tugas ini selesai.

**env**  
Tidak wajib. Lingkungan build menggantikan tugas tersebut. Ini dapat berisi properti berikut:    
**tipe komputasi**  
Pengidentifikasi tipe komputasi yang akan digunakan untuk tugas tersebut. Lihat **ComputeType** untuk nilai yang mungkin[Bangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md).  
**armada**  
Pengidentifikasi armada yang akan digunakan untuk tugas tersebut. Untuk informasi selengkapnya, lihat [Jalankan build di atas armada kapasitas cadangan](fleets.md).  
**gambar**  
Pengidentifikasi gambar yang akan digunakan untuk tugas tersebut. Lihat **Pengenal gambar** [Gambar Docker disediakan oleh CodeBuild](build-env-ref-available.md) untuk nilai yang mungkin.  
**mode istimewa**  
Nilai Boolean yang menunjukkan apakah akan menjalankan daemon Docker di dalam wadah Docker. Setel ke `true` hanya jika proyek build digunakan untuk membangun image Docker. Jika tidak, build yang mencoba berinteraksi dengan daemon Docker akan gagal. Pengaturan default-nya adalah `false`.  
**jenis**  
Pengidentifikasi jenis lingkungan yang akan digunakan untuk tugas tersebut. Lihat **Environment type** in [Bangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk nilai yang mungkin.  
**variabel**  
Variabel lingkungan yang akan hadir di lingkungan build. Untuk informasi selengkapnya, lihat [env/variabel](build-spec-ref.md#build-spec.env.variables).
Perhatikan bahwa **tipe komputasi** dan **armada** tidak dapat disediakan dalam pengenal yang sama dari satu build.

**abaikan-kegagalan**  
Tidak wajib. Nilai Boolean yang menunjukkan jika kegagalan tugas build ini dapat diabaikan.    
`false`  
Nilai default. Jika tugas build ini gagal, build batch akan gagal.   
`true`  
Jika tugas build ini gagal, build batch masih bisa berhasil. 

Berikut ini adalah contoh entri buildspec grafik build:

```
batch:
  fast-fail: false
  build-graph:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      depend-on:
        - build1
    - identifier: build3
      env:
        variables:
          BUILD_ID: build3
      depend-on:
        - build2
    - identifier: build4
      env:
        compute-type: ARM_LAMBDA_1GB
    - identifier: build5
      env:
        fleet: fleet_name
```

## `batch/build-list`
<a name="build-spec.batch.build-list"></a>

Mendefinisikan *daftar build*. Daftar build digunakan untuk menentukan sejumlah tugas yang berjalan secara paralel. Untuk informasi selengkapnya, lihat [Membangun daftar](batch-build.md#batch_build_list).

Elemen ini berisi array tugas build. Setiap tugas build berisi properti berikut.

**pengenal**  
Wajib. Pengidentifikasi tugas.

**buildspec**  
Tidak wajib. Path dan nama file file buildspec yang akan digunakan untuk tugas ini. Jika parameter ini tidak ditentukan, file buildspec saat ini digunakan.

**debug sesi**  
Tidak wajib. Nilai Boolean yang menunjukkan apakah debugging sesi diaktifkan untuk build batch ini. Untuk informasi selengkapnya tentang debugging sesi, lihat[Debug dibangun dengan Session Manager](session-manager.md).    
`false`  
Debugging sesi dinonaktifkan.   
`true`  
Debugging sesi diaktifkan. 

**env**  
Tidak wajib. Lingkungan build menggantikan tugas tersebut. Ini dapat berisi properti berikut:    
**tipe komputasi**  
Pengidentifikasi tipe komputasi yang akan digunakan untuk tugas tersebut. Lihat **ComputeType** untuk nilai yang mungkin[Bangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md).  
**armada**  
Pengidentifikasi armada yang akan digunakan untuk tugas tersebut. Untuk informasi selengkapnya, lihat [Jalankan build di atas armada kapasitas cadangan](fleets.md).  
**gambar**  
Pengidentifikasi gambar yang akan digunakan untuk tugas tersebut. Lihat **Pengenal gambar** [Gambar Docker disediakan oleh CodeBuild](build-env-ref-available.md) untuk nilai yang mungkin.  
**mode istimewa**  
Nilai Boolean yang menunjukkan apakah akan menjalankan daemon Docker di dalam wadah Docker. Setel ke `true` hanya jika proyek build digunakan untuk membangun image Docker. Jika tidak, build yang mencoba berinteraksi dengan daemon Docker akan gagal. Pengaturan default-nya adalah `false`.  
**jenis**  
Pengidentifikasi jenis lingkungan yang akan digunakan untuk tugas tersebut. Lihat **Environment type** in [Bangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk nilai yang mungkin.  
**variabel**  
Variabel lingkungan yang akan hadir di lingkungan build. Untuk informasi selengkapnya, lihat [env/variabel](build-spec-ref.md#build-spec.env.variables).
Perhatikan bahwa **tipe komputasi** dan **armada** tidak dapat disediakan dalam pengenal yang sama dari satu build.

**abaikan-kegagalan**  
Tidak wajib. Nilai Boolean yang menunjukkan jika kegagalan tugas build ini dapat diabaikan.    
`false`  
Nilai default. Jika tugas build ini gagal, build batch akan gagal.   
`true`  
Jika tugas build ini gagal, build batch masih bisa berhasil. 

Berikut ini adalah contoh entri buildspec daftar build:

```
batch:
  fast-fail: false
  build-list:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      ignore-failure: true
    - identifier: build3
      env:
        compute-type: ARM_LAMBDA_1GB
    - identifier: build4
      env:
        fleet: fleet_name
    - identifier: build5
      env:
        compute-type: GENERAL_LINUX_XLAGRE
```

## `batch/build-matrix`
<a name="build-spec.batch.build-matrix"></a>

Mendefinisikan *matriks build*. Matriks build mendefinisikan tugas dengan konfigurasi berbeda yang berjalan secara paralel. CodeBuild membuat build terpisah untuk setiap kombinasi konfigurasi yang mungkin. Untuk informasi selengkapnya, lihat [Membangun matriks](batch-build.md#batch_build_matrix).

**statis**  
Properti statis berlaku untuk semua tugas build.    
**abaikan-kegagalan**  
Tidak wajib. Nilai Boolean yang menunjukkan jika kegagalan tugas build ini dapat diabaikan.    
`false`  
Nilai default. Jika tugas build ini gagal, build batch akan gagal.   
`true`  
Jika tugas build ini gagal, build batch masih bisa berhasil.   
**env**  
Tidak wajib. Lingkungan build menggantikan semua tugas.     
**mode istimewa**  
Nilai Boolean yang menunjukkan apakah akan menjalankan daemon Docker di dalam wadah Docker. Setel ke `true` hanya jika proyek build digunakan untuk membangun image Docker. Jika tidak, build yang mencoba berinteraksi dengan daemon Docker akan gagal. Pengaturan default-nya adalah `false`.  
**jenis**  
Pengidentifikasi jenis lingkungan yang akan digunakan untuk tugas tersebut. Lihat **Environment type** in [Bangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk nilai yang mungkin.

**dinamis**  
Properti dinamis menentukan matriks build.    
**buildspec**  
Tidak wajib. Array yang berisi path dan nama file file buildspec yang akan digunakan untuk tugas-tugas ini. Jika parameter ini tidak ditentukan, file buildspec saat ini digunakan.   
**env**  
Tidak wajib. Lingkungan build menggantikan tugas-tugas ini.    
**tipe komputasi**  
Array yang berisi pengidentifikasi tipe komputasi yang akan digunakan untuk tugas-tugas ini. Lihat **ComputeType** untuk nilai yang mungkin[Bangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md).  
**gambar**  
Array yang berisi pengidentifikasi gambar yang akan digunakan untuk tugas-tugas ini. Lihat **Pengenal gambar** [Gambar Docker disediakan oleh CodeBuild](build-env-ref-available.md) untuk nilai yang mungkin.  
**variabel**  
Array yang berisi variabel lingkungan yang akan hadir di lingkungan build untuk tugas-tugas ini. Untuk informasi selengkapnya, lihat [env/variabel](build-spec-ref.md#build-spec.env.variables).

Berikut ini adalah contoh entri buildspec matriks build:

```
batch:
  build-matrix:
    static:
      ignore-failure: false
    dynamic:
      buildspec: 
        - matrix1.yml
        - matrix2.yml
      env:
        variables:
          MY_VAR:
            - VALUE1
            - VALUE2
            - VALUE3
```

Untuk informasi selengkapnya, lihat [Membangun matriks](batch-build.md#batch_build_matrix).

## `batch/build-fanout`
<a name="build-spec.batch.build-fanout"></a>

Mendefinisikan *fanout build*. Fanout build digunakan untuk mendefinisikan tugas yang dibagi menjadi beberapa build yang berjalan secara paralel. Untuk informasi selengkapnya, lihat [Jalankan tes paralel dalam build batch](parallel-test.md).

Elemen ini berisi tugas build yang dapat dibagi menjadi beberapa build. `build-fanout`Bagian ini berisi properti berikut.

**paralelisme**  
Wajib. Jumlah build yang akan menjalankan tes secara paralel.

**abaikan-kegagalan**  
Tidak wajib. Nilai boolean yang menunjukkan jika kegagalan dalam salah satu tugas build fanout dapat diabaikan. Nilai **ignore-failure** ini akan diterapkan ke semua build fanout.    
**palsu**  
Nilai default. Jika ada tugas pembuatan fanout yang gagal, build batch akan gagal.  
**benar**  
Jika ada tugas pembuatan fanout yang gagal, build batch masih bisa berhasil.

Berikut ini adalah contoh entri buildspec fanout build:

```
version: 0.2

batch:
   fast-fail: false 
   build-fanout:
     parallelism: 5
     ignore-failure: false

phases:
  install:
    commands:
      - npm install
   build:
    commands:
      - mkdir -p test-results
      - cd test-results
      - |
        codebuild-tests-run \
         --test-command 'npx jest --runInBand --coverage' \
         --files-search "codebuild-glob-search '**/test/**/*.test.js'" \
         --sharding-strategy 'equal-distribution'
```

Untuk informasi selengkapnya, silakan lihat [Bangun fanout](batch-build.md#batch_build_fanout) dan [Gunakan perintah `codebuild-tests-run` CLI](parallel-test-tests-run.md).