Guida introduttiva alla libreria CDK Toolkit - AWS Cloud Development Kit (AWS CDK) v2
PrerequisitiFase 1: Installazione della libreria CDK ToolkitFase 2: Inizializzazione della libreria CDK ToolkitFase 3: Creazione di una fonte di assemblaggio cloud per l'app CDKFase 4: Definizione delle azioni programmatiche per l'app CDKFase 5: Personalizzazione ulteriore del CDK ToolkitRisorse aggiuntive

Questa è la AWS CDK v2 Developer Guide. 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à.

Guida introduttiva alla libreria CDK Toolkit

Inizia a utilizzare la AWS CDK Toolkit Library per eseguire in modo programmatico azioni CDK, come la sintesi e la distribuzione, nel tuo codice.

Prerequisiti

  1. Versione supportata di Node.js installata.

  2. AWS credenziali configurate.

  3. Familiarità di base con il CDK. AWS

Per ulteriori informazioni, consulta Prerequisiti AWS CDK.

Fase 1: Installazione della libreria CDK Toolkit

Installa il pacchetto CDK Toolkit Library nell'ambiente di sviluppo del tuo progetto eseguendo quanto segue:

npm install --save @aws-cdk/toolkit-lib

Fase 2: Inizializzazione della libreria CDK Toolkit

Crea un'istanza CDK Toolkit per eseguire azioni programmatiche sulla tua app CDK.

import { Toolkit } from '@aws-cdk/toolkit-lib';

const toolkit = new Toolkit({
    // Optional configuration options go here
});

È possibile personalizzare l'istanza CDK Toolkit durante la creazione. Per istruzioni, consulta Configurazione dell'istanza CDK Toolkit.

Fase 3: Creazione di una fonte di assemblaggio cloud per l'app CDK

Una fonte di assemblaggio cloud fornisce istruzioni per generare CloudFormation modelli dall'app CDK. Puoi crearne uno in diversi modi. Di seguito sono riportati alcuni esempi:

  1. Una funzione di creazione di assemblaggi in linea:

    import * as cdk from 'aws-cdk-lib';

const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
  const app = new cdk.App();
  new MyStack(app, 'MyStack');
  return app.synth();
});

  2. Un file dell'app CDK esistente:

    const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");

Per ulteriori informazioni, consulta Configurare le fonti di assemblaggio cloud.

Fase 4: Definizione delle azioni programmatiche per l'app CDK

Ora che avete creato un'istanza di CDK Toolkit e una fonte di assemblaggio cloud, potete iniziare a definire le azioni programmatiche. Di seguito è riportato un esempio di base che crea una distribuzione dello stack: MyStack

import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib';

await toolkit.deploy(cloudAssemblySource, {
  stacks: {
    strategy: StackSelectionStrategy.PATTERN_MUST_MATCH, // Deploy only stacks that exactly match the provided patterns
    patterns: ["MyStack"],
  },
});

Fase 5: Personalizzazione ulteriore del CDK Toolkit

È possibile configurare e personalizzare ulteriormente il CDK Toolkit in base alle proprie esigenze:

Risorse aggiuntive

Per ulteriori informazioni sul pacchetto CDK Toolkit Library, consultate il npm pacchetto @aws ReadMenpm-cdk/toolkit-lib.

Per informazioni di riferimento sulle API, consultate il riferimento all'API CDK Toolkit Library.