Iniziare con AWS CDK - AWS Cloud Development Kit (AWS CDK) v2
PrerequisitiFase 1: Creare un Account AWSFase 2: Configurazione dell'accesso programmaticoFase 3: Installare AWS CDKCLIFase 4: Avvia il tuo ambienteAWS CDK Strumenti opzionaliPassaggi successiviUlteriori informazioni

Questa è la guida per sviluppatori AWS CDK v2. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Iniziare con AWS CDK

Inizia installando AWS CDK CLI e creando la tua prima app CDK. AWS Cloud Development Kit (AWS CDK)

Argomenti

Prerequisiti

Risorse consigliate

Prima di iniziare con AWS CDK, ti consigliamo di acquisire una conoscenza di base di quanto segue:

Prepara il tuo ambiente locale

Tutti AWS CDK gli sviluppatori, indipendentemente dalla lingua preferita, necessitano della versione Node.js14.15.0 o successiva. Tutti i linguaggi di programmazione supportati utilizzano lo stesso backend, che funziona su. Node.js Consigliamo una versione con supporto attivo a lungo termine. La tua organizzazione potrebbe avere una raccomandazione diversa.

Importante

Le versioni da 13.0.0 a 13.6.0 di Node.js non sono compatibili con a AWS CDK causa di problemi di compatibilità con le relative dipendenze.

Gli altri prerequisiti dipendono dal linguaggio in cui si sviluppano AWS CDK le applicazioni e sono i seguenti.

TypeScript

  • TypeScript 3.8 o versione successiva () npm -g install typescript

JavaScript

Nessun requisito aggiuntivo

Python

  • Python 3.7 o successivo incluso e pip virtualenv

Java

  • Java Development Kit (JDK) 8 (alias 1.8) o versione successiva

  • Apache Maven 3.5 o versione successiva

Java IDE consigliato (utilizziamo Eclipse in alcuni esempi di questa guida). L'IDE deve essere in grado di importare progetti Maven. Assicurati che il tuo progetto sia impostato per utilizzare Java 1.8. Imposta la variabile di ambiente JAVA_HOME sul percorso in cui hai installato il JDK.

C#

.NET Core 3.1 o versione successiva oppure .NET 6.0 o versione successiva.

Si consiglia Visual Studio 2019 (qualsiasi edizione) o Visual Studio Code.

Go

Passa alla versione 1.1.8 o successiva.

Per informazioni più dettagliate, consulta la sezione Prerequisiti per la tua lingua:

Deprecazione della lingua di terze parti

Ogni versione linguistica è supportata solo fino alla fine del ciclo di vita ed è soggetta a modifiche con preavviso. EOL

Fase 1: Creare un Account AWS

Se sei nuovo AWS, devi registrarti Account AWS e creare un utente amministrativo. Per ulteriori informazioni, consulta Getting up up with IAM nella IAM User Guide.

Quando interagisci con AWS, specifichi le tue credenziali di AWS sicurezza per verificare chi sei e se disponi dell'autorizzazione per accedere alle risorse che stai richiedendo. AWS utilizza le credenziali di sicurezza per autenticare e autorizzare le richieste. Per ulteriori informazioni, consulta le credenziali AWS di sicurezza nella Guida per l'utente IAM.

Fase 2: Configurazione dell'accesso programmatico

Quando svilupperai con the AWS CDK nel tuo ambiente locale, farai affidamento su di loro AWS CDK CLI per interagire Servizi AWS e gestire AWS le tue risorse. Per utilizzare AWS CDK CLI, è necessario configurare l'accesso programmatico. Per ulteriori informazioni sui diversi modi in cui è possibile configurare l'accesso programmatico, consulta Autenticazione e accesso nella Guida di riferimento agli AWS SDK e agli strumenti.

Per i nuovi utenti a cui non viene fornito un metodo di autenticazione dal datore di lavoro, consigliamo di utilizzare. AWS IAM Identity Center Questo metodo include l'installazione di AWS Command Line Interface (AWS CLI) e il suo utilizzo per la configurazione e l' AWS accesso al portale di accesso. Per configurare l'accesso programmatico utilizzando IAM Identity Center, consulta l'autenticazione IAM Identity Center nella Guida di riferimento agli AWS SDK e agli strumenti. Dopo il completamento, l'ambiente dovrebbe contenere i seguenti elementi:

  • Il AWS CLI, che viene utilizzato per avviare una sessione del portale di AWS accesso prima di eseguire l'applicazione.

  • Un AWSconfigfile condiviso con un [default] profilo con un set di valori di configurazione a cui è possibile fare riferimento da. AWS CDK Per trovare la posizione di questo file, consulta l'argomento relativo alla posizione dei file condivisi nella Guida di riferimento per SDK e strumenti AWS .

  • Il config file condiviso imposta l'regionimpostazione. Questo imposta gli AWS CDK usi predefiniti Regione AWS per AWS le richieste.

  • AWS CDK Utilizza la configurazione del provider di token SSO del profilo per acquisire le credenziali prima di inviare richieste a. AWS Il sso_role_name valore, che è un ruolo IAM connesso a un set di autorizzazioni IAM Identity Center, dovrebbe consentire l'accesso ai dati Servizi AWS utilizzati nell'applicazione.

    Il seguente config file di esempio mostra un profilo predefinito impostato con la configurazione del provider di token SSO. L'sso_sessionimpostazione del profilo si riferisce alla sso-sessionsezione denominata. La sso-session sezione contiene le impostazioni per avviare una sessione del portale di AWS accesso.

    [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

Avviare una sessione del portale di AWS accesso

Prima di accedere Servizi AWS, è necessaria una sessione attiva del portale di AWS accesso AWS CDK per utilizzare l'autenticazione IAM Identity Center per risolvere le credenziali. A seconda della durata della sessione configurata, l'accesso alla fine scadrà e si AWS CDK verificherà un errore di autenticazione. Esegui il seguente comando in AWS CLI per accedere al portale di AWS accesso.

aws sso login

Se la configurazione del provider di token SSO utilizza un profilo denominato anziché il profilo predefinito, il comando èaws sso login --profile NAME. Specificate inoltre questo profilo quando emettete cdk comandi utilizzando l'--profileopzione o la variabile di AWS_PROFILE ambiente.

Per verificare se hai già una sessione attiva, esegui il AWS CLI comando seguente.

aws sts get-caller-identity

La risposta a questo comando dovrebbe restituire l'account IAM Identity Center e il set di autorizzazioni configurati nel file config condiviso.

Nota

Se hai già una sessione attiva del portale di AWS accesso ed eseguiaws sso login, non ti verrà richiesto di fornire credenziali.

La procedura di accesso potrebbe richiedere all'utente di consentire l' AWS CLI accesso ai dati. Poiché AWS CLI è basato sull'SDK per Python, i messaggi di autorizzazione possono contenere variazioni del botocore nome.

Fase 3: Installare AWS CDKCLI

Installa AWS CDK CLI globalmente utilizzando il seguente comando Node Package Manager.

npm install -g aws-cdk
Nota

Se ricevi un errore di autorizzazione e disponi dell'accesso come amministratore sul tuo sistema, provasudo npm install -g aws-cdk.

Esegui il comando seguente per verificare l'avvenuta installazione. AWS CDK CLIDovrebbe mostrare il numero di versione:

cdk --version

Se ricevi un messaggio di errore, prova a disinstallarlo AWS CDK CLI eseguendo quanto segue:

npm uninstall -g aws-cdk

Quindi, ripeti i passaggi per reinstallare. AWS CDK CLI

Se il messaggio di errore persiste, elimina la node-modules cartella dal progetto corrente e anche dalla node-modules cartella globale. Per individuare questa cartella, eseguinpm config get prefix.

AWS CDK CLIOtterrà le credenziali di sicurezza dalle fonti configurate nei passaggi precedenti.

Nota

CDK Toolkit v2 funziona con i progetti CDK v1 esistenti. Tuttavia, non può inizializzare nuovi progetti CDK v1. Vedi Nuovi prerequisiti se devi essere in grado di farlo.

Fase 4: Avvia il tuo ambiente

Ogni AWSambiente in cui intendi distribuire le risorse deve essere avviato.

Per eseguire il bootstrap, esegui quanto segue:

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

Se non hai il tuo numero di AWS conto a portata di mano, puoi richiederlo AWS Management Console da. Oppure, se lo hai AWS CLI installato, il comando seguente mostra le informazioni predefinite del tuo account, incluso il numero di account.

aws sts get-caller-identity

Se hai creato profili denominati nella AWS configurazione locale, puoi utilizzare l'--profileopzione per visualizzare le informazioni sull'account per un profilo specifico. L'esempio seguente mostra come visualizzare le informazioni sull'account per il profilo prod.

aws sts get-caller-identity --profile prod

Per visualizzare la regione predefinita, utilizzareaws configure get.

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

AWS CDK Strumenti opzionali

AWS Toolkit for Visual Studio CodeÈ un plug-in open source per Visual Studio Code che consente di creare, eseguire il debug e distribuire applicazioni su. AWS Il toolkit offre un'esperienza integrata per lo sviluppo di applicazioni. AWS CDK Include la funzionalità AWS CDK Explorer per elencare i AWS CDK progetti e sfogliare i vari componenti dell'applicazione CDK. Installa il plug-in e scopri di più sull'utilizzo di Explorer. AWS CDK

Passaggi successivi

Ora che lo hai installato AWS CDK CLI, usalo per creare la tua prima AWS CDK app.

Per ulteriori informazioni sull'utilizzo di AWS CDK nel linguaggio di programmazione preferito, consultaLavorare con i AWS CDK linguaggi di programmazione supportati.

AWS CDK Si tratta di un progetto open source. Per contribuire, vedi Contributing to. AWS Cloud Development Kit (AWS CDK)

Ulteriori informazioni

Per ulteriori informazioni su AWS CDK, consulta quanto segue: