Ini adalah Panduan Pengembang AWS CDK v2. CDK v1 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. # AWS Referensi CDK CLI AWS Cloud Development Kit (AWS CDK) Command Line Interface (AWS CDK CLI), juga dikenal sebagai CDK Toolkit, adalah alat utama untuk berinteraksi dengan aplikasi CDK Anda. AWS Ini mengeksekusi aplikasi Anda, menginterogasi model aplikasi yang Anda tentukan, dan menghasilkan serta menerapkan AWS CloudFormation template yang dihasilkan oleh CDK. AWS Ini juga menyediakan fitur lain yang berguna untuk membuat dan bekerja dengan proyek AWS CDK. Topik ini berisi informasi tentang kasus penggunaan umum CDK CLI. CDK CLI diinstal dengan Node Package Manager. Dalam kebanyakan kasus, kami sarankan untuk menginstalnya secara global. ``` npm install -g aws-cdk # install latest version npm install -g aws-cdk@X.YY.Z # install specific version ``` **Tip** Jika Anda secara teratur bekerja dengan beberapa versi AWS CDK, pertimbangkan untuk menginstal versi CLI CDK yang cocok dalam proyek CDK individual. Untuk melakukan ini, hilangkan `-g` dari `npm install` perintah. Kemudian gunakan `npx aws-cdk` untuk memanggilnya. Ini menjalankan versi lokal jika ada, kembali ke versi global jika tidak. ## Perintah CDK CLI Semua perintah CDK CLI dimulai `cdk` dengan, yang diikuti oleh subperintah `list` (`synthesize`,,`deploy`, dll.). Beberapa subperintah memiliki versi yang lebih pendek (`ls`,`synth`, dll.) yang setara. Opsi dan argumen mengikuti subperintah dalam urutan apa pun. Untuk deskripsi semua subperintah, opsi, dan argumen, lihat Referensi perintah [AWS CDK CLI](ref-cli-cmd.md). ## Tentukan opsi dan nilainya Opsi baris perintah dimulai dengan dua tanda hubung ()`--`. Beberapa opsi yang sering digunakan memiliki sinonim satu huruf yang dimulai dengan tanda hubung tunggal (misalnya, `--app` memiliki sinonim). `-a` Urutan opsi dalam perintah CDK CLI tidak penting. Semua opsi menerima nilai, yang harus mengikuti nama opsi. Nilai dapat dipisahkan dari nama dengan spasi putih atau dengan tanda `=` sama dengan. Dua opsi berikut ini setara. ``` --toolkit-stack-name MyBootstrapStack --toolkit-stack-name=MyBootstrapStack ``` Beberapa opsi adalah bendera (Booleans). Anda dapat menentukan `true` atau `false` sebagai nilainya. Jika Anda tidak memberikan nilai, nilainya dianggap`true`. Anda juga dapat mengawali nama opsi dengan `no-` menyiratkan`false`. ``` # sets staging flag to true --staging --staging=true --staging true # sets staging flag to false --no-staging --staging=false --staging false ``` Beberapa opsi, yaitu`--context`,`--parameters`,`--plugin`,`--tags`, dan`--trust`, dapat ditentukan lebih dari sekali untuk menentukan beberapa nilai. Ini dicatat sebagai `[array]` tipe dalam bantuan CDK CLI. Contoh: ``` cdk bootstrap --tags costCenter=0123 --tags responsibleParty=jdoe ``` ## Bantuan bawaan CDK CLI memiliki bantuan terintegrasi. Anda dapat melihat bantuan umum tentang utilitas dan daftar subperintah yang disediakan dengan mengeluarkan: ``` cdk --help ``` Untuk melihat bantuan untuk subperintah tertentu, misalnya`deploy`, tentukan sebelum `--help` bendera. ``` cdk deploy --help ``` Masalah `cdk version` untuk menampilkan versi CDK CLI. Berikan informasi ini saat meminta dukungan. ## Pelaporan versi Untuk mendapatkan wawasan tentang bagaimana AWS CDK digunakan, konstruksi yang digunakan oleh aplikasi AWS CDK dikumpulkan dan dilaporkan dengan menggunakan sumber daya yang diidentifikasi sebagai. ` AWS::CDK::Metadata` Untuk mempelajari lebih lanjut, lihat [Mengonfigurasi pelaporan data penggunaan AWS CDK](usage-data.md). ## Otentikasi dengan AWS Ada berbagai cara di mana Anda dapat mengonfigurasi akses terprogram ke AWS sumber daya, tergantung pada lingkungan dan AWS akses yang tersedia untuk Anda. Untuk memilih metode otentikasi Anda dan mengonfigurasinya untuk CDK CLI, lihat [Mengkonfigurasi kredensil keamanan](configure-access.md) untuk CDK CLI. AWS Pendekatan yang direkomendasikan untuk pengguna baru yang berkembang secara lokal, yang tidak diberikan metode otentikasi oleh majikan mereka, adalah dengan mendirikan AWS IAM Identity Center. Metode ini termasuk menginstal AWS CLI untuk kemudahan konfigurasi dan untuk masuk secara teratur ke portal AWS akses. Jika Anda memilih metode ini, lingkungan Anda harus berisi elemen-elemen berikut setelah Anda menyelesaikan prosedur untuk [autentikasi IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) di * AWS SDKs dan Panduan Referensi Alat*: + AWS CLI, yang Anda gunakan untuk memulai sesi portal AWS akses sebelum Anda menjalankan aplikasi Anda. + [File AWS konfigurasi bersama](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) yang memiliki `[default]` profil dengan serangkaian nilai konfigurasi yang dapat direferensikan dari CDK AWS . Untuk menemukan lokasi file ini, lihat [Lokasi file bersama di](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Panduan Referensi Alat AWS SDKs dan*. + `config`File bersama menetapkan pengaturan [wilayah](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html). Ini menetapkan AWS Wilayah default yang digunakan AWS CDK dan CDK CLI untuk permintaan. AWS + CDK CLI menggunakan konfigurasi [penyedia token SSO profil untuk memperoleh kredensil](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) sebelum mengirim permintaan ke. AWS`sso_role_name`Nilai, yang merupakan peran IAM yang terhubung ke set izin Pusat Identitas IAM, harus memungkinkan akses ke AWS layanan yang digunakan dalam aplikasi Anda. `config`File contoh berikut menunjukkan profil default yang diatur dengan konfigurasi penyedia token SSO. `sso_session`Pengaturan profil mengacu pada [`sso-session`bagian](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#section-session) bernama. `sso-session`Bagian ini berisi pengaturan untuk memulai sesi portal AWS akses. ``` [default] sso_session = sso_account_id = <111122223333> sso_role_name = region = output = [sso-session ] sso_region = sso_start_url = sso_registration_scopes = sso:account:access ``` ### Memulai sesi portal AWS akses Sebelum mengakses AWS layanan, Anda memerlukan sesi portal AWS akses aktif agar CDK CLI menggunakan autentikasi Pusat Identitas IAM untuk menyelesaikan kredensil. Bergantung pada panjang sesi yang dikonfigurasi, akses Anda pada akhirnya akan kedaluwarsa dan CLI CDK akan mengalami kesalahan otentikasi. Jalankan perintah berikut di AWS CLI untuk masuk ke portal AWS akses. ``` aws sso login ``` Jika konfigurasi penyedia token SSO Anda menggunakan profil bernama alih-alih profil default, perintahnya adalah`aws sso login --profile `. Tentukan juga profil ini saat mengeluarkan `cdk` perintah menggunakan `--profile` opsi atau variabel `AWS_PROFILE` lingkungan. Untuk menguji apakah Anda sudah memiliki sesi aktif, jalankan perintah AWS CLI berikut. ``` aws sts get-caller-identity ``` Respons terhadap perintah ini harus melaporkan akun IAM Identity Center dan set izin yang dikonfigurasi dalam `config` file bersama. **catatan** Jika Anda sudah memiliki sesi portal AWS akses aktif dan menjalankannya`aws sso login`, Anda tidak akan diminta untuk memberikan kredensil. Proses masuk dapat meminta Anda untuk mengizinkan akses AWS CLI ke data Anda. Karena AWS CLI dibangun di atas SDK untuk Python, pesan izin mungkin berisi variasi nama. `botocore` ## Tentukan Wilayah dan konfigurasi lainnya CDK CLI perlu mengetahui Wilayah AWS yang Anda gunakan dan cara mengautentikasi. AWS Ini diperlukan untuk operasi penerapan dan untuk mengambil nilai konteks selama sintesis. Bersama-sama, akun dan Wilayah Anda membentuk *lingkungan*. Wilayah dapat ditentukan menggunakan variabel lingkungan atau dalam file konfigurasi. Ini adalah variabel dan file yang sama yang digunakan oleh AWS alat lain seperti AWS CLI dan berbagai. AWS SDKs CDK CLI mencari informasi ini dalam urutan sebagai berikut. + Variabel `AWS_DEFAULT_REGION` lingkungan. + Profil bernama didefinisikan dalam AWS `config` file standar dan ditentukan menggunakan `--profile` opsi pada `cdk` perintah. + `[default]`Bagian dari AWS `config` file standar. Selain menentukan AWS otentikasi dan Wilayah di `[default]` bagian, Anda juga dapat menambahkan satu atau beberapa `[profile ]` bagian, di `` mana nama profil. Untuk informasi selengkapnya tentang profil bernama, lihat [File konfigurasi dan kredensial bersama](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) di Panduan Referensi *Alat AWS SDKs dan Alat*. AWS `config`File standar terletak di `~/.aws/config` (MacOS/Linux) atau `%USERPROFILE%\.aws\config` (Windows). Untuk detail dan lokasi alternatif, lihat [Lokasi file konfigurasi dan kredensil bersama di Panduan Referensi](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) Alat * AWS SDKs dan* Lingkungan yang Anda tentukan di aplikasi AWS CDK menggunakan `env` properti stack digunakan selama sintesis. Ini digunakan untuk menghasilkan AWS CloudFormation template khusus lingkungan, dan selama penerapan, itu mengganti akun atau Wilayah yang ditentukan oleh salah satu metode sebelumnya. Untuk informasi selengkapnya, lihat [Lingkungan untuk AWS CDK](environments.md). **catatan** AWS CDK menggunakan kredensil dari file sumber yang sama dengan AWS alat lain dan SDKs, termasuk Antarmuka Baris [AWS Perintah](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). Namun, AWS CDK mungkin berperilaku agak berbeda dari alat ini. Ini menggunakan AWS SDK untuk JavaScript di bawah tenda. [Untuk detail selengkapnya tentang menyiapkan kredensil untuk AWS SDK, lihat Menyetel JavaScript kredensial.](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-credentials.html) Anda dapat secara opsional menggunakan opsi `--role-arn` (atau`-r`) untuk menentukan ARN peran IAM yang harus digunakan untuk penerapan. Peran ini harus diasumsikan oleh AWS akun yang digunakan. ## Tentukan perintah aplikasi Banyak fitur CDK CLI memerlukan satu atau AWS CloudFormation lebih template disintesis, yang pada gilirannya memerlukan menjalankan aplikasi Anda. AWS CDK mendukung program yang ditulis dalam berbagai bahasa. Oleh karena itu, ia menggunakan opsi konfigurasi untuk menentukan perintah yang tepat yang diperlukan untuk menjalankan aplikasi Anda. Opsi ini dapat ditentukan dalam dua cara. Pertama, dan paling umum, dapat ditentukan menggunakan `app` kunci di dalam file`cdk.json`. Ini ada di direktori utama proyek AWS CDK Anda. CDK CLI menyediakan perintah yang sesuai saat membuat proyek baru dengan. `cdk init` Berikut adalah `cdk.json` dari TypeScript proyek baru, misalnya. ``` { "app": "npx ts-node bin/hello-cdk.ts" } ``` CDK CLI `cdk.json` mencari di direktori kerja saat ini saat mencoba menjalankan aplikasi Anda. Karena itu, Anda mungkin membiarkan shell tetap terbuka di direktori utama proyek Anda untuk mengeluarkan perintah CDK CLI. CDK CLI juga mencari kunci aplikasi `~/.cdk.json` di (yaitu, di direktori home Anda) jika tidak dapat menemukannya. `./cdk.json` Menambahkan perintah aplikasi di sini dapat berguna jika Anda biasanya bekerja dengan kode CDK dalam bahasa yang sama. Jika Anda berada di beberapa direktori lain, atau menjalankan aplikasi Anda menggunakan perintah selain yang ada di`cdk.json`, gunakan opsi `--app` (atau`-a`) untuk menentukannya. ``` cdk --app "npx ts-node bin/hello-cdk.ts" ls ``` Saat menerapkan, Anda juga dapat menentukan direktori yang berisi rakitan cloud yang disintesis, seperti`cdk.out`, sebagai nilai. `--app` Tumpukan yang ditentukan digunakan dari direktori ini; aplikasi tidak disintesis. ## Tentukan tumpukan Banyak perintah CDK CLI (misalnya`cdk deploy`,) bekerja pada tumpukan yang ditentukan di aplikasi Anda. Jika aplikasi Anda hanya berisi satu tumpukan, CDK CLI mengasumsikan yang Anda maksud jika Anda tidak menentukan tumpukan secara eksplisit. Jika tidak, Anda harus menentukan tumpukan atau tumpukan yang ingin Anda gunakan. Anda dapat melakukan ini dengan menentukan tumpukan yang diinginkan berdasarkan ID satu per satu pada baris perintah. Ingat bahwa ID adalah nilai yang ditentukan oleh argumen kedua ketika Anda membuat instance tumpukan. ``` cdk synth PipelineStack LambdaStack ``` Anda juga dapat menggunakan wildcard untuk menentukan IDs yang cocok dengan pola. + `?`cocok dengan karakter tunggal + `*`cocok dengan sejumlah karakter (`*`sendiri cocok dengan semua tumpukan) + `**`cocok dengan segala sesuatu dalam hierarki Anda juga dapat menggunakan `--all` opsi untuk menentukan semua tumpukan. Jika aplikasi Anda menggunakan [CDK Pipelines, CDK](cdk-pipeline.md) CLI memahami tumpukan dan tahapan Anda sebagai hierarki. Selain itu, `--all` opsi dan `*` wildcard hanya cocok dengan tumpukan tingkat atas. Untuk mencocokkan semua tumpukan, gunakan`**`. Juga gunakan `**` untuk menunjukkan semua tumpukan di bawah hierarki tertentu. Saat menggunakan wildcard, lampirkan pola dalam tanda kutip, atau lepaskan wildcard dengan. `\` Jika tidak, shell Anda mungkin mencoba memperluas pola ke nama-nama file di direktori saat ini. Paling-paling, ini tidak akan melakukan apa yang Anda harapkan; paling buruk, Anda bisa menggunakan tumpukan yang tidak Anda inginkan. Ini tidak sepenuhnya diperlukan di Windows karena `cmd.exe` tidak memperluas wildcard, tetapi tetap merupakan praktik yang baik. ``` cdk synth "*Stack" # PipelineStack, LambdaStack, etc. cdk synth 'Stack?' # StackA, StackB, Stack1, etc. cdk synth \* # All stacks in the app, or all top-level stacks in a CDK Pipelines app cdk synth '**' # All stacks in a CDK Pipelines app cdk synth 'PipelineStack/Prod/**' # All stacks in Prod stage in a CDK Pipelines app ``` **catatan** Urutan di mana Anda menentukan tumpukan belum tentu urutan di mana mereka akan diproses. CDK CLI memperhitungkan dependensi antar tumpukan saat memutuskan urutan untuk memprosesnya. Sebagai contoh, katakanlah satu tumpukan menggunakan nilai yang dihasilkan oleh yang lain (seperti ARN dari sumber daya yang didefinisikan dalam tumpukan kedua). Dalam hal ini, tumpukan kedua disintesis sebelum yang pertama karena ketergantungan ini. Anda dapat menambahkan dependensi antar tumpukan secara manual menggunakan metode tumpukan. ` [addDependency()](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.Stack.html#addwbrdependencytarget-reason) ` ## Bootstrap AWS lingkungan Anda Menyebarkan tumpukan dengan CDK memerlukan sumber daya CDK khusus khusus untuk AWS disediakan. `cdk bootstrap`Perintah menciptakan sumber daya yang diperlukan untuk Anda. Anda hanya perlu bootstrap jika Anda menerapkan tumpukan yang membutuhkan sumber daya khusus ini. Lihat [AWS bootstrapping CDK](bootstrapping.md) untuk detailnya. ``` cdk bootstrap ``` Jika dikeluarkan tanpa argumen, seperti yang ditunjukkan di sini, `cdk bootstrap` perintah mensintesis aplikasi saat ini dan bootstrap lingkungan tempat tumpukannya akan digunakan. Jika aplikasi berisi tumpukan agnostik lingkungan, yang tidak secara eksplisit menentukan lingkungan, akun default dan Wilayah akan di-bootstrap, atau lingkungan yang ditentukan menggunakan. `--profile` Di luar aplikasi, Anda harus secara eksplisit menentukan lingkungan yang akan di-bootstrap. Anda juga dapat melakukannya untuk mem-bootstrap lingkungan yang tidak ditentukan dalam aplikasi atau AWS profil lokal Anda. Kredensil harus dikonfigurasi (misalnya dalam`~/.aws/credentials`) untuk akun dan Wilayah yang ditentukan. Anda dapat menentukan profil yang berisi kredensil yang diperlukan. ``` cdk bootstrap / # e.g. cdk bootstrap 1111111111/us-east-1 cdk bootstrap --profile test 1111111111/us-east-1 ``` **penting** Setiap lingkungan (kombinasi akun/wilayah) tempat Anda menerapkan tumpukan semacam itu harus di-bootstrap secara terpisah. Anda mungkin dikenakan AWS biaya untuk apa yang disimpan AWS CDK di sumber daya yang di-bootstrap. Selain itu, jika Anda menggunakan`--bootstrap-customer-key`, kunci AWS KMS akan dibuat, yang juga dikenakan biaya per lingkungan. **catatan** Versi sebelumnya dari template bootstrap membuat kunci KMS secara default. Untuk menghindari biaya, re-bootstrap menggunakan`--no-bootstrap-customer-key`. **catatan** CDK CLI v2 tidak mendukung template bootstrap asli, dijuluki template lama, digunakan secara default dengan CDK v1. **penting** Template bootstrap modern secara efektif memberikan izin yang tersirat oleh `--cloudformation-execution-policies` ke AWS akun mana pun dalam daftar. `--trust` Secara default, ini memperluas izin untuk membaca dan menulis ke sumber daya apa pun di akun bootstrap. Pastikan untuk [mengonfigurasi tumpukan bootstrap](bootstrapping-customizing.md) dengan kebijakan dan akun tepercaya yang nyaman bagi Anda. ## Buat aplikasi baru Untuk membuat aplikasi baru, buat direktori untuknya, lalu, di dalam direktori, keluarkan`cdk init`. ``` mkdir my-cdk-app cd my-cdk-app cdk init