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 CDK Toolkit (cdkperintah)

AWS CDK Toolkit, cdk perintah CLI, adalah alat utama untuk berinteraksi dengan aplikasi Anda. AWS CDK Ini mengeksekusi aplikasi Anda, menginterogasi model aplikasi yang Anda tentukan, dan menghasilkan serta menerapkan AWS CloudFormation template yang dihasilkan oleh. AWS CDK Ini juga menyediakan fitur lain yang berguna untuk membuat dan bekerja dengan AWS CDK proyek. Topik ini berisi informasi tentang kasus penggunaan umum CDK Toolkit.

AWS CDK Toolkit 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

Perintah Toolkit

Semua perintah CDK Toolkit dimulai dengancdk, yang diikuti oleh subperintah (list,, synthesizedeploy, 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, lihatAWS CDKCLIreferensi perintah.

Menentukan 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 AWS CDK Toolkit 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 dianggaptrue. Anda juga dapat mengawali nama opsi dengan no- menyiratkanfalse.

# 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 Toolkit. Sebagai contoh:

cdk bootstrap --tags costCenter=0123 --tags responsibleParty=jdoe

Bantuan bawaan

AWS CDK Toolkit 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, misalnyadeploy, tentukan sebelum --help bendera.

cdk deploy --help

Masalah cdk version untuk menampilkan versi AWS CDK Toolkit. Berikan informasi ini saat meminta dukungan.

Pelaporan versi

Untuk mendapatkan wawasan tentang bagaimana AWS CDK digunakan, konstruksi yang digunakan oleh AWS CDK aplikasi dikumpulkan dan dilaporkan dengan menggunakan sumber daya yang diidentifikasi sebagaiAWS::CDK::Metadata. Sumber daya ini ditambahkan ke AWS CloudFormation templat, dan dapat dengan mudah ditinjau. Informasi ini juga dapat digunakan oleh AWS untuk mengidentifikasi tumpukan menggunakan konstruksi dengan masalah keamanan atau keandalan yang diketahui. Ini juga dapat digunakan untuk menghubungi pengguna mereka dengan informasi penting.

Secara default, AWS CDK laporan penggunaan konstruksi dalam modul NPM berikut yang digunakan dalam tumpukan:

Sumber AWS::CDK::Metadata daya terlihat seperti berikut ini.

CDKMetadata:
  Type: "AWS::CDK::Metadata"
  Properties:
    Analytics: "v2:deflate64:H4sIAND9SGAAAzXKSw5AMBAA0L1b2PdzBYnEAdio3RglglY60zQi7u6TWL/XKmNUlxeQSOKwaPTBqrNhwEWU3hGHiCzK0dWWfAxoL/Fd8mvk+QkS/0X6BdjnCdgmOOQKWz+AqqLDt2Y3YMnLYWwAAAA="

AnalyticsProperti ini adalah daftar konstruksi yang di-gzip, dikodekan base64, dan dikodekan awalan di tumpukan.

Untuk memilih keluar dari pelaporan versi, gunakan salah satu metode berikut:

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 dan mengonfigurasinya untuk CDK Toolkit, lihat Autentikasi dan akses di Panduan Referensi AWS SDK dan Alat.

Pendekatan yang direkomendasikan untuk pengguna baru yang berkembang secara lokal, yang tidak diberi metode otentikasi oleh majikan mereka, adalah dengan mengatur. 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 di AWS SDK dan Tools Reference Guide:

Memulai sesi portal AWS akses

Sebelum mengakses Layanan AWS, Anda memerlukan sesi portal AWS akses aktif untuk CDK Toolkit untuk menggunakan autentikasi IAM Identity Center untuk menyelesaikan kredensil. Bergantung pada panjang sesi yang dikonfigurasi, akses Anda pada akhirnya akan kedaluwarsa dan CDK Toolkit 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 adalahaws sso login --profile NAME. Juga tentukan profil ini saat mengeluarkan cdk perintah menggunakan --profile opsi atau variabel AWS_PROFILE lingkungan.

Untuk menguji apakah Anda sudah memiliki sesi aktif, jalankan AWS CLI perintah 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.

Menentukan Wilayah dan konfigurasi lainnya

CDK Toolkit perlu mengetahui AWS Wilayah 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 SDK. CDK Toolkit mencari informasi ini dalam urutan berikut.

Selain menentukan AWS otentikasi dan Wilayah di [default] bagian, Anda juga dapat menambahkan satu atau beberapa [profile NAME] bagian, di mana NAME adalah nama profil. Untuk informasi selengkapnya tentang profil bernama, lihat File konfigurasi dan kredensial bersama di Panduan Referensi AWS SDK dan Alat.

AWS configFile standar terletak di ~/.aws/config (MacOS/Linux) atau %USERPROFILE%\.aws\config (Windows). Untuk detail dan lokasi alternatif, lihat Lokasi file konfigurasi dan kredensional bersama di Panduan Referensi AWS SDK dan Alat

Lingkungan yang Anda tentukan dalam AWS CDK aplikasi 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.

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.

Menentukan perintah aplikasi

Banyak fitur CDK Toolkit memerlukan satu atau lebih AWS CloudFormation template disintesis, yang pada gilirannya memerlukan menjalankan aplikasi Anda. Program AWS CDK pendukung 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 filecdk.json. Ini ada di direktori utama AWS CDK proyek Anda. CDK Toolkit 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 Toolkit mencari cdk.json di direktori kerja saat ini ketika mencoba menjalankan aplikasi Anda. Karena itu, Anda mungkin membiarkan shell tetap terbuka di direktori utama proyek Anda untuk mengeluarkan perintah CDK Toolkit.

CDK Toolkit juga mencari kunci aplikasi di ~/.cdk.json (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 dicdk.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, seperticdk.out, sebagai nilai. --app Tumpukan yang ditentukan digunakan dari direktori ini; aplikasi tidak disintesis.

Menentukan tumpukan

Banyak perintah CDK Toolkit (misalnya,cdk deploy) berfungsi pada tumpukan yang ditentukan dalam aplikasi Anda. Jika aplikasi Anda hanya berisi satu tumpukan, CDK Toolkit mengasumsikan yang Anda maksud jika Anda tidak menentukan tumpukan secara eksplisit.

Jika tidak, Anda harus menentukan tumpukan atau tumpukan yang ingin Anda kerjakan. 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 ID yang cocok dengan pola.

Anda juga dapat menggunakan --all opsi untuk menentukan semua tumpukan.

Jika aplikasi Anda menggunakan CDK Pipelines, CDK Toolkit 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

Bootstrapping lingkungan Anda AWS

Menyebarkan tumpukan dengan CDK memerlukan AWS CDK sumber daya khusus khusus untuk disediakan. cdk bootstrapPerintah menciptakan sumber daya yang diperlukan untuk Anda. Anda hanya perlu bootstrap jika Anda menerapkan tumpukan yang membutuhkan sumber daya khusus ini. Lihat Bootstrapping untuk detail.

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 ACCOUNT-NUMBER/REGION # e.g.
cdk bootstrap 1111111111/us-east-1
cdk bootstrap --profile test 1111111111/us-east-1

Anda mungkin dikenakan AWS biaya untuk apa yang AWS CDK disimpan di sumber daya bootstrap. Selain itu, jika Anda menggunakan-bootstrap-customer-key, kunci AWS KMS akan dibuat, yang juga dikenakan biaya per lingkungan.

Membuat aplikasi baru

Untuk membuat aplikasi baru, buat direktori untuknya, lalu, di dalam direktori, keluarkancdk init.

mkdir my-cdk-app
cd my-cdk-app
cdk init TEMPLATE --language LANGUAGE

Bahasa yang didukung (BAHASA) adalah:

TEMPLATE adalah template opsional. Jika template yang diinginkan adalah aplikasi, default, Anda dapat menghilangkannya. Template yang tersedia adalah:

Template menggunakan nama folder project untuk menghasilkan nama file dan class di dalam aplikasi baru Anda.

Daftar tumpukan

Untuk melihat daftar ID tumpukan di AWS CDK aplikasi Anda, masukkan salah satu perintah setara berikut:

cdk list
cdk ls

Jika aplikasi Anda berisi tumpukan CDK Pipelines, CDK Toolkit menampilkan nama tumpukan sebagai jalur sesuai dengan lokasinya dalam hierarki pipeline. (Misalnya,PipelineStack,PipelineStack/Prod, danPipelineStack/Prod/MyService.)

Jika aplikasi berisi banyak tumpukan, Anda dapat menentukan ID tumpukan penuh atau sebagian dari tumpukan yang akan dicantumkan. Untuk informasi selengkapnya, lihat Menentukan tumpukan.

Tambahkan --long bendera untuk melihat informasi lebih lanjut tentang tumpukan, termasuk nama tumpukan dan lingkungannya (AWS akun dan Wilayah).

Sintesis tumpukan

cdk synthesizePerintah (hampir selalu disingkatsynth) mensintesis tumpukan yang ditentukan dalam aplikasi Anda ke dalam template. CloudFormation

cdk synth         # if app contains only one stack
cdk synth MyStack
cdk synth Stack1 Stack2
cdk synth "*"     # all stacks in app

Lihat cdk synth --help untuk semua opsi yang tersedia. Beberapa opsi yang paling sering digunakan tercakup dalam bagian berikut.

Menentukan nilai konteks

Gunakan -c opsi --context or untuk meneruskan nilai konteks runtime ke aplikasi CDK Anda.

# specify a single context value
cdk synth --context key=value MyStack

# specify multiple context values (any number)
cdk synth --context key1=value1 --context key2=value2 MyStack

Saat menerapkan beberapa tumpukan, nilai konteks yang ditentukan biasanya diteruskan ke semuanya. Jika mau, Anda dapat menentukan nilai yang berbeda untuk setiap tumpukan dengan mengawali nama tumpukan ke nilai konteks.

# different context values for each stack
cdk synth --context Stack1:key=value Stack2:key=value Stack1 Stack2

Menentukan format tampilan

Secara default, template yang disintesis ditampilkan dalam format YAMG. Tambahkan --json bendera untuk menampilkannya dalam format JSON sebagai gantinya.

cdk synth --json MyStack

Menentukan direktori output

Tambahkan opsi --output (-o) untuk menulis template yang disintesis ke direktori selaincdk.out.

cdk synth --output=~/templates

Menyebarkan tumpukan

cdk deploySubperintah menyebarkan satu atau beberapa tumpukan tertentu ke akun Anda. AWS

cdk deploy        # if app contains only one stack
cdk deploy MyStack
cdk deploy Stack1 Stack2
cdk deploy "*"    # all stacks in app

Lihat cdk deploy --help untuk semua opsi yang tersedia. Beberapa opsi yang paling berguna tercakup dalam bagian berikut.

Melewatkan sintesis

cdk deployPerintah biasanya mensintesis tumpukan aplikasi Anda sebelum menerapkan untuk memastikan bahwa penerapan mencerminkan versi terbaru aplikasi Anda. Jika Anda tahu bahwa Anda belum mengubah kode sejak terakhircdk synth, Anda dapat menekan langkah sintesis yang berlebihan saat menerapkan. Untuk melakukannya, tentukan cdk.out direktori proyek Anda di --app opsi.

cdk deploy --app cdk.out StackOne StackTwo

Menonaktifkan rollback

AWS CloudFormation memiliki kemampuan untuk memutar kembali perubahan sehingga penerapan bersifat atomik. Ini berarti bahwa mereka berhasil atau gagal secara keseluruhan. AWS CDK Mewarisi kemampuan ini karena mensintesis dan menyebarkan AWS CloudFormation template.

Rollback memastikan bahwa sumber daya Anda berada dalam keadaan konsisten setiap saat, yang sangat penting untuk tumpukan produksi. Namun, saat Anda masih mengembangkan infrastruktur, beberapa kegagalan tidak dapat dihindari, dan mengembalikan penerapan yang gagal dapat memperlambat Anda.

Untuk alasan ini, CDK Toolkit memungkinkan Anda menonaktifkan rollback dengan menambahkan --no-rollback ke perintah Anda. cdk deploy Dengan flag ini, penerapan yang gagal tidak dibatalkan. Sebagai gantinya, sumber daya yang digunakan sebelum sumber daya yang gagal tetap ada, dan penerapan berikutnya dimulai dengan sumber daya yang gagal. Anda akan menghabiskan lebih sedikit waktu menunggu penerapan dan lebih banyak waktu mengembangkan infrastruktur Anda.

Bertukar-tukar panas

Gunakan --hotswap tanda dengan cdk deploy untuk mencoba memperbarui AWS sumber daya Anda secara langsung alih-alih membuat set AWS CloudFormation perubahan dan menerapkannya. Penerapan kembali ke AWS CloudFormation penerapan jika hot swapping tidak memungkinkan.

Saat ini hot swapping mendukung fungsi Lambda, mesin status Step Functions, dan image container Amazon ECS. --hotswapBendera juga menonaktifkan rollback (yaitu, menyiratkan). --no-rollback

Modus menonton

Mode tontonan CDK Toolkit (cdk deploy --watch, atau singkatnya) terus memantau file sumber dan aset aplikasi CDK Anda cdk watch untuk perubahan. Ini segera melakukan penyebaran tumpukan yang ditentukan ketika perubahan terdeteksi.

Secara default, penerapan ini menggunakan --hotswap flag, yang mempercepat penyebaran perubahan pada fungsi Lambda. Itu juga kembali ke penerapan AWS CloudFormation jika Anda telah mengubah konfigurasi infrastruktur. Agar cdk watch selalu melakukan AWS CloudFormation penerapan penuh, tambahkan --no-hotswap bendera ke. cdk watch

Setiap perubahan yang cdk watch dibuat saat sudah melakukan penerapan digabungkan menjadi satu penerapan, yang dimulai segera setelah penerapan yang sedang berlangsung selesai.

Mode menonton menggunakan "watch" kunci dalam proyek cdk.json untuk menentukan file mana yang akan dipantau. Secara default, file-file ini adalah file dan aset aplikasi Anda, tetapi ini dapat diubah dengan memodifikasi "include" dan "exclude" entri di "watch" kunci. cdk.jsonFile berikut menunjukkan contoh entri ini.

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

cdk watchmengeksekusi "build" perintah dari cdk.json untuk membangun aplikasi Anda sebelum sintesis. Jika penerapan Anda memerlukan perintah apa pun untuk membuat atau mengemas kode Lambda Anda (atau apa pun yang tidak ada di aplikasi CDK Anda), tambahkan di sini.

Wildcard bergaya Git, keduanya * dan**, dapat digunakan di tombol dan. "watch" "build" Setiap jalur ditafsirkan relatif terhadap direktori induk. cdk.json Nilai default include adalah**/*, yang berarti semua file dan direktori di direktori root proyek. excludeadalah opsional.

Menentukan parameter AWS CloudFormation

AWS CDK Toolkit mendukung menentukan AWS CloudFormation parameter pada penerapan. Anda dapat memberikan ini pada baris perintah mengikuti --parameters bendera.

cdk deploy MyStack --parameters uploadBucketName=UploadBucket

Untuk menentukan beberapa parameter, gunakan beberapa --parameters bendera.

cdk deploy MyStack --parameters uploadBucketName=UpBucket --parameters downloadBucketName=DownBucket

Jika Anda menerapkan beberapa tumpukan, Anda dapat menentukan nilai yang berbeda dari setiap parameter untuk setiap tumpukan. Untuk melakukannya, awali nama parameter dengan nama tumpukan dan titik dua. Jika tidak, nilai yang sama diteruskan ke semua tumpukan.

cdk deploy MyStack YourStack --parameters MyStack:uploadBucketName=UploadBucket --parameters YourStack:uploadBucketName=UpBucket

Secara default, AWS CDK mempertahankan nilai parameter dari penerapan sebelumnya dan menggunakannya dalam penerapan selanjutnya jika tidak ditentukan secara eksplisit. Gunakan --no-previous-parameters bendera untuk meminta semua parameter ditentukan.

Menentukan file output

Jika tumpukan Anda mendeklarasikan AWS CloudFormation output, ini biasanya ditampilkan di layar pada akhir penerapan. Untuk menulisnya ke file dalam format JSON, gunakan --outputs-file bendera.

cdk deploy --outputs-file outputs.json MyStack

Perubahan terkait keamanan

Untuk melindungi Anda dari perubahan yang tidak diinginkan yang memengaruhi postur keamanan Anda, AWS CDK Toolkit meminta Anda untuk menyetujui perubahan terkait keamanan sebelum menerapkannya. Anda dapat menentukan tingkat perubahan yang memerlukan persetujuan:

cdk deploy --require-approval LEVEL

LEVEL dapat menjadi salah satu dari berikut ini:

Pengaturan juga dapat dikonfigurasi dalam cdk.json file.

{
  "app": "...",
  "requireApproval": "never"
}

Membandingkan tumpukan

cdk diffPerintah membandingkan versi stack saat ini (dan dependensinya) yang ditentukan di aplikasi Anda dengan versi yang sudah di-deploy, atau dengan AWS CloudFormation template yang disimpan, dan menampilkan daftar perubahan.

Stack HelloCdkStack
IAM Statement Changes
┌───┬──────────────────────────────┬────────┬──────────────────────────────┬──────────────────────────────┬───────────┐
│   │ Resource                     │ Effect │ Action                       │ Principal                    │ Condition │
├───┼──────────────────────────────┼────────┼──────────────────────────────┼──────────────────────────────┼───────────┤
│ + │ ${Custom::S3AutoDeleteObject │ Allow  │ sts:AssumeRole               │ Service:lambda.amazonaws.com │           │
│   │ sCustomResourceProvider/Role │        │                              │                              │           │
│   │ .Arn}                        │        │                              │                              │           │
├───┼──────────────────────────────┼────────┼──────────────────────────────┼──────────────────────────────┼───────────┤
│ + │ ${MyFirstBucket.Arn}         │ Allow  │ s3:DeleteObject*             │ AWS:${Custom::S3AutoDeleteOb │           │
│   │ ${MyFirstBucket.Arn}/*       │        │ s3:GetBucket*                │ jectsCustomResourceProvider/ │           │
│   │                              │        │ s3:GetObject*                │ Role.Arn}                    │           │
│   │                              │        │ s3:List*                     │                              │           │
└───┴──────────────────────────────┴────────┴──────────────────────────────┴──────────────────────────────┴───────────┘
IAM Policy Changes
┌───┬────────────────────────────────────────────────────────┬────────────────────────────────────────────────────────┐
│   │ Resource                                               │ Managed Policy ARN                                     │
├───┼────────────────────────────────────────────────────────┼────────────────────────────────────────────────────────┤
│ + │ ${Custom::S3AutoDeleteObjectsCustomResourceProvider/Ro │ {"Fn::Sub":"arn:${AWS::Partition}:iam::aws:policy/serv │
│   │ le}                                                    │ ice-role/AWSLambdaBasicExecutionRole"}                 │
└───┴────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────┘
(NOTE: There may be security-related changes not in this list. See https://github.com/aws/aws-cdk/issues/1299)

Parameters
[+] Parameter AssetParameters/4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392/S3Bucket AssetParameters4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392S3BucketBF7A7F3F: {"Type":"String","Description":"S3 bucket for asset \"4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392\""}
[+] Parameter AssetParameters/4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392/S3VersionKey AssetParameters4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392S3VersionKeyFAF93626: {"Type":"String","Description":"S3 key for asset version \"4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392\""}
[+] Parameter AssetParameters/4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392/ArtifactHash AssetParameters4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392ArtifactHashE56CD69A: {"Type":"String","Description":"Artifact hash for asset \"4cd61014b71160e8c66fe167e43710d5ba068b80b134e9bd84508cf9238b2392\""}

Resources
[+] AWS::S3::BucketPolicy MyFirstBucket/Policy MyFirstBucketPolicy3243DEFD
[+] Custom::S3AutoDeleteObjects MyFirstBucket/AutoDeleteObjectsCustomResource MyFirstBucketAutoDeleteObjectsCustomResourceC52FCF6E
[+] AWS::IAM::Role Custom::S3AutoDeleteObjectsCustomResourceProvider/Role CustomS3AutoDeleteObjectsCustomResourceProviderRole3B1BD092
[+] AWS::Lambda::Function Custom::S3AutoDeleteObjectsCustomResourceProvider/Handler CustomS3AutoDeleteObjectsCustomResourceProviderHandler9D90184F
[~] AWS::S3::Bucket MyFirstBucket MyFirstBucketB8884501
 ├─ [~] DeletionPolicy
 │   ├─ [-] Retain
 │   └─ [+] Delete
 └─ [~] UpdateReplacePolicy
     ├─ [-] Retain
     └─ [+] Delete

Untuk membandingkan tumpukan aplikasi Anda dengan penerapan yang ada:

cdk diff MyStack

Untuk membandingkan tumpukan aplikasi Anda dengan CloudFormation templat yang disimpan:

cdk diff --template ~/stacks/MyStack.old MyStack

Mengimpor sumber daya yang ada ke dalam tumpukan

Anda dapat menggunakan cdk import perintah untuk membawa sumber daya di bawah pengelolaan CloudFormation untuk AWS CDK tumpukan tertentu. Ini berguna jika Anda bermigrasi ke AWS CDK, atau memindahkan sumber daya antar tumpukan atau mengubah id logisnya. cdk import menggunakan impor CloudFormation sumber daya. Lihat daftar sumber daya yang dapat diimpor di sini.

Untuk mengimpor sumber daya yang ada ke AWS CDK tumpukan, ikuti langkah-langkah berikut:

Fitur ini saat ini tidak mendukung pengimporan sumber daya ke tumpukan bersarang.

Konfigurasi (cdk.json)

Nilai default untuk banyak flag baris perintah CDK Toolkit dapat disimpan dalam file proyek atau dalam cdk.json .cdk.json file di direktori pengguna Anda. Berikut ini adalah referensi abjad ke pengaturan konfigurasi yang didukung.