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
<a name="toolkit-library-gs"></a>

Mulailah menggunakan AWS CDK Toolkit Library untuk melakukan tindakan CDK secara terprogram, seperti sintesis dan penerapan, dalam kode Anda.

## Prasyarat
<a name="toolkit-library-gs-prerequisites"></a>

1. Versi Node.js yang didukung diinstal.

1.  AWS kredensi dikonfigurasi.

1. Keakraban dasar dengan AWS CDK.

Untuk informasi lebih lanjut, lihat [prasyarat AWS CDK](prerequisites.md).

## Langkah 1: Menginstal Perpustakaan Toolkit CDK
<a name="toolkit-library-gs-install"></a>

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
<a name="toolkit-library-gs-initialize"></a>

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](toolkit-library-configure.md).

## Langkah 3: Membuat sumber perakitan cloud untuk aplikasi CDK Anda
<a name="toolkit-library-gs-ca"></a>

Sumber perakitan cloud memberikan instruksi untuk membuat CloudFormation templat dari aplikasi CDK Anda. Anda dapat membuatnya dengan berbagai cara. Berikut ini adalah beberapa contoh:

1.  **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();
   });
   ```

1.  **File aplikasi CDK yang ada**:

   ```
   const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");
   ```

Untuk informasi selengkapnya, lihat [Mengonfigurasi sumber perakitan cloud](toolkit-library-configure-ca.md).

## Langkah 4: Mendefinisikan tindakan terprogram untuk aplikasi CDK Anda
<a name="toolkit-library-gs-define"></a>

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
<a name="toolkit-library-gs-customize"></a>

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](toolkit-library-configure-messages.md).
+  **Penanganan kesalahan** - Menerapkan penanganan kesalahan terstruktur untuk operasi CDK. Lihat [Mengonfigurasi penanganan kesalahan](toolkit-library-configure.md#toolkit-library-configure-errors).

## Sumber daya tambahan
<a name="toolkit-library-gs-resources"></a>

Untuk informasi selengkapnya tentang paket CDK Toolkit Library, lihat `npm` paket *@aws [ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib)`npm`-cdk/toolkit-lib*.

Untuk informasi referensi API, lihat referensi [CDK Toolkit Library API](https://docs.aws.amazon.com/cdk/api/toolkit-lib/).