cdk watch - AWS Cloud Development Kit (AWS CDK) v2
PenggunaanPendapatOpsiContoh

Ini adalah Panduan Pengembang AWS CDK v2. CDKV1 yang lebih lama memasuki pemeliharaan pada 1 Juni 2022 dan mengakhiri dukungan pada 1 Juni 2023.

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

cdk watch

Terus perhatikan AWS CDK proyek lokal untuk perubahan untuk melakukan penerapan dan hotswap.

Perintah ini mirip dengancdk deploy, kecuali bahwa ia dapat melakukan penerapan terus menerus dan hotswaps melalui satu perintah.

Perintah ini adalah jalan pintas untukcdk deploy --watch.

Untuk mengakhiri cdk watch sesi, hentikan proses dengan menekanCtrl+C.

File yang diamati ditentukan oleh "watch" pengaturan dalam cdk.json file Anda. Ini memiliki dua sub-kunci, "include" dan"exclude", yang menerima string tunggal atau array string. Setiap entri ditafsirkan sebagai jalur relatif terhadap lokasi cdk.json file. Keduanya * ** dan diterima.

Jika Anda membuat proyek menggunakan cdk init perintah, perilaku default berikut dikonfigurasi untuk cdk watch dalam cdk.json file proyek Anda:

  • "include"diatur ke"**/*", yang mencakup semua file dan direktori di root proyek.

  • "exclude"bersifat opsional, kecuali untuk file dan folder yang sudah diabaikan secara default. Ini terdiri dari file dan direktori yang dimulai dengan., direktori CDK output, dan node_modules direktori.

Pengaturan minimal untuk mengkonfigurasi watch adalah"watch": {}.

Jika CDK kode atau kode aplikasi Anda memerlukan langkah pembuatan sebelum penerapan, cdk watch berfungsi dengan "build" kunci dalam cdk.json file.

catatan

Perintah ini dianggap eksperimental dan mungkin memiliki perubahan yang melanggar di masa depan.

Keterbatasan yang sama cdk deploy --hotswap berlaku untukcdk watch. Untuk informasi selengkapnya, lihat cdk deploy --hotswap.

Penggunaan

$ cdk watch <arguments> <options>

Pendapat

CDKID tumpukan

ID build CDK tumpukan dari aplikasi Anda untuk ditonton.

Tipe: String

Wajib: Tidak

Opsi

Untuk daftar opsi global yang berfungsi dengan semua CDK CLI perintah, lihatOpsi global.

--build-exclude, -E ARRAY

Jangan membangun kembali aset dengan ID yang diberikan.

Opsi ini dapat ditentukan beberapa kali dalam satu perintah.

Nilai default: []

--change-set-name STRING

Nama set CloudFormation perubahan yang akan dibuat.

--concurrency NUMBER

Terapkan dan hotswap beberapa tumpukan secara paralel sambil memperhitungkan dependensi antar-tumpukan. Gunakan opsi ini untuk mempercepat penerapan. Anda masih harus memperhitungkan CloudFormation dan membatasi Akun AWS tarif lainnya.

Berikan nomor untuk menentukan jumlah maksimum penerapan simultan (izin ketergantungan) untuk dilakukan.

Nilai default: 1

--exclusively, -e BOOLEAN

Hanya terapkan tumpukan yang diminta dan jangan sertakan dependensi.

--force, -f BOOLEAN

Selalu gunakan tumpukan, bahkan jika template identik.

Nilai default: false

--help, -h BOOLEAN

Tampilkan informasi referensi perintah untuk cdk watch perintah.

--hotswap BOOLEAN

Secara default, cdk watch gunakan penerapan hotswap bila memungkinkan untuk memperbarui sumber daya Anda. The CDK CLI akan mencoba melakukan penerapan hotswap dan tidak akan kembali ke CloudFormation penerapan penuh jika tidak berhasil. Setiap perubahan yang terdeteksi yang tidak dapat diperbarui melalui hotswap diabaikan.

Nilai default: true

--hotswap-fallback BOOLEAN

Secara default, cdk watch upaya untuk melakukan penerapan hotswap dan mengabaikan perubahan yang memerlukan penerapan. CloudFormation Berikan --hotswap-fallback untuk mundur dan melakukan penerapan penuh jika CloudFormation penerapan hotswap tidak berhasil.

--logs BOOLEAN

Secara default, cdk watch memantau semua grup CloudWatch log dalam aplikasi Anda dan mengalirkan peristiwa log secara lokal ke. stdout

Nilai default: true

--progress STRING

Konfigurasikan bagaimana CDK CLI menampilkan kemajuan penerapan.

  • bar— Tampilkan peristiwa penyebaran tumpukan sebagai bilah kemajuan, dengan peristiwa untuk sumber daya yang saat ini sedang digunakan.

  • events— Berikan riwayat lengkap, termasuk semua CloudFormation acara.

Anda juga dapat mengonfigurasi opsi ini di cdk.json file proyek atau ~/.cdk.json di mesin pengembangan lokal Anda:

{
   "progress": "events"
}

Nilai valid: bar, events

Nilai default: bar

--rollback BOOLEAN

Selama penerapan, jika sumber daya gagal dibuat atau diperbarui, penerapan akan kembali ke status stabil terbaru sebelum CDK CLI kembali. Semua perubahan yang dibuat sampai saat itu akan dibatalkan. Sumber daya yang dibuat akan dihapus dan pembaruan yang dibuat akan diputar kembali.

Gunakan --no-rollback atau -R untuk menonaktifkan perilaku ini. Jika sumber daya gagal dibuat atau diperbarui, CDK CLI akan meninggalkan perubahan yang dibuat sampai saat itu di tempat dan kembali. Ini mungkin membantu dalam lingkungan pengembangan di mana Anda melakukan iterasi dengan cepat.

catatan

Kapanfalse, penerapan yang menyebabkan penggantian sumber daya akan selalu gagal. Anda hanya dapat menggunakan nilai ini untuk penerapan yang memperbarui atau membuat sumber daya baru.

Nilai default: true

--toolkit-stack-name STRING

Nama tumpukan CDK Toolkit yang ada.

Secara default, cdk bootstrap menyebarkan tumpukan bernama CDKToolkit ke dalam AWS lingkungan yang ditentukan. Gunakan opsi ini untuk memberikan nama yang berbeda untuk tumpukan bootstrap Anda.

The CDK CLI menggunakan nilai ini untuk memverifikasi versi stack bootstrap Anda.

Contoh

Tonton CDK tumpukan dengan ID logis DevelopmentStack untuk perubahan

$ cdk watch DevelopmentStack
Detected change to 'lambda-code/index.js' (type: change). Triggering 'cdk deploy'
DevelopmentStack: deploying...

 ✅  DevelopmentStack

Konfigurasikan file cdk.json untuk apa yang harus disertakan dan dikecualikan agar tidak diawasi untuk perubahan

{
   "app": "mvn -e -q compile exec:java",
   "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
   }
}

Membangun CDK proyek menggunakan Java sebelum penerapan dengan mengonfigurasi file cdk.json

{
  "app": "mvn -e -q exec:java",
  "build": "mvn package",
  "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
  }
}