Environnements pour AWS CDK - AWS Cloud Development Kit (AWS CDK) v2
En savoir plus

Ceci est le guide du AWS CDK développeur de la version 2. L'ancienne CDK version 1 est entrée 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 pour AWS CDK

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, consultez la section Afficher Compte AWS les 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 la section Régions et zones de disponibilité. Pour obtenir la liste des codes de région, consultez la section 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 CDK code par le biais de variables d'environnement fournies par leCDK. Lorsque vous exécutez une CDK CLI commande, 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 CDK code :

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 à l'CDKCLIutilisation 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 CDK code. 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.