Questa è la guida per sviluppatori AWS CDK v2. La versione precedente della CDK versione 1 è entrata 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à.

Implementazione di applicazioni AWS CDK

L' AWS Cloud Development Kit (AWS CDK) implementazione è il processo di provisioning dell'infrastruttura. AWS

Come funzionano le AWS CDK implementazioni

AWS CDK Utilizza il AWS CloudFormation servizio per eseguire le distribuzioni. Prima della distribuzione, sintetizzi i tuoi stack. CDK Questo crea un CloudFormation modello e implementa gli artefatti per ogni stack dell'app. CDK Le implementazioni vengono avviate da una macchina di sviluppo locale o da un ambiente di integrazione e distribuzione continue (CI/CD). Durante la distribuzione, le risorse vengono caricate sulle risorse avviate e il CloudFormation modello viene inviato per il provisioning delle risorse. CloudFormation AWS

Affinché una distribuzione abbia successo, è necessario quanto segue:

Prerequisiti per le distribuzioni CDK

Prima di poter distribuire un' AWS CDK applicazione, è necessario completare quanto segue:

Configura le credenziali di sicurezza

Per utilizzare con cui CDK CLI interagire AWS, è necessario configurare le credenziali di sicurezza sul computer locale. Per istruzioni, consulta Configurare le credenziali di sicurezza per AWS CDKCLI.

Avvia il tuo ambiente AWS

Una distribuzione è sempre associata a uno o più AWS ambienti. Prima di poter eseguire la distribuzione, è necessario avviare l'ambiente. Il bootstrap fornisce all'ambiente le risorse che CDK utilizza per eseguire e gestire le distribuzioni. Queste risorse includono un bucket Amazon Simple Storage Service (Amazon S3) e un repository Amazon Elastic Container Registry (ECRAmazon) per archiviare e gestire le risorse. Queste risorse includono anche AWS Identity and Access Management (IAM) ruoli utilizzati per fornire autorizzazioni durante lo sviluppo e la distribuzione.

Ti consigliamo di utilizzare il AWS CDK comando Command Line Interface (AWS CDK CLI) cdk bootstrap per avviare il tuo ambiente. Se necessario, potete personalizzare il bootstrap o creare manualmente queste risorse nel vostro ambiente. Per istruzioni, consulta Avvia il tuo ambiente per utilizzarlo con AWS CDK.

Configura gli ambienti AWS

Ogni CDK stack deve essere associato a un ambiente per determinare dove viene distribuito lo stack. Per istruzioni, consulta Configurare gli ambienti da utilizzare con AWS CDK.

Sviluppa la tua app CDK

All'interno di un CDK progetto, crei e sviluppi la tua CDK app. All'interno della tua app, crei uno o più CDK stack. All'interno degli stack, è possibile importare e utilizzare i costrutti della AWS Construct Library per definire l'infrastruttura. Prima di poter eseguire la distribuzione, CDK l'app deve contenere almeno uno stack.

CDKsintesi dell'app

Per eseguire la sintesi, si consiglia di utilizzare il CDK CLI cdk synth comando. Il cdk deploy comando eseguirà anche la sintesi prima di iniziare la distribuzione. Tuttavia, utilizzandocdk synth, puoi convalidare CDK l'app e catturare gli errori prima di iniziare la distribuzione.

Il comportamento di sintesi è determinato dal sintetizzatore di stack configurato per lo stack. CDK Se non configuri un sintetizzatore, verrà utilizzato. DefaultStackSynthesizer Puoi anche configurare e personalizzare la sintesi per soddisfare le tue esigenze. Per istruzioni, consulta Configura e personalizza la sintesi CDK dello stack.

Affinché il CloudFormation modello sintetizzato possa essere distribuito correttamente nell'ambiente, deve essere compatibile con il modo in cui è stato avviato l'ambiente. Ad esempio, il CloudFormation modello deve specificare il bucket Amazon S3 corretto in cui distribuire gli asset. Se utilizzi il metodo predefinito di bootstrap del tuo ambiente, il sintetizzatore di stack predefinito funzionerà. Se personalizzi il CDK comportamento, ad esempio personalizzando il bootstrap o la sintesi, il comportamento di implementazione può variare. CDK

