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.

# Lakukan tindakan terprogram menggunakan CDK Toolkit Library
<a name="toolkit-library"></a>

## Memahami Perpustakaan Toolkit CDK
<a name="toolkit-library-intro"></a>

Perpustakaan Toolkit CDK memungkinkan Anda melakukan tindakan CDK secara terprogram melalui kode alih-alih menggunakan perintah CLI. Anda dapat menggunakan pustaka ini untuk membuat alat kustom, membangun aplikasi CLI khusus, dan mengintegrasikan kemampuan CDK ke dalam alur kerja pengembangan Anda.

 **Kelola siklus hidup infrastruktur Anda dengan kontrol terprogram**   
Perpustakaan Toolkit CDK menyediakan antarmuka terprogram untuk tindakan CDK berikut:  
+  **Sintesis** - Menghasilkan AWS CloudFormation template dan artefak penyebaran.
+  **Deployment** - Menyediakan atau memperbarui infrastruktur menggunakan CloudFormation template.
+  **Refactor** - Mempertahankan sumber daya yang digunakan saat memfaktorkan ulang kode CDK, seperti mengganti nama konstruksi atau memindahkannya di antara tumpukan.
+  **Daftar** - Lihat informasi tentang tumpukan dan dependensinya.
+  **Tonton** - Pantau aplikasi CDK untuk perubahan lokal.
+  **Rollback** - Kembalikan tumpukan ke kondisi stabil terakhir mereka.
+  **Hancurkan** - Hapus tumpukan CDK dan sumber daya terkait.

 **Tingkatkan dan sesuaikan manajemen infrastruktur Anda**   
+  **Kontrol melalui kode** - Integrasikan manajemen infrastruktur langsung ke aplikasi Anda dan buat pipeline penerapan responsif.
+  **Kelola rakitan cloud** - Buat, periksa, dan ubah definisi infrastruktur Anda sebelum penerapan.
+  **Sesuaikan penerapan** - Konfigurasikan parameter, perilaku rollback, dan pemantauan agar sesuai dengan kebutuhan Anda.
+  **Pertahankan sumber daya selama refactoring** - Secara otomatis mendeteksi dan melestarikan sumber daya saat Anda memfaktorkan ulang kode CDK.
+  **Tangani kesalahan dengan tepat** - Menerapkan penanganan kesalahan terstruktur dengan informasi diagnostik terperinci.
+  **Menyesuaikan komunikasi** - Konfigurasikan indikator kemajuan khusus dan masuk melalui `IoHost` implementasi.
+  **Connect with AWS ** - Konfigurasikan profil, Wilayah, dan alur otentikasi secara terprogram.

## Memilih kapan harus menggunakan CDK Toolkit Library
<a name="toolkit-library-intro-when"></a>

Perpustakaan Toolkit CDK sangat berharga ketika Anda perlu:
+ Mengotomatiskan penyebaran infrastruktur sebagai bagian dari jaringan pipa. CI/CD 
+ Buat alat penyebaran khusus yang disesuaikan dengan kebutuhan organisasi Anda.
+ Integrasikan tindakan CDK ke dalam aplikasi atau platform yang ada.
+ Buat alur kerja penerapan khusus dengan validasi kustom atau langkah persetujuan.
+ Menerapkan pola manajemen infrastruktur tingkat lanjut di berbagai lingkungan.
+ Otomatiskan operasi refactoring untuk mempertahankan sumber daya saat Anda memfaktorkan ulang kode CDK.

## Menggunakan Perpustakaan Toolkit CDK
<a name="toolkit-library-intro-example"></a>

Contoh berikut menunjukkan cara membuat dan menerapkan bucket S3 sederhana menggunakan CDK Toolkit Library:

```
// Import required packages
import { Toolkit } from '@aws-cdk/toolkit-lib';
import { App, Stack } from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';

// Create and configure the CDK Toolkit
const toolkit = new Toolkit();

// Create a cloud assembly source with an inline app
const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
   const app = new App();
   const stack = new Stack(app, 'SimpleStorageStack');

   // Create an S3 bucket in the stack
   new s3.Bucket(stack, 'MyFirstBucket', {
      versioned: true
   });

   return app.synth();
});

// Deploy the stack
await toolkit.deploy(cloudAssemblySource);
```

 **Apa yang dapat Anda lakukan selanjutnya**   
+  **Mengotomatiskan penerapan - Memicu penerapan secara** terprogram dan menambahkan langkah penerapan. pre/post 
+  **Integrasikan dengan sistem** - Terhubung dengan CI/CD alur kerja, alat khusus, dan solusi pemantauan.
+  **Kontrol detail penerapan** - Konfigurasikan opsi berbutir halus untuk pemilihan tumpukan dan penerapan multi-lingkungan.
+  **Meningkatkan keandalan** - Menerapkan penanganan kesalahan siap produksi dan pelacakan kemajuan penerapan.
+  **Automate refactoring - Mendeteksi** dan melestarikan sumber daya saat Anda memfaktorkan ulang kode CDK.

## Langkah berikutnya
<a name="toolkit-library-intro-next"></a>

Untuk mulai menggunakan CDK Toolkit Library, lihat [Memulai dengan CDK](toolkit-library-gs.md) Toolkit Library.

## Pelajari selengkapnya
<a name="toolkit-library-intro-learn"></a>

Untuk mempelajari lebih lanjut tentang CDK Toolkit Library, lihat berikut ini:
+  [ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib)dalam paket *@aws -cdk/toolkit-lib*`npm`.
+ AWS Referensi [API Perpustakaan Toolkit CDK](https://docs.aws.amazon.com/cdk/api/toolkit-lib/).