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 AWS CDK
<a name="getting-started"></a>

Mulailah dengan AWS Cloud Development Kit (AWS CDK) dengan menginstal dan mengonfigurasi CDK Command Line Interface ( AWS CDK AWS CLI). Kemudian, gunakan CDK CLI untuk membuat aplikasi CDK pertama Anda, bootstrap lingkungan AWS Anda, dan menerapkan aplikasi Anda.

## Prasyarat
<a name="getting-started-prerequisites"></a>

Sebelum memulai dengan AWS CDK, lengkapi semua prasyarat. Prasyarat ini diperlukan bagi mereka yang baru AWS atau baru mengenal pemrograman. Untuk instruksi, lihat [prasyarat AWS CDK](prerequisites.md).

Kami menyarankan Anda memiliki pemahaman dasar tentang apa itu AWS CDK. Untuk informasi lebih lanjut, lihat [Apa itu AWS CDK?](home.md) dan [Pelajari konsep inti AWS CDK](core-concepts.md).

## Instal AWS CDK CLI
<a name="getting-started-install"></a>

Gunakan Node Package Manager untuk menginstal CDK CLI. Kami menyarankan Anda menginstalnya secara global menggunakan perintah berikut:

```
$ npm install -g aws-cdk
```

Untuk menginstal versi tertentu dari CDK CLI, gunakan struktur perintah berikut:

```
$ npm install -g aws-cdk@X.YY.Z
```

Jika Anda ingin menggunakan beberapa versi AWS CDK, pertimbangkan untuk menginstal versi CLI CDK yang cocok dalam proyek CDK individual. Untuk melakukan ini, hapus `-g` opsi dari `npm install` perintah. Kemudian, gunakan `npx aws-cdk` untuk memanggil CDK CLI. Ini akan menjalankan versi lokal jika ada. Jika tidak, versi yang diinstal secara global akan digunakan.<a name="getting-started-install-troubleshoot"></a>

 **Memecahkan masalah instalasi CDK CLI**   
Jika Anda mendapatkan kesalahan izin, dan memiliki akses administrator di sistem Anda, jalankan yang berikut ini:  

```
$ sudo npm install -g aws-cdk
```
Jika Anda menerima pesan kesalahan, coba hapus instalan CDK CLI dengan menjalankan yang berikut ini:  

```
$ npm uninstall -g aws-cdk
```
Kemudian, ulangi langkah-langkah untuk menginstal ulang CDK CLI.

## Verifikasi instalasi CDK CLI yang berhasil
<a name="getting-started-install-verify"></a>

Jalankan perintah berikut untuk memverifikasi instalasi yang berhasil. AWS CDK CLI harus menampilkan nomor versi:

```
$ cdk --version
```

## Konfigurasikan AWS CDK CLI
<a name="getting-started-configure"></a>

Setelah menginstal CDK CLI, Anda dapat mulai menggunakannya untuk mengembangkan aplikasi di mesin lokal Anda. Untuk berinteraksi dengan AWS, seperti menerapkan aplikasi, Anda harus memiliki kredenal keamanan yang dikonfigurasi pada komputer lokal Anda dengan izin untuk melakukan tindakan apa pun yang Anda lakukan.

Untuk mengonfigurasi kredensi keamanan pada mesin lokal Anda, Anda menggunakan CLI AWS . Cara Anda mengonfigurasi kredensi keamanan tergantung pada cara Anda mengelola pengguna. Untuk petunjuknya, lihat [Otentikasi dan akses kredensil di Panduan](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html) Pengguna *Antarmuka Baris AWS Perintah*.

CDK CLI akan secara otomatis menggunakan kredenal keamanan yang Anda konfigurasikan dengan CLI. AWS Misalnya, jika Anda adalah pengguna IAM Identity Center, Anda dapat menggunakan `aws configure sso` perintah untuk mengonfigurasi kredensi keamanan. Jika Anda adalah pengguna IAM, Anda dapat menggunakan `aws configure` perintah. AWS CLI akan memandu Anda melalui konfigurasi kredensil keamanan pada mesin lokal Anda dan menyimpan informasi yang diperlukan dalam file dan Anda. `config` `credentials` Kemudian, ketika Anda menggunakan CDK CLI, seperti menerapkan aplikasi `cdk deploy` dengan, CDK CLI akan menggunakan kredenal keamanan yang dikonfigurasi.

Sama seperti AWS CLI, CDK CLI akan menggunakan `default` profil Anda secara default. Anda dapat menentukan profil menggunakan opsi CDK [`--profile`](ref-cli-cmd.md#ref-cli-cmd-options-profile)CLI. Untuk informasi selengkapnya tentang penggunaan kredensil keamanan dengan CDK CLI, [lihat Mengonfigurasi kredensil keamanan](configure-access.md) untuk CDK CLI. AWS 

## (Opsional) Instal alat AWS CDK tambahan
<a name="getting-started-tools"></a>

[AWS Toolkit for Visual Studio](https://aws.amazon.com/visualstudiocode/) Code adalah plug-in Visual Studio Code open source yang membantu Anda membuat, men-debug, dan menyebarkan aplikasi. AWS Toolkit ini memberikan pengalaman terintegrasi untuk mengembangkan aplikasi AWS CDK. Ini termasuk fitur AWS CDK Explorer untuk membuat daftar proyek AWS CDK Anda dan menelusuri berbagai komponen aplikasi CDK. Untuk petunjuk, lihat yang berikut ini:
+  [Menginstal AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html).
+  [AWS CDK untuk Kode VS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/cdk-explorer.html).

## Buat aplikasi CDK pertama Anda
<a name="getting-started-app"></a>

Anda sekarang siap untuk memulai menggunakan AWS CDK dengan membuat aplikasi CDK pertama Anda. Untuk petunjuk, lihat [Tutorial: Membuat aplikasi AWS CDK pertama Anda](hello-world.md).