Memulai dengan AWS CDK - AWS Cloud Development Kit (AWS CDK) v2
PrasyaratLangkah 1: Buat Akun AWSLangkah 2: Konfigurasikan akses terprogramLangkah 3: Instal AWS CDKCLILangkah 4: Bootstrap lingkungan AndaAWS CDK Alat opsionalLangkah selanjutnyaPelajari selengkapnya

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

Mulailah AWS Cloud Development Kit (AWS CDK) dengan menginstal AWS CDK CLI dan membuat aplikasi CDK pertama Anda.

Topik

Prasyarat

Sumber daya yang direkomendasikan

Sebelum memulai dengan AWS CDK, kami merekomendasikan pemahaman dasar tentang hal-hal berikut:

  • Pengantar untuk AWS CDK. Untuk mempelajari selengkapnya, lihat Apa itu AWS CDK?

  • Konsep inti di balik AWS CDK. Untuk mempelajari selengkapnya, lihat Pelajari konsep AWS CDK inti.

  • Layanan AWS Yang ingin Anda kelola dengan AWS CDK.

  • AWS Identity and Access Management. Untuk informasi lebih lanjut, lihat Apa itu IAM? dan Apa itu Pusat Identitas IAM?

  • AWS CloudFormation karena AWS CDK memanfaatkan AWS CloudFormation layanan untuk menyediakan sumber daya yang dibuat di CDK. Untuk mempelajari selengkapnya, lihat Apa itu AWS CloudFormation?

  • Bahasa pemrograman yang didukung yang Anda rencanakan untuk digunakan dengan AWS CDK.

Persiapkan lingkungan lokal Anda

Semua AWS CDK pengembang, terlepas dari bahasa pilihan Anda, memerlukan Node.js14.15.0 atau yang lebih baru. Semua bahasa pemrograman yang didukung menggunakan backend yang sama, yang berjalan pada. Node.js Kami merekomendasikan versi dalam dukungan jangka panjang aktif. Organisasi Anda mungkin memiliki rekomendasi yang berbeda.

penting

Node.js versi 13.0.0 hingga 13.6.0 tidak kompatibel dengan AWS CDK karena masalah kompatibilitas dengan dependensinya.

Prasyarat lain tergantung pada bahasa di mana Anda mengembangkan AWS CDK aplikasi dan adalah sebagai berikut.

TypeScript

  • TypeScript 3.8 atau lebih baru () npm -g install typescript

JavaScript

Tidak ada persyaratan tambahan

Python

  • Python 3.7 atau yang lebih baru termasuk dan pip virtualenv

Java

  • Java Development Kit (JDK) 8 (alias 1.8) atau yang lebih baru

  • Apache Maven 3.5 atau yang lebih baru

Java IDE direkomendasikan (kami menggunakan Eclipse dalam beberapa contoh dalam panduan ini). IDE harus dapat mengimpor proyek Maven. Periksa untuk memastikan bahwa proyek Anda diatur untuk menggunakan Java 1.8. Atur variabel lingkungan JAVA_HOME ke jalur tempat Anda menginstal JDK.

C#

.NET Core 3.1 atau yang lebih baru, atau .NET 6.0 atau yang lebih baru.

Visual Studio 2019 (edisi apa pun) atau Visual Studio Code direkomendasikan.

Go

Pergi 1.1.8 atau yang lebih baru.

Untuk informasi lebih rinci, lihat bagian Prasyarat untuk bahasa Anda:

Pengunduran bahasa pihak ketiga

Setiap versi bahasa hanya didukung sampai EOL (End Of Life) dan dapat berubah sewaktu-waktu dengan pemberitahuan sebelumnya.

Langkah 1: Buat Akun AWS

Jika Anda baru AWS, Anda harus mendaftar untuk Akun AWS dan membuat pengguna administratif. Untuk informasi selengkapnya, lihat Menyiapkan IAM di Panduan Pengguna IAM.

Ketika Anda berinteraksi AWS, Anda menentukan kredensi AWS keamanan Anda untuk memverifikasi siapa Anda dan apakah Anda memiliki izin untuk mengakses sumber daya yang Anda minta. AWS menggunakan kredensi keamanan untuk mengautentikasi dan mengotorisasi permintaan Anda. Untuk mempelajari selengkapnya, lihat kredensi AWS keamanan di Panduan Pengguna IAM.

Langkah 2: Konfigurasikan akses terprogram

Ketika mengembangkan dengan AWS CDK di lingkungan lokal Anda, Anda akan bergantung pada AWS CDK CLI untuk berinteraksi dengan Layanan AWS dan mengelola AWS sumber daya Anda. Untuk menggunakan AWS CDK CLI, Anda harus mengkonfigurasi akses terprogram. Untuk mempelajari selengkapnya tentang berbagai cara mengonfigurasi akses terprogram, lihat Otentikasi dan akses di Panduan Referensi AWS SDK dan Alat.

Untuk pengguna baru yang tidak diberi metode otentikasi oleh perusahaan mereka, sebaiknya gunakan AWS IAM Identity Center. Metode ini termasuk menginstal AWS Command Line Interface (AWS CLI) dan menggunakannya untuk konfigurasi dan masuk ke portal AWS akses. Untuk mengonfigurasi akses terprogram menggunakan IAM Identity Center, lihat Autentikasi IAM Identity Center di AWS SDK and Tools Reference Guide. Setelah selesai, lingkungan Anda harus berisi elemen-elemen berikut:

  • Itu AWS CLI, yang Anda gunakan untuk memulai sesi portal AWS akses sebelum Anda menjalankan aplikasi Anda.

  • AWSconfigFile bersama yang memiliki [default] profil dengan serangkaian nilai konfigurasi yang dapat direferensikan dari file. AWS CDK Untuk menemukan lokasi file ini, lihat Lokasi file bersama di AWS SDK dan Panduan Referensi Alat.

  • configFile bersama menetapkan regionpengaturan. Ini menetapkan default Wilayah AWS AWS CDK penggunaan untuk AWS permintaan.

  • AWS CDK Menggunakan konfigurasi penyedia token SSO profil untuk memperoleh kredensional sebelum mengirim permintaan ke. AWSsso_role_nameNilai, yang merupakan peran IAM yang terhubung ke set izin Pusat Identitas IAM, harus memungkinkan akses ke yang Layanan AWS digunakan dalam aplikasi Anda.

    configFile contoh berikut menunjukkan profil default yang diatur dengan konfigurasi penyedia token SSO. sso_sessionPengaturan profil mengacu pada sso-sessionbagian bernama. sso-sessionBagian ini berisi pengaturan untuk memulai sesi portal AWS akses.

    [default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json

[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access

Memulai sesi portal AWS akses

Sebelum mengakses Layanan AWS, Anda memerlukan sesi portal AWS akses aktif agar dapat menggunakan autentikasi IAM Identity Center AWS CDK untuk menyelesaikan kredensialnya. Bergantung pada panjang sesi yang dikonfigurasi, akses Anda pada akhirnya akan kedaluwarsa dan AWS CDK 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. Tentukan juga 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.

catatan

Jika Anda sudah memiliki sesi portal AWS akses aktif dan menjalankannyaaws sso login, Anda tidak akan diminta untuk memberikan kredensi.

Proses masuk dapat meminta Anda untuk mengizinkan AWS CLI akses ke data Anda. Karena AWS CLI dibangun di atas SDK untuk Python, pesan izin mungkin berisi variasi nama. botocore

Langkah 3: Instal AWS CDKCLI

Instal secara AWS CDK CLI global menggunakan perintah Node Package Manager berikut.

npm install -g aws-cdk
catatan

Jika Anda mendapatkan kesalahan izin, dan memiliki akses administrator di sistem Anda, cobasudo npm install -g aws-cdk.

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

cdk --version

Jika Anda menerima pesan kesalahan, coba hapus instalan AWS CDK CLI dengan menjalankan yang berikut ini:

npm uninstall -g aws-cdk

Kemudian, ulangi langkah-langkah untuk menginstal ulang file. AWS CDK CLI

Jika Anda masih menerima kesalahan, hapus node-modules folder dari proyek saat ini dan juga dari node-modules folder global. Untuk menemukan folder ini, jalankannpm config get prefix.

Ini AWS CDK CLI akan memperoleh kredensi keamanan dari sumber yang Anda konfigurasikan pada langkah sebelumnya.

catatan

CDK Toolkit v2 bekerja dengan proyek CDK v1 yang ada. Namun, itu tidak dapat menginisialisasi proyek CDK v1 baru. Lihat Prasyarat baru apakah Anda harus bisa melakukan itu.

Langkah 4: Bootstrap lingkungan Anda

Setiap AWS lingkungan yang Anda rencanakan untuk menyebarkan sumber daya harus di-bootstrap.

Untuk bootstrap, jalankan yang berikut ini:

cdk bootstrap aws://ACCOUNT-NUMBER/REGION
Tip

Jika Anda tidak memiliki nomor AWS akun yang berguna, Anda bisa mendapatkannya dari AWS Management Console. Atau, jika Anda telah AWS CLI menginstal, perintah berikut menampilkan informasi akun default Anda, termasuk nomor akun.

aws sts get-caller-identity

Jika Anda membuat profil bernama dalam AWS konfigurasi lokal Anda, Anda dapat menggunakan --profile opsi untuk menampilkan informasi akun untuk profil tertentu. Contoh berikut menunjukkan cara menampilkan informasi akun untuk profil prod.

aws sts get-caller-identity --profile prod

Untuk menampilkan Wilayah default, gunakanaws configure get.

aws configure get region
aws configure get region --profile prod

AWS CDK Alat opsional

AWS Toolkit for Visual Studio CodeIni adalah plug-in open source untuk Visual Studio Code yang membantu Anda membuat, men-debug, dan menyebarkan aplikasi. AWS Toolkit ini memberikan pengalaman terintegrasi untuk mengembangkan AWS CDK aplikasi. Ini termasuk fitur AWS CDK Explorer untuk daftar AWS CDK proyek Anda dan menelusuri berbagai komponen aplikasi CDK. Instal plug-in dan pelajari lebih lanjut tentang menggunakan AWS CDK Explorer.

Langkah selanjutnya

Sekarang setelah Anda menginstal AWS CDK CLI, gunakan untuk membangun AWS CDK aplikasi pertama Anda.

Untuk mempelajari lebih lanjut tentang menggunakan bahasa pemrograman pilihan Anda, lihatBekerja dengan AWS CDK dalam bahasa pemrograman yang didukung. AWS CDK

AWS CDK Ini adalah proyek sumber terbuka. Untuk berkontribusi, lihat Berkontribusi pada AWS Cloud Development Kit (AWS CDK).

Pelajari selengkapnya

Untuk mempelajari lebih lanjut tentang ini AWS CDK, lihat berikut ini: