Environnements - AWS Cloud Development Kit (AWS CDK) v2

Ceci est le guide du AWS CDK développeur de la version 2. L'ancien CDK v1 est entré en maintenance le 1er juin 2022 et a pris fin le 1er juin 2023.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Environnements

Un environnement comprend le Compte AWS et sur Région AWS lequel vous déployez une AWS Cloud Development Kit (AWS CDK) pile.

Compte AWS

Lorsque vous créez un Compte AWS, vous recevez un identifiant de compte. Cet identifiant est un numéro à 12 chiffres, tel que 012345678901, qui identifie de manière unique votre compte. Pour en savoir plus, voir Afficher les Compte AWS identifiants dans le Guide de AWS Account Management référence.

Région AWS

Régions AWS sont nommés en utilisant une combinaison de localisation géographique et d'un numéro représentant une zone de disponibilité dans la région. Par exemple, us-east-1représente une zone de disponibilité dans la région USA Est (Virginie du Nord). Pour en savoir plus Régions AWS, consultez Régions et zones de disponibilité. Pour obtenir la liste des codes régionaux, voir Points de terminaison régionaux dans le Guide de référence AWS général.

Ils AWS CDK peuvent déterminer les environnements à partir de vos informations d'identification et de vos fichiers de configuration. Ces fichiers peuvent être créés et gérés avec le AWS Command Line Interface (AWS CLI). Voici un exemple de base de ces fichiers :

Fichier d'informations d'identification

[default] aws_access_key_id=ASIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE [user1] aws_access_key_id=ASIAI44QH8DHBEXAMPLE aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY aws_session_token = fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

Fichier de configuration

[default] region=us-west-2 output=json [profile user1] region=us-east-1 output=text

Vous pouvez transmettre les informations d'environnement de ces fichiers dans votre code CDK par le biais de variables d'environnement fournies par le CDK. Lorsque vous exécutez une CLI commande CDK, par exemplecdk deploy, vous fournissez le profil à partir de vos informations d'identification et de vos fichiers de configuration pour recueillir des informations sur l'environnement.

Voici un exemple de spécification de ces variables d'environnement dans votre code CDK :

new MyDevStack(app, 'dev', { env: { account: process.env.CDK_DEFAULT_ACCOUNT, region: process.env.CDK_DEFAULT_REGION }});

Voici un exemple de transmission de valeurs associées au user1 profil à partir de vos informations d'identification et de vos fichiers de configuration au CDK à l'CLIaide de l'--profileoption. Les valeurs de ces fichiers seront transmises à vos variables d'environnement :

$ cdk deploy myStack --profile user1

Au lieu d'utiliser les valeurs des informations d'identification et des fichiers de configuration, vous pouvez également coder en dur les valeurs d'environnement dans votre code CDK. Voici un exemple :

const envEU = { account: '238383838383', region: 'eu-west-1' }; const envUSA = { account: '837873873873', region: 'us-west-2' }; new MyFirstStack(app, 'first-stack-us', { env: envUSA }); new MyFirstStack(app, 'first-stack-eu', { env: envEU });

En savoir plus

Pour commencer à utiliser des environnements dotés du AWS CDK, voirConfigurer les environnements à utiliser avec AWS CDK.