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 output CDK, dan direktori.node_modules
Pengaturan minimal untuk mengkonfigurasi watch
adalah"watch": {}
.
Jika kode CDK atau kode aplikasi Anda memerlukan langkah pembuatan sebelum penerapan, cdk watch
berfungsi dengan "build"
kunci dalam file. cdk.json
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
- ID logis tumpukan CDK
-
ID logis tumpukan CDK dari aplikasi Anda untuk ditonton.
Tipe: String
Wajib: Tidak
Opsi
Untuk daftar opsi global yang berfungsi dengan semua CLI perintah CDK, 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. CDK CLI akan mencoba melakukan penyebaran 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 CLI CDK kembali. Semua perubahan yang dibuat sampai saat itu akan dibatalkan. Sumber daya yang dibuat akan dihapus dan pembaruan yang dibuat akan dibatalkan.
Gunakan
--no-rollback
atau-R
untuk menonaktifkan perilaku ini. Jika sumber daya gagal dibuat atau diperbarui, CDK CLI akan meninggalkan perubahan yang dibuat hingga saat itu dan kembali. Ini mungkin membantu dalam lingkungan pengembangan di mana Anda melakukan iterasi dengan cepat.catatan
Kapan
false
, 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.
Opsi ini hanya digunakan untuk aplikasi CDK yang menggunakan sintesis lama.
Contoh
Tonton tumpukan CDK 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/*" } }
Buat proyek CDK menggunakan Java sebelum penerapan dengan mengonfigurasi file cdk.json
{ "app": "mvn -e -q exec:java", "build": "mvn package", "watch": { "include": "src/main/**", "exclude": "target/*" } }