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

# CLI DLT
<a name="dlt-cli"></a>

CLI DLT memungkinkan Anda berinteraksi dengan Pengujian Beban Terdistribusi pada AWS REST API langsung dari terminal Anda. Ini memungkinkan otomatisasi skrip pengujian beban, memungkinkan Anda untuk membuat daftar, memeriksa, dan memulai skenario pengujian dan hasil kueri yang dijalankan sebagai bagian dari alur kerja yang dapat diulang.

CLI menargetkan IAM-authorized API Gateway yang sama dengan konsol web DLT, sehingga operasi apa pun yang tersedia di antarmuka berbasis browser juga dapat dilakukan dari baris perintah menggunakan API dasar dan model izin yang sama.

Kode sumber CLI dan dokumentasi lengkap ada di GitHub repositori solusi di bawah direktori. `source/cli` Untuk menemukannya, navigasikan ke [Pengujian Beban Terdistribusi di repositori AWS](https://github.com/aws-solutions/distributed-load-testing-on-aws) dan buka. `source/cli` `README.md`Dalam direktori itu adalah referensi otoritatif untuk instalasi, konfigurasi, otentikasi, dan referensi perintah lengkap.

## Kemampuan kunci
<a name="dlt-cli-capabilities"></a>


| Grup perintah | Deskripsi | 
| --- | --- | 
|  `configure`  | Konfigurasikan CLI dengan pengaturan tumpukan DLT Anda, baik secara interaktif atau dengan mengimpor file. `aws-exports.json` | 
|  `login`  | Otentikasi dengan layanan DLT dan dapatkan kredensional yang diperlukan untuk memanggil API. | 
|  `logout`  | Hapus kredensi yang tersimpan dari mesin lokal. | 
|  `token`  | Memeriksa dan mengeluarkan token otentikasi dan status kedaluwarsa kredenal. | 
|  `scenarios`  | Daftar, lihat detail, dan mulai (jalankan kembali) skenario pengujian yang ada. | 
|  `runs`  | Kueri hasil uji coba, lihat detail run, bandingkan dengan baseline, dan unduh artefak run. | 

CLI mendukung tiga mode otentikasi: login berbasis browser (aliran PKCE melalui Cognito Hosted UI), otentikasi SRP (Secure Remote Password) tanpa kepala, dan otentikasi kredensi IAM langsung. Untuk detail pengaturan lengkap pada setiap mode, lihat `README.md` di `source/cli` direktori [GitHub repositori](https://github.com/aws-solutions/distributed-load-testing-on-aws).

## Instalasi dan referensi terperinci
<a name="dlt-cli-reference"></a>

CLI didistribusikan sebagai Node.js bundel portabel yang dapat dijalankan secara langsung, atau Anda dapat membangunnya dari sumber menggunakan repositori. Untuk memulai, navigasikan ke [Pengujian Beban Terdistribusi di repositori AWS](https://github.com/aws-solutions/distributed-load-testing-on-aws) GitHub dan buka direktori. `source/cli` `README.md`File dalam direktori tersebut berisi:
+ Petunjuk pemasangan (bundel portabel dan build-from-source)
+ Konfigurasi dan pengaturan otentikasi untuk ketiga mode autentikasi
+ Referensi perintah lengkap dengan contoh penggunaan

## Quick start
<a name="dlt-cli-quick-start"></a>

**catatan**  
Mulai cepat ini mengasumsikan tumpukan DLT sudah digunakan.

### Opsi 1: Bundel portabel (disarankan)
<a name="option-1-portable-bundle-recommended"></a>

Cara tercepat untuk memulai adalah bundel portabel. Ini tidak memerlukan kloning repositori atau langkah pembuatan apa pun:

```
# Download the portable bundle
curl -sLo /usr/local/bin/dlt \
  https://raw.githubusercontent.com/aws-solutions/distributed-load-testing-on-aws/main/deployment/cli/dlt-cli.mjs

# Make it executable
chmod +x /usr/local/bin/dlt

# Point the CLI at your deployed DLT stack
dlt configure

# Authenticate with the DLT service
dlt login

# Run a command (for example, list test scenarios)
dlt scenarios list
```

### Opsi 2: Bangun dari sumber
<a name="option-2-build-from-source"></a>

Jika Anda lebih suka membangun dari sumber, kloning [repositori](https://github.com/aws-solutions/distributed-load-testing-on-aws) terlebih dahulu. Proyek ini menggunakan ruang kerja npm, jadi jalankan perintah berikut dari root repositori:

```
# Install all workspace dependencies
npm install

# Build the CLI
npm run build -w source/cli

# Link the dlt command into your PATH
npm link -w source/cli

# Point the CLI at your deployed DLT stack
dlt configure

# Authenticate with the DLT service
dlt login

# Run a command (for example, list test scenarios)
dlt scenarios list
```