Il ciclo di vita dell'app

Quando esegui la sintesi, CDK l'app attraversa le seguenti fasi, note come ciclo di vita dell'app:

Esecuzione dell'app

È CDK CLI necessario sapere come eseguire la tua CDK app. Se hai creato il progetto da un modello utilizzando il cdk init comando, il cdk.json file dell'app include una app chiave. Questa chiave specifica il comando necessario per la lingua in cui è scritta l'app. Se la lingua richiede la compilazione, la riga di comando esegue questo passaggio prima di eseguire automaticamente l'app.

TypeScript

{
  "app": "npx ts-node --prefer-ts-exts bin/my-app.ts"
}

JavaScript

{
  "app": "node bin/my-app.js"
}

Python

{
    "app": "python app.py"
}

Java

{
  "app": "mvn -e -q compile exec:java"
}

C#

{
  "app": "dotnet run -p src/MyApp/MyApp.csproj"
}

Go

{
  "app": "go mod download && go run my-app.go"
}

Se non hai creato il progetto utilizzando o se desideri sovrascrivere la riga di comando fornita incdk.json, puoi fornire l'--appopzione durante l'esecuzione del cdk comando. CDK CLI

$ cdk --app 'executable' cdk-command ...

Il executable parte del comando indica il comando da eseguire per eseguire l'CDKapplicazione. Utilizzate le virgolette come illustrato, poiché tali comandi contengono spazi. Il cdk-command è un sottocomando simile a synth o deploy che dice CDK CLI cosa vuoi fare con la tua app. Segui questo con tutte le opzioni aggiuntive necessarie per quel sottocomando.

CDKCLIPossono anche interagire direttamente con un assemblaggio cloud già sintetizzato. Per farlo, passa la directory in cui è archiviato l'assembly cloud. --app L'esempio seguente elenca gli stack definiti nell'assembly cloud archiviato in./my-cloud-assembly.

$ cdk --app ./my-cloud-assembly ls

Assemblaggi cloud

La chiamata a app.synth() è ciò che dice loro di AWS CDK sintetizzare un assemblaggio cloud da un'app. In genere non si interagisce direttamente con gli assembly cloud. Sono file che includono tutto il necessario per distribuire l'app in un ambiente cloud. Ad esempio, include un AWS CloudFormation modello per ogni stack dell'app. Include anche una copia di qualsiasi file, risorsa o Docker immagine a cui fai riferimento nell'app.

Consulta le specifiche degli assemblaggi cloud per i dettagli sulla formattazione degli assembly cloud.

Per interagire con l'assembly cloud creato dall' AWS CDK app, in genere si utilizza il. AWS CDK CLI Tuttavia, qualsiasi strumento in grado di leggere il formato di assemblaggio cloud può essere utilizzato per distribuire l'app.

Distribuzione dell'applicazione

Per distribuire l'applicazione, si consiglia di utilizzare il CDK CLI cdk deploy comando per avviare le distribuzioni o per configurare le distribuzioni automatizzate.

Quando si esegue, si avvia la preparazione per cdk deploy la distribuzione. CDK CLI cdk synth Il diagramma seguente illustra il ciclo di vita dell'app nel contesto di una distribuzione:

Durante l'implementazione, CDK CLI prende l'assemblaggio cloud prodotto da Synthesis e lo distribuisce in un ambiente. AWS Le risorse vengono caricate su Amazon S3 ECR e Amazon e il CloudFormation modello viene inviato AWS CloudFormation per la distribuzione.

Quando inizia la fase di AWS CloudFormation distribuzione, l'CDKapp ha già terminato l'esecuzione e l'uscita. Ciò comporta quanto segue:

Autorizzazioni di distribuzione

Prima di poter eseguire la distribuzione, è necessario stabilire le autorizzazioni. Il diagramma seguente illustra le autorizzazioni utilizzate durante una distribuzione predefinita, quando si utilizza il processo di bootstrap e il sintetizzatore di stack predefiniti: