Referensi buildspec build batch

Topik ini berisi referensi buildspec untuk properti build batch.

batch

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 danphases, 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

• batch/build-daftar

• batch/build-matriks

• batch/build-fanout

batch/build-grafik

Mendefinisikan grafik build. Grafik build mendefinisikan serangkaian tugas yang memiliki dependensi pada tugas lain dalam batch. Untuk informasi selengkapnya, lihat Bangun grafik.

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, lihatDebug dibangun dengan Session Manager.

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 untuk kemungkinan nilai.

armada

Pengidentifikasi armada yang akan digunakan untuk tugas tersebut. Untuk informasi selengkapnya, lihat Jalankan build pada armada kapasitas yang dicadangkan.

gambar

Pengidentifikasi gambar yang akan digunakan untuk tugas. Lihat Pengidentifikasi gambar di Gambar Docker disediakan oleh CodeBuild 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 untuk kemungkinan nilai.

variabel

Variabel lingkungan yang akan hadir di lingkungan build. Untuk informasi selengkapnya, lihat env/variabel .

catatan

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

Mendefinisikan daftar build. Daftar build digunakan untuk menentukan sejumlah tugas yang berjalan secara paralel. Untuk informasi selengkapnya, lihat Buat daftar.

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, lihatDebug dibangun dengan Session Manager.

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 untuk kemungkinan nilai.

armada

Pengidentifikasi armada yang akan digunakan untuk tugas tersebut. Untuk informasi selengkapnya, lihat Jalankan build pada armada kapasitas yang dicadangkan.

gambar

Pengidentifikasi gambar yang akan digunakan untuk tugas. Lihat Pengidentifikasi gambar di Gambar Docker disediakan oleh CodeBuild 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 untuk kemungkinan nilai.

variabel

Variabel lingkungan yang akan hadir di lingkungan build. Untuk informasi selengkapnya, lihat env/variabel .

catatan

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

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.

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 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 untuk kemungkinan nilai.

gambar

Array yang berisi pengidentifikasi gambar untuk digunakan untuk tugas-tugas ini. Lihat Pengidentifikasi gambar di Gambar Docker disediakan oleh CodeBuild 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 .

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

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.

Elemen ini berisi tugas build yang dapat dibagi menjadi beberapa build. build-fanoutBagian 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 dan Gunakan perintah codebuild- tests-run CLI.