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.
Memulai dengan CDK Toolkit Library
Mulailah menggunakan AWS CDK Toolkit Library untuk melakukan tindakan CDK secara terprogram, seperti sintesis dan penerapan, dalam kode Anda.
Prasyarat
-
Versi Node.js yang didukung diinstal.
-
AWS kredensi dikonfigurasi.
-
Keakraban dasar dengan AWS CDK.
Untuk informasi lebih lanjut, lihat prasyarat AWS CDK.
Langkah 1: Menginstal Perpustakaan Toolkit CDK
Instal paket CDK Toolkit Library di lingkungan pengembangan proyek Anda dengan menjalankan yang berikut:
npm install --save @aws-cdk/toolkit-lib
Langkah 2: Menginisialisasi Perpustakaan Toolkit CDK
Buat instance CDK Toolkit untuk melakukan tindakan terprogram pada aplikasi CDK Anda.
import { Toolkit } from '@aws-cdk/toolkit-lib'; const toolkit = new Toolkit({ // Optional configuration options go here });
Anda dapat menyesuaikan instance CDK Toolkit selama pembuatan. Untuk petunjuk, lihat Mengonfigurasi instance CDK Toolkit Anda.
Langkah 3: Membuat sumber perakitan cloud untuk aplikasi CDK Anda
Sumber perakitan cloud memberikan instruksi untuk membuat CloudFormation templat dari aplikasi CDK Anda. Anda dapat membuatnya dengan berbagai cara. Berikut ini adalah beberapa contoh:
-
Fungsi pembuat perakitan inline:
import * as cdk from 'aws-cdk-lib'; const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => { const app = new cdk.App(); new MyStack(app, 'MyStack'); return app.synth(); });
-
File aplikasi CDK yang ada:
const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");
Untuk informasi selengkapnya, lihat Mengonfigurasi sumber perakitan cloud.
Langkah 4: Mendefinisikan tindakan terprogram untuk aplikasi CDK Anda
Sekarang setelah Anda membuat instance CDK Toolkit dan sumber perakitan cloud, Anda dapat mulai menentukan tindakan terprogram. Berikut ini adalah contoh dasar yang membuat penyebaran MyStack
tumpukan:
import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib'; await toolkit.deploy(cloudAssemblySource, { stacks: { strategy: StackSelectionStrategy.PATTERN_MUST_MATCH, // Deploy only stacks that exactly match the provided patterns patterns: ["MyStack"], }, });
Langkah 5: Menyesuaikan Toolkit CDK lebih lanjut
Anda dapat mengonfigurasi dan menyesuaikan CDK Toolkit lebih lanjut untuk kebutuhan Anda:
-
Pesan dan interaksi - Konfigurasikan bagaimana CDK Toolkit berkomunikasi dengan pengguna dan aplikasi. Lihat Mengonfigurasi pesan & interaksi.
-
Penanganan kesalahan - Menerapkan penanganan kesalahan terstruktur untuk operasi CDK. Lihat Mengonfigurasi penanganan kesalahan.
Sumber daya tambahan
Untuk informasi selengkapnya tentang paket CDK Toolkit Library, lihat npm
paket @aws ReadMenpm
-cdk/toolkit-lib.
Untuk informasi referensi API, lihat referensi CDK Toolkit Library API.