

Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).

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.

# Démarrage d'une AWS CDK application à l'aide d'un flux de travail
<a name="cdk-boot-action"></a>

Cette section décrit comment démarrer une AWS CDK application à l'aide d'un CodeCatalyst flux de travail. Pour ce faire, vous devez ajouter l'action **AWS CDK bootstrap** à votre flux de travail. L'action **AWS CDK bootstrap** fournit une pile bootstrap dans votre AWS environnement à l'aide du modèle [moderne](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-template). Si une pile bootstrap existe déjà, l'action la met à jour si nécessaire. La présence d'une pile bootstrap AWS est une condition préalable au déploiement d'une AWS CDK application.

*Pour plus d'informations sur le bootstrapping, voir [Bootstrapping](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) dans le manuel du développeur.AWS Cloud Development Kit (AWS CDK) *

**Topics**
+ [Quand utiliser l'action « AWS CDK  bootstrap »](#cdk-boot-action-when-to-use)
+ [Comment fonctionne l'action « AWS CDK  bootstrap »](#cdk-boot-action-how-it-works)
+ [Versions de la CLI CDK utilisées par l'action « AWS CDK  bootstrap »](#cdk-boot-action-cdk-version)
+ [Image d'exécution utilisée par l'action « AWS CDK  bootstrap »](#cdk-boot-action-runtime)
+ [Exemple : démarrage d'une application AWS CDK](cdk-boot-action-example-workflow.md)
+ [Ajouter l'action « AWS CDK  bootstrap »](cdk-boot-action-add.md)
+ [variables « AWS CDK  bootstrap »](cdk-boot-action-variables.md)
+ [action 'AWS CDK bootstrap' YAML](cdk-boot-action-ref.md)

## Quand utiliser l'action « AWS CDK  bootstrap »
<a name="cdk-boot-action-when-to-use"></a>

Utilisez cette action si vous disposez d'un flux de travail qui déploie une AWS CDK application et que vous souhaitez déployer (et mettre à jour, si nécessaire) la pile bootstrap en même temps. Dans ce cas, vous devez ajouter l'action **AWS CDK bootstrap** au même flux de travail que celui qui déploie votre AWS CDK application.

**N'utilisez pas** cette action si l'une des conditions suivantes s'applique :
+ Vous avez déjà déployé une pile de bootstrap à l'aide d'un autre mécanisme et vous souhaitez la conserver intacte (aucune mise à jour).
+ Vous souhaitez utiliser un modèle de [bootstrap personnalisé](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing), qui n'est pas pris en charge par l'action **AWS CDK bootstrap.**

## Comment fonctionne l'action « AWS CDK  bootstrap »
<a name="cdk-boot-action-how-it-works"></a>

Le **AWS CDK bootstrap** fonctionne de la manière suivante :

1. [Au moment de l'exécution, si vous avez spécifié la version 1.0.7 ou une version antérieure de l'action, celle-ci télécharge la dernière CLI CDK (également appelée AWS CDK Tookit) sur l'image de construction. CodeCatalyst ](build-images.md)

   Si vous avez spécifié la version 1.0.8 ou ultérieure, l'action est fournie avec une [version spécifique](cdk-dep-action.md#cdk-dep-action-cdk-version) de la CLI CDK, de sorte qu'aucun téléchargement n'a lieu.

1. L'action utilise la CLI CDK pour exécuter la `cdk bootstrap` commande. *Cette commande exécute les tâches d'amorçage décrites dans la rubrique [Bootstrapping](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) du Guide du développeur.AWS Cloud Development Kit (AWS CDK) *

## Versions de la CLI CDK utilisées par l'action « AWS CDK  bootstrap »
<a name="cdk-boot-action-cdk-version"></a>

Le tableau suivant indique quelle version de la CLI CDK est utilisée par défaut par les différentes versions de l'action **AWS CDK bootstrap.**

**Note**  
Vous pouvez peut-être remplacer la valeur par défaut. Pour plus d’informations, consultez [CdkCliVersion](cdk-boot-action-ref.md#cdk.boot.cdk.cli.version) dans le [action 'AWS CDK bootstrap' YAML](cdk-boot-action-ref.md).


| version de l'AWS CDK action « bootstrap » | AWS CDK Version de la CLI | 
| --- | --- | 
|  10,0 — 1,0,7  |  dernières  | 
|  1.0.8 ou version ultérieure  |  2,99,1  | 

## Image d'exécution utilisée par l'action « AWS CDK  bootstrap »
<a name="cdk-boot-action-runtime"></a>

Le tableau suivant présente les images de l'environnement d'exécution CodeCatalyst utilisées pour exécuter différentes versions de l'action **AWS CDK bootstrap**. Les images incluent différents ensembles d'outillage préinstallés. Pour de plus amples informations, veuillez consulter [Images actives](build-images.md#build-curated-images).

**Note**  
Nous vous recommandons de mettre à niveau votre action **AWS CDK bootstrap** vers la version 2.x pour tirer parti des derniers outils disponibles sur l'image de mars 2024. Pour mettre à niveau l'action, définissez sa `Identifier` propriété sur `aws/cdk-bootstrap@v2` dans le fichier de définition de votre flux de travail. Pour de plus amples informations, veuillez consulter [action « AWS CDK  déployer » YAML](cdk-dep-action-ref.md). 


| version de l'AWS CDK action « bootstrap » | Images de l'environnement d'exécution | 
| --- | --- | 
|  1.x  |  Images du mois de novembre 2022  | 
|  2.x  |  Images du mois de mars 2024  | 

# Exemple : démarrage d'une application AWS CDK
<a name="cdk-boot-action-example-workflow"></a>

Reportez-vous au [Exemple : déploiement d'une AWS CDK application](cdk-dep-action-example-workflow.md) in [Déploiement d'une AWS CDK application avec un flux de travail](cdk-dep-action.md) pour un flux de travail incluant l'action **AWS CDK bootstrap.**

# Ajouter l'action « AWS CDK  bootstrap »
<a name="cdk-boot-action-add"></a>

 Suivez les instructions ci-dessous pour ajouter l'action **AWS CDK bootstrap** à votre flux de travail. 

**Avant de commencer**

Avant de pouvoir utiliser l'action **AWS CDK bootstrap**, assurez-vous qu'une AWS CDK application est prête. L'action bootstrap synthétisera l' AWS CDK application avant le démarrage. Vous pouvez écrire votre application dans n'importe quel langage de programmation pris en charge par le AWS CDK.

Assurez-vous que les fichiers de votre AWS CDK application sont disponibles dans :
+ Un [référentiel CodeCatalyst source](source.md), ou 
+ [Artefact CodeCatalyst de sortie](workflows-working-artifacts.md) généré par une autre action du flux de travail

------
#### [ Visual ]

**Pour ajouter l'action « AWS CDK  bootstrap » à l'aide de l'éditeur visuel**

1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Choisissez votre projet.

1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**

1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.

1. Choisissez **Modifier**.

1. Choisissez **Visual**.

1. En haut à gauche, choisissez **\$1 Actions** pour ouvrir le catalogue d'actions.

1. Dans la liste déroulante, sélectionnez **Amazon CodeCatalyst**.

1. Recherchez l'action **AWS CDK bootstrap**, puis effectuez l'une des opérations suivantes :
   + Choisissez le signe plus (**\$1**) pour ajouter l'action au diagramme de flux de travail et ouvrir son volet de configuration.

     Or
   + Choisissez **AWS CDK bootstrap.** La boîte de dialogue des détails de l'action apparaît. Dans cette boîte de dialogue :
     + (Facultatif) Choisissez **Afficher la source** pour [afficher le code source de l'action](workflows-view-source.md#workflows-view-source.title).
     + Choisissez **Ajouter au flux de travail** pour ajouter l'action au diagramme du flux de travail et ouvrir son volet de configuration.

1. Dans les onglets **Entrées**, **Configuration** et **Sorties**, complétez les champs en fonction de vos besoins. Pour une description de chaque champ, consultez le[action 'AWS CDK bootstrap' YAML](cdk-boot-action-ref.md). Cette référence fournit des informations détaillées sur chaque champ (et la valeur de propriété YAML correspondante) tel qu'il apparaît dans les éditeurs YAML et visuels.

1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.

1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
**Note**  
Si votre action **AWS CDK bootstrap** échoue avec une `npm install` erreur, consultez [Comment corriger les erreurs « npm install » ?](troubleshooting-workflows.md#troubleshooting-workflows-npm) pour savoir comment corriger l'erreur.

------
#### [ YAML ]

**Pour ajouter l'action « AWS CDK  bootstrap » à l'aide de l'éditeur YAML**

1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Choisissez votre projet.

1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**

1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.

1. Choisissez **Modifier**.

1. Choisissez **YAML.**

1. En haut à gauche, choisissez **\$1 Actions** pour ouvrir le catalogue d'actions.

1. Dans la liste déroulante, sélectionnez **Amazon CodeCatalyst**.

1. Recherchez l'action **AWS CDK bootstrap**, puis choisissez **\$1** pour l'ajouter au diagramme de flux de travail et ouvrir son volet de configuration.

1. Modifiez les propriétés du code YAML en fonction de vos besoins. Une explication de chaque propriété disponible est fournie dans le[action 'AWS CDK bootstrap' YAML](cdk-boot-action-ref.md).

1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.

1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
**Note**  
Si votre action **AWS CDK bootstrap** échoue avec une `npm install` erreur, consultez [Comment corriger les erreurs « npm install » ?](troubleshooting-workflows.md#troubleshooting-workflows-npm) pour savoir comment corriger l'erreur.

------

# variables « AWS CDK  bootstrap »
<a name="cdk-boot-action-variables"></a>

L'action **AWS CDK bootstrap** produit et définit les variables suivantes au moment de l'exécution. Ces variables sont connues sous le nom de *variables prédéfinies*.

Pour plus d'informations sur le référencement de ces variables dans un flux de travail, consultez[Utilisation de variables prédéfinies](workflows-using-predefined-variables.md).


| Clé | Valeur | 
| --- | --- | 
|  plate-forme-de-déploiement  |  Nom de la plateforme de déploiement. Codé en dur pour. `AWS:CloudFormation`  | 
|  region  |  Le code de région dans Région AWS lequel la pile AWS CDK bootstrap a été déployée lors de l'exécution du flux de travail. Exemple : `us-west-2`  | 
|  identifiant de pile  |  Le nom de ressource Amazon (ARN) de la pile AWS CDK bootstrap déployée. Exemple : `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-bootstrap-stack/6aad4380-100a-11ec-a10a-03b8a84d40df`  | 
|  SAUTER LE DÉPLOIEMENT  |  La valeur de `true` indique que le déploiement de votre stack AWS CDK bootstrap a été ignoré lors de l'exécution du flux de travail. Un déploiement de pile sera ignoré s'il n'y a aucun changement dans la pile depuis le dernier déploiement. Cette variable n'est produite que si sa valeur est`true`. Codé en dur pour. `true`  | 

# action 'AWS CDK bootstrap' YAML
<a name="cdk-boot-action-ref"></a>

Voici la définition YAML de l'action **AWS CDK bootstrap.** Pour savoir comment utiliser cette action, consultez[Démarrage d'une AWS CDK application à l'aide d'un flux de travail](cdk-boot-action.md).

Cette définition d'action existe sous la forme d'une section au sein d'un fichier de définition de flux de travail plus large. Pour plus d’informations sur ce fichier, consultez [Définition du flux de travail YAML](workflow-reference.md).

**Note**  
La plupart des propriétés YAML suivantes ont des éléments d'interface utilisateur correspondants dans l'éditeur visuel. Pour rechercher un élément de l'interface utilisateur, utilisez **Ctrl\$1F**. L'élément sera répertorié avec sa propriété YAML associée.

```
# The workflow definition starts here.
# See Propriétés de haut niveau for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.    
  CDKBootstrapAction\$1nn: 
    Identifier: aws/cdk-bootstrap@v2
    DependsOn:
      - action-name
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Inputs:
      # Specify a source or an artifact, but not both.
      Sources:
        - source-name-1
      Artifacts:
        - artifact-name
    Outputs:
      Artifacts:
        - Name: cdk_bootstrap_artifacts
          Files: 
            - "cdk.out/**/*"
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: iam-role-name
    Configuration:
      Region: us-west-2
      CdkCliVersion: version
```

## CDKBootstrapAction
<a name="cdk.boot.name"></a>

(Obligatoire)

Spécifiez le nom de l'action. Tous les noms d'action doivent être uniques dans le flux de travail. Les noms d'action sont limités aux caractères alphanumériques (a-z, A-Z, 0-9), aux tirets (-) et aux traits de soulignement (\$1). Les espaces ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les caractères spéciaux et les espaces dans les noms d'action.

Par défaut : `CDKBootstrapAction_nn`.

Interface utilisateur correspondante : onglet Configuration/nom **d'affichage de l'action**

## Identifier
<a name="cdk.boot.identifier"></a>

(*CDKBootstrapAction*/**Identifier**)

(Obligatoire)

Identifie l'action. Ne modifiez pas cette propriété, sauf si vous souhaitez modifier la version. Pour de plus amples informations, veuillez consulter [Spécification de la version de l'action à utiliser](workflows-action-versions.md).

**Note**  
La spécification `aws/cdk-bootstrap@v2` entraîne l'exécution de l'action sur l'[image de mars 2024](build-images.md#build.default-image) qui inclut des outils plus récents tels que Node.js 18. La spécification `aws/cdk-bootstrap@v1` entraîne l'exécution de l'action sur l'[image de novembre 2022](build-images.md#build.previous-image) qui inclut des outils plus anciens tels que Node.js 16.

Par défaut : `aws/cdk-bootstrap@v2`.

**Interface utilisateur correspondante : diagramme de flux de travail/ CDKBootstrapAction \$1nn/ aws/cdk-bootstrap @v2 label**

## DependsOn
<a name="cdk.boot.dependson"></a>

(*CDKBootstrapAction*/**DependsOn**)

(Facultatif)

Spécifiez une action, un groupe d'actions ou une porte qui doit s'exécuter correctement pour que cette action soit exécutée.

Pour plus d'informations sur la fonctionnalité « dépend », consultez. [Actions de séquençage](workflows-depends-on.md)

Interface utilisateur correspondante : onglet **Entrées/dépend de - facultatif**

## Compute
<a name="cdk.boot.computename"></a>

(*CDKBootstrapAction*/**Compute**)

(Facultatif)

Le moteur informatique utilisé pour exécuter les actions de votre flux de travail. Vous pouvez spécifier le calcul au niveau du flux de travail ou au niveau de l'action, mais pas les deux. Lorsqu'elle est spécifiée au niveau du flux de travail, la configuration de calcul s'applique à toutes les actions définies dans le flux de travail. Au niveau du flux de travail, vous pouvez également exécuter plusieurs actions sur la même instance. Pour de plus amples informations, veuillez consulter [Partage du calcul entre les actions](compute-sharing.md).

Interface utilisateur correspondante : *aucune*

## Type
<a name="cdk.boot.computetype"></a>

(*CDKBootstrapAction*/Compute/**Type**)

(Obligatoire s'[Compute](#cdk.boot.computename)il est inclus)

Type de moteur de calcul. Vous pouvez utiliser l'une des valeurs suivantes :
+ **EC2**(éditeur visuel) ou `EC2` (éditeur YAML)

  Optimisé pour la flexibilité lors des courses d'action.
+ **Lambda** (éditeur visuel) ou `Lambda` (éditeur YAML)

  Vitesses de démarrage des actions optimisées.

Pour plus d'informations sur les types de calcul, veuillez consulter [Types de calcul](workflows-working-compute.md#compute.types).

**Interface utilisateur correspondante : Configuration tab/Advanced - optionnel/ Type de calcul**

## Fleet
<a name="cdk.boot.computefleet"></a>

(*CDKBootstrapAction*/Compute/**Fleet**)

(Facultatif)

Spécifiez la machine ou le parc qui exécutera votre flux de travail ou vos actions de flux de travail. Dans le cas des flottes à la demande, lorsqu'une action démarre, le flux de travail fournit les ressources dont il a besoin et les machines sont détruites à la fin de l'action. Exemples de flottes à la demande :`Linux.x86-64.Large`,`Linux.x86-64.XLarge`. Pour plus d'informations sur les flottes à la demande, consultez[Propriétés de la flotte à la demande](workflows-working-compute.md#compute.on-demand).

Avec les flottes provisionnées, vous configurez un ensemble de machines dédiées pour exécuter les actions de votre flux de travail. Ces machines restent inactives, prêtes à exécuter des actions immédiatement. Pour plus d'informations sur les flottes provisionnées, consultez. [Propriétés de la flotte de véhicules provisionnée](workflows-working-compute.md#compute.provisioned-fleets)

S'il `Fleet` est omis, la valeur par défaut est`Linux.x86-64.Large`.

**Interface utilisateur correspondante : Configuration tab/Advanced - optionnel/ Parc de calcul**

## Timeout
<a name="cdk.boot.timeout"></a>

(*CDKBootstrapAction*/**Timeout**)

(Obligatoire)

Spécifiez la durée en minutes (éditeur YAML) ou en heures et minutes (éditeur visuel) pendant laquelle l'action peut être exécutée avant la CodeCatalyst fin de l'action. Le minimum est de 5 minutes et le maximum est décrit dans[Quotas pour les flux de travail dans CodeCatalyst](workflows-quotas.md). Le délai d'expiration par défaut est le même que le délai d'expiration maximal.

Interface utilisateur correspondante : onglet **Configuration/Délai d'expiration - facultatif**

## Inputs
<a name="cdk.boot.inputs"></a>

(*CDKBootstrapAction*/**Inputs**)

(Facultatif)

La `Inputs` section définit les données dont l'action **AWS CDK bootstrap** a besoin lors de l'exécution d'un flux de travail.

Interface utilisateur correspondante : onglet **Entrées**

**Note**  
Une seule entrée (source ou artefact) est autorisée pour chaque action d'**AWS CDK amorçage.**

## Sources
<a name="cdk.boot.inputs.sources"></a>

(*CDKBootstrapAction*/Inputs/**Sources**)

(Obligatoire si votre AWS CDK application est stockée dans un référentiel source)

Si votre AWS CDK application est stockée dans un référentiel source, spécifiez l'étiquette de ce référentiel source. L'action **AWS CDK bootstrap** synthétise l'application dans ce référentiel avant de démarrer le processus de démarrage. Actuellement, la seule étiquette de référentiel prise en charge est`WorkflowSource`.

Si votre AWS CDK application n'est pas contenue dans un référentiel source, elle doit résider dans un artefact généré par une autre action.

Pour plus d'informations sur les sources, consultez [Connecter les référentiels sources aux flux de travail](workflows-sources.md).

Interface utilisateur correspondante : onglet **Entrées/Sources - facultatif**

## Artifacts - input
<a name="cdk.boot.inputs.artifacts"></a>

(*CDKBootstrapAction*/Inputs/**Artifacts**)

(Obligatoire si votre AWS CDK application est stockée dans un [artefact de sortie](workflows-working-artifacts-output.md) d'une action précédente)

Si votre AWS CDK application est contenue dans un artefact généré par une action précédente, spécifiez cet artefact ici. L'action **AWS CDK bootstrap** synthétise l'application contenue dans l'artefact spécifié dans un CloudFormation modèle avant de démarrer le processus d'amorçage. Si votre AWS CDK application n'est pas contenue dans un artefact, elle doit résider dans votre référentiel source.

Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md).

Interface utilisateur correspondante : onglet **Entrées/Artefacts - facultatif**

## Outputs
<a name="cdk.boot.outputs"></a>

(*CDKBootstrapAction*/**Outputs**)

(Facultatif)

Définit les données produites par l'action lors de l'exécution d'un flux de travail.

Interface utilisateur correspondante : onglet **Sorties**

## Artifacts - output
<a name="cdk.boot.outputs.artifacts"></a>

(*CDKBootstrapAction*/Outputs/**Artifacts**)

(Facultatif)

Spécifiez les artefacts générés par l'action. Vous pouvez faire référence à ces artefacts en tant qu'entrée dans d'autres actions.

Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md).

**Interface utilisateur correspondante : onglet Sorties/Artefacts**

## Name
<a name="cdk.boot.outputs.artifacts.name"></a>

(*CDKBootstrapAction*/Outputs/Artifacts/**Name**)

(Obligatoire s'[Artifacts - output](#cdk.boot.outputs.artifacts)il est inclus)

Spécifiez le nom de l'artefact qui contiendra le CloudFormation modèle synthétisé par l'action **AWS CDK bootstrap** lors de l'exécution. La valeur par défaut est `cdk_bootstrap_artifacts`. Si vous ne spécifiez aucun artefact, l'action synthétise le modèle, mais ne l'enregistre pas dans un artefact. Envisagez d'enregistrer le modèle synthétisé dans un artefact afin d'en conserver une trace à des fins de test ou de dépannage.

**Interface utilisateur correspondante : affiche le nom de l'tab/Artifacts/Addartefact/de l'artefact de construction**

## Files
<a name="cdk.boot.outputs.artifacts.files"></a>

(*CDKBootstrapAction*/Outputs/Artifacts/**Files**)

(Obligatoire s'[Artifacts - output](#cdk.boot.outputs.artifacts)il est inclus)

Spécifiez les fichiers à inclure dans l'artefact. Vous devez spécifier `"cdk.out/**/*"` d'inclure le CloudFormation modèle synthétisé de votre AWS CDK application.

**Note**  
`cdk.out`est le répertoire par défaut dans lequel les fichiers synthétisés sont enregistrés. Si vous avez spécifié un répertoire de sortie autre que celui `cdk.out` de votre `cdk.json` fichier, spécifiez ce répertoire ici au lieu de`cdk.out`.

Interface utilisateur correspondante : produit des tab/Artifacts/Add **artéfacts/fichiers** produits par build

## Environment
<a name="cdk.boot.environment"></a>

(*CDKBootstrapAction*/**Environment**)

(Obligatoire)

Spécifiez l' CodeCatalyst environnement à utiliser avec l'action. L'action se connecte au Compte AWS VPC Amazon facultatif spécifié dans l'environnement choisi. L'action utilise le rôle IAM par défaut spécifié dans l'environnement pour se connecter au Compte AWS, et utilise le rôle IAM spécifié dans la [connexion Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) pour se connecter à Amazon VPC.

**Note**  
Si le rôle IAM par défaut ne dispose pas des autorisations requises par l'action, vous pouvez configurer l'action pour utiliser un autre rôle. Pour de plus amples informations, veuillez consulter [Modifier le rôle IAM d'une action](deploy-environments-switch-role.md).

Pour plus d'informations sur les environnements, reportez-vous [Déploiement dans Comptes AWS et VPCs](deploy-environments.md) aux sections et[Création d'un environnement](deploy-environments-creating-environment.md).

**Interface utilisateur correspondante : onglet Configuration/Environnement**

## Name
<a name="cdk.boot.environment.name"></a>

(*CDKBootstrapAction*/Environment/**Name**)

(Obligatoire s'[Environment](#cdk.boot.environment)il est inclus)

Spécifiez le nom de l'environnement existant que vous souhaitez associer à l'action.

**Interface utilisateur correspondante : onglet Configuration/Environnement**

## Connections
<a name="cdk.boot.environment.connections"></a>

(*CDKBootstrapAction*/Environment/**Connections**)

(Facultatif dans les nouvelles versions de l'action ; obligatoire dans les anciennes versions)

Spécifiez la connexion au compte à associer à l'action. Vous pouvez spécifier un maximum d'une connexion à un compte sous`Environment`.

Si vous ne spécifiez pas de connexion au compte :
+ L'action utilise la Compte AWS connexion et le rôle IAM par défaut spécifiés dans l'environnement de la CodeCatalyst console. Pour plus d'informations sur l'ajout d'une connexion à un compte et d'un rôle IAM par défaut dans l'environnement, consultez[Création d'un environnement](deploy-environments-creating-environment.md).
+ Le rôle IAM par défaut doit inclure les politiques et les autorisations requises par l'action. Pour déterminer quelles sont ces politiques et autorisations, consultez la description de la propriété **Role** dans la documentation de définition YAML de l'action.

Pour plus d'informations sur les connexions aux comptes, consultez[Permettre l'accès aux AWS ressources avec Connected Comptes AWS](ipa-connect-account.md). Pour plus d'informations sur l'ajout d'une connexion de compte à un environnement, consultez[Création d'un environnement](deploy-environments-creating-environment.md).

Interface utilisateur correspondante : l'une des options suivantes, selon la version de l'action :
+ (Versions plus récentes) tab/Environment/What La configuration est prête *my-environment* ? **/menu à trois points/ Changer de rôle**
+ **(Anciennes versions) Onglet de configuration/' Environment/account/role AWS '/ connexion au compte**

## Name
<a name="cdk.boot.environment.connections.name"></a>

(*CDKBootstrapAction*/Environment/Connections/**Name**)

(Obligatoire s'[Connections](#cdk.boot.environment.connections)il est inclus)

Spécifiez le nom de la connexion au compte.

Interface utilisateur correspondante : l'une des options suivantes, selon la version de l'action :
+ (Versions plus récentes) tab/Environment/What La configuration est prête *my-environment* ? **/menu à trois points/ Changer de rôle**
+ **(Anciennes versions) Onglet de configuration/' Environment/account/role AWS '/ connexion au compte**

## Role
<a name="cdk.boot.environment.connections.role"></a>

(*CDKBootstrapAction*/Environment/Connections/**Role**)

(Obligatoire s'[Connections](#cdk.boot.environment.connections)il est inclus)

Spécifiez le nom du rôle IAM que l'action **AWS CDK bootstrap** utilise pour accéder à la pile bootstrap AWS et l'ajouter. Assurez-vous que vous avez [ajouté le rôle à votre CodeCatalyst espace](ipa-connect-account-addroles.md) et qu'il inclut les politiques suivantes.

Si vous ne spécifiez aucun rôle IAM, l'action utilise le rôle IAM par défaut répertorié dans l'[environnement](deploy-environments.md) de la console. CodeCatalyst Si vous utilisez le rôle par défaut dans l'environnement, assurez-vous qu'il dispose des politiques appropriées.

Vous pouvez utiliser le `CodeCatalystWorkflowDevelopmentRole-spaceName` rôle avec cette action, si vous le souhaitez. Pour plus d’informations sur ce rôle, consultez [Création du **CodeCatalystWorkflowDevelopmentRole-*spaceName***rôle pour votre compte et votre espace](ipa-iam-roles.md#ipa-iam-roles-service-create). Sachez que le `CodeCatalystWorkflowDevelopmentRole-spaceName` rôle dispose d'autorisations d'accès complètes, ce qui peut présenter un risque de sécurité. Nous vous recommandons de n'utiliser ce rôle que dans les didacticiels et les scénarios où la sécurité est moins préoccupante. 

Interface utilisateur correspondante : l'une des options suivantes, selon la version de l'action :
+ (Versions plus récentes) tab/Environment/What La configuration est prête *my-environment* ? **/menu à trois points/ Changer de rôle**
+ **(Anciennes versions) Onglet de configuration/' '/ Rôle Environment/account/role**

## Configuration
<a name="cdk.boot.configuration"></a>

(*CDKBootstrapAction*/**Configuration**)

(Obligatoire)

Section dans laquelle vous pouvez définir les propriétés de configuration de l'action.

Interface utilisateur correspondante : onglet **Configuration**

## Region
<a name="cdk.boot.region"></a>

(*CDKBootstrapAction*/Configuration/**Region**)

(Obligatoire)

Spécifiez le Région AWS lieu dans lequel la pile bootstrap sera déployée. Cette région doit correspondre à celle dans laquelle votre AWS CDK application est déployée. Pour obtenir la liste des codes de région, consultez la section [Points de terminaison régionaux](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes).

**Interface utilisateur correspondante : onglet Configuration/région**

## CdkCliVersion
<a name="cdk.boot.cdk.cli.version"></a>

(*CDKBootstrapAction*/Configuration/**CdkCliVersion**)

(Facultatif)

Cette propriété est disponible avec la version 1.0.13 ou ultérieure de l'action de **AWS CDK déploiement**, et la version 1.0.8 ou ultérieure de l'action **AWS CDK bootstrap**.

Spécifiez l’un des éléments suivants :
+ Version complète de l'interface de ligne de AWS Cloud Development Kit (AWS CDK) commande (CLI) (également appelée AWS CDK boîte à outils) que vous souhaitez utiliser pour cette action. Exemple: `2.102.1`. Pensez à spécifier une version complète pour garantir la cohérence et la stabilité lors de la création et du déploiement de votre application.

  Or
+ `latest`. Envisagez `latest` de spécifier pour tirer parti des dernières fonctionnalités et correctifs de la CLI CDK.

L'action téléchargera la version spécifiée (ou la dernière version) de la AWS CDK CLI sur l'[image de CodeCatalyst construction](build-images.md), puis utilisera cette version pour exécuter les commandes nécessaires au déploiement de votre application CDK ou au démarrage de votre AWS environnement.

Pour obtenir la liste des versions de CLI CDK prises en charge que vous pouvez utiliser, consultez la section [AWS CDK Versions](https://docs.aws.amazon.com/cdk/api/versions.html).

Si vous omettez cette propriété, l'action utilise une version de AWS CDK CLI par défaut décrite dans l'une des rubriques suivantes :
+ [Versions de la CLI CDK utilisées par l'action « AWS CDK  déploiement »](cdk-dep-action.md#cdk-dep-action-cdk-version) 
+ [Versions de la CLI CDK utilisées par l'action « AWS CDK  bootstrap »](cdk-boot-action.md#cdk-boot-action-cdk-version)

Interface utilisateur correspondante : onglet Configuration/version de la **AWS CDK CLI**