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

# Gunakan perintah `codebuild-tests-run` CLI
<a name="parallel-test-tests-run"></a>

AWS CodeBuild menyediakan CLI yang akan mengambil perintah uji dan lokasi file uji sebagai input. CLI dengan input ini akan membagi tes menjadi jumlah pecahan seperti yang ditentukan di `parallelism` bidang berdasarkan nama file uji. Penugasan file uji ke pecahan ditentukan oleh strategi sharding.

```
codebuild-tests-run \
    --files-search "codebuild-glob-search '**/__tests__/*.js'" \
    --test-command 'npx jest --runInBand --coverage' \
    --sharding-strategy 'equal-distribution'
```

Tabel berikut menjelaskan bidang untuk perintah `codebuild-tests-run` CLI.


| Nama bidang | Jenis | Diperlukan atau opsional | Definisi | 
| --- | --- | --- | --- | 
|  `test-command`  |  String  |  Diperlukan  |  Perintah ini digunakan untuk menjalankan tes.  | 
|  `files-search`  |  String  |  Diperlukan  |  Perintah ini memberikan daftar file uji. Anda dapat menggunakan perintah [codebuild-glob-search](parallel-test-glob-search.md)CLI yang AWS CodeBuild disediakan atau alat pencarian file lain pilihan Anda.  Pastikan bahwa `files-search` perintah mengeluarkan nama file, masing-masing dipisahkan oleh baris baru.   | 
|  `sharding-strategy`  |  Enum  |  Opsional  |  Nilai yang valid: `equal-distribution` (default), `stability` [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codebuild/latest/userguide/parallel-test-tests-run.html) Untuk informasi selengkapnya, lihat [Tentang test splitting](parallel-test-splitting.md).  | 

`codebuild-tests-run`CLI bekerja terlebih dahulu untuk mengidentifikasi daftar file uji menggunakan perintah yang disediakan dalam parameter. `files-search` Kemudian menentukan subset file uji yang ditunjuk untuk pecahan saat ini (lingkungan) menggunakan strategi sharding yang ditentukan. Akhirnya, subset file uji ini diformat ke dalam daftar yang dipisahkan spasi dan ditambahkan ke akhir perintah yang disediakan dalam parameter sebelum dieksekusi. `test-command`

Untuk kerangka kerja pengujian yang tidak menerima daftar yang dipisahkan spasi, `codebuild-tests-run` CLI menyediakan alternatif yang fleksibel melalui variabel lingkungan. `CODEBUILD_CURRENT_SHARD_FILES` Variabel ini berisi daftar jalur file pengujian yang dipisahkan baris baru yang ditunjuk untuk pecahan build saat ini. Dengan memanfaatkan variabel lingkungan ini, Anda dapat dengan mudah beradaptasi dengan berbagai persyaratan kerangka pengujian, mengakomodasi yang mengharapkan format input berbeda dari daftar yang dipisahkan ruang. Selain itu, Anda juga dapat memformat nama file pengujian sesuai kebutuhan kerangka pengujian. Berikut ini adalah contoh dari penggunaan `CODEBUILD_CURRENT_SHARD_FILES` pada Linux dengan kerangka Django. Di sini `CODEBUILD_CURRENT_SHARD_FILES` digunakan untuk mendapatkan jalur berkas *notasi titik* didukung oleh Django:

```
codebuild-tests-run \
    —files-search "codebuild-glob-search '/tests/test_.py'" \
    —test-command 'python3 manage.py test $(echo "$CODEBUILD_CURRENT_SHARD_FILES" | sed -E "s/\//__/g; s/\.py$//; s/__/./g")' \
    —sharding-strategy 'equal-distribution'
```

**catatan**  
Perhatikan bahwa variabel `CODEBUILD_CURRENT_SHARD_FILES` lingkungan hanya dapat digunakan di dalam lingkup `codebuild-tests-run` CLI.  
Juga, jika Anda menggunakan `CODEBUILD_CURRENT_SHARD_FILES` di dalam test-command, masukkan `CODEBUILD_CURRENT_SHARD_FILES` tanda kutip ganda seperti yang ditunjukkan pada contoh di atas.