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 ketika satu atau lebih tugas build gagal.    
`false`  
Nilai default. Semua build yang sedang berjalan akan selesai.   
`true`  
Semua build yang berjalan akan dihentikan ketika salah satu tugas build gagal.

Secara default, semua tugas build batch berjalan dengan pengaturan build seperti `env` dan`phases`, ditentukan dalam file buildspec. Anda dapat mengganti pengaturan 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-grafik`](#build-spec.batch.build-graph)
+ [`batch/build-daftar`](#build-spec.batch.build-list)
+ [`batch/build-matriks`](#build-spec.batch.build-matrix)
+ [`batch/build-fanout`](#build-spec.batch.build-fanout)

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

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

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

**pengidentifikasi **  
Wajib. Pengidentifikasi tugas.

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

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

**bergantung pada **  
Tidak wajib. Array pengenal 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. Lihat ** ComputeType ** di [Membangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk kemungkinan nilai.  
**armada **  
Pengidentifikasi armada yang akan digunakan untuk tugas tersebut. Untuk informasi selengkapnya, lihat [Jalankan build pada armada kapasitas yang dicadangkan](fleets.md).  
**gambar **  
Pengidentifikasi gambar yang akan digunakan untuk tugas. Lihat ** Pengidentifikasi gambar ** di [Gambar Docker disediakan oleh CodeBuild](build-env-ref-available.md) untuk kemungkinan nilai.  
**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. Lihat ** Jenis ** lingkungan [Membangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk kemungkinan nilai.  
**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 pengidentifikasi 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, pembuatan batch akan gagal.   
`true`  
Jika tugas build ini gagal, build batch masih bisa berhasil. 

Berikut ini adalah contoh entri buildspec build graph:

```
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-daftar`
<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 [Buat daftar](batch-build.md#batch_build_list).

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

**pengidentifikasi **  
Wajib. Pengidentifikasi tugas.

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

**sesi debug **  
Tidak wajib. Nilai Boolean yang menunjukkan apakah sesi debugging diaktifkan untuk build batch ini. Untuk informasi selengkapnya tentang sesi debugging, 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. Lihat ** ComputeType ** di [Membangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk kemungkinan nilai.  
**armada **  
Pengidentifikasi armada yang akan digunakan untuk tugas tersebut. Untuk informasi selengkapnya, lihat [Jalankan build pada armada kapasitas yang dicadangkan](fleets.md).  
**gambar **  
Pengidentifikasi gambar yang akan digunakan untuk tugas. Lihat ** Pengidentifikasi gambar ** di [Gambar Docker disediakan oleh CodeBuild](build-env-ref-available.md) untuk kemungkinan nilai.  
**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. Lihat ** Jenis ** lingkungan [Membangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk kemungkinan nilai.  
**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 pengidentifikasi 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, pembuatan 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-matriks`
<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 [Bangun 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, pembuatan 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. Lihat ** Jenis ** lingkungan [Membangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk kemungkinan nilai.

**dinamis **  
Properti dinamis menentukan matriks build.    
**spesifikasi bangunan **  
Tidak wajib. Array yang berisi path dan nama file dari 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 untuk digunakan untuk tugas-tugas ini. Lihat ** ComputeType ** di [Membangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) untuk kemungkinan nilai.  
**gambar **  
Array yang berisi pengidentifikasi gambar untuk digunakan untuk tugas-tugas ini. Lihat ** Pengidentifikasi gambar ** di [Gambar Docker disediakan oleh CodeBuild](build-env-ref-available.md) untuk kemungkinan nilai.  
**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 build matrix:

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

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

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

Mendefinisikan fan * out * 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 pengujian 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, pembuatan batch akan gagal.  
**benar **  
Jika ada tugas pembuatan fanout yang gagal, pembuatan batch masih bisa berhasil.

Berikut ini adalah contoh entri buildspec build fanout:

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

Lihat informasi yang lebih lengkap di [Bangun fanout](batch-build.md#batch_build_fanout) dan [Gunakan perintah `codebuild-` tests-run CLI](parallel-test-tests-run.md).