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.
# Associer un environnement à une action
Lorsque vous associez un environnement à une [action de flux de travail prise en charge](deploy-environments.md#deploy-environments-supported), le rôle IAM par défaut de l'environnement et le VPC Amazon optionnel sont affectés à l'action. Compte AWS L'action peut ensuite se connecter et se déployer à l' Compte AWS aide du rôle IAM, et également se connecter au VPC Amazon optionnel.
Suivez les instructions ci-dessous pour associer un environnement à une action.
## Étape 1 : associer l'environnement à une action de flux de travail
Utilisez la procédure suivante pour associer un environnement à une action de flux de travail.
------
#### [ Visual ]
**Pour associer un environnement à une action de flux de travail à 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. Dans le diagramme du flux de travail, choisissez une action prise en charge par les environnements. Pour de plus amples informations, veuillez consulter [Quelles actions permettent d'afficher leurs informations de déploiement CodeCatalyst ?](deploy-environments.md#deploy-environments-supported-targets).
1. Choisissez l'onglet **Configuration** et spécifiez les informations dans le champ **Environnement**, comme suit.
**Environnement**
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).
1. (Facultatif) Modifiez le rôle IAM associé à l'action. Vous souhaiterez peut-être modifier le rôle s'il contient le mauvais ensemble d'autorisations pour l'action.
Pour modifier le rôle, procédez comme suit :
1. Dans le **What's in {{my-environment}} ?** case, et choisissez l'icône représentant des points de suspension verticaux ().
1. Sélectionnez l’une des méthodes suivantes :
+ **Changez de rôle**. Choisissez cette option pour modifier le rôle IAM utilisé par cette action, et uniquement par cette action. Les autres actions continuent d'utiliser le rôle IAM par défaut spécifié dans leur environnement associé. Pour de plus amples informations, veuillez consulter [Modifier le rôle IAM d'une action](deploy-environments-switch-role.md).
+ **Modifier l'environnement**. Choisissez cette option pour modifier le rôle IAM par défaut répertorié dans votre environnement. Lorsque vous choisissez cette option, votre action, ainsi que toute autre action associée au même environnement, commence à utiliser le nouveau rôle IAM par défaut.
**Important**
Soyez prudent lorsque vous mettez à jour le rôle IAM par défaut. La modification du rôle peut entraîner l'échec de l'action si les autorisations associées au rôle ne sont pas suffisantes pour toutes les actions qui partagent l'environnement.
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**.
------
#### [ YAML ]
**Pour associer un environnement à une action de flux de travail à 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. Dans l'action de flux de travail que vous souhaitez associer à un environnement, ajoutez un code similaire au suivant :
```
{{action-name}}:
Environment:
Name: {{environment-name}}
```
Pour plus d'informations, consultez la [Types d'action](workflows-actions.md#workflows-actions-types) rubrique. Cette rubrique contient des liens vers la documentation de chaque action, y compris sa référence YAML.
1. (Facultatif) Si vous souhaitez que l'action utilise un rôle différent du rôle IAM par défaut répertorié dans l'environnement, ajoutez une `Connections:` section qui inclut le rôle que vous souhaitez utiliser. Pour de plus amples informations, veuillez consulter [Modifier le rôle IAM d'une action](deploy-environments-switch-role.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**.
------
## Étape 2 : remplir la page des activités de déploiement
Après avoir associé un environnement à une action de flux de travail, vous pouvez renseigner les pages **Activité de déploiement** et **Cible de déploiement** dans la section **Environnements** de la CodeCatalyst console avec des informations de déploiement. Suivez les instructions ci-dessous pour remplir ces pages.
**Note**
Seules quelques actions permettent d'afficher leurs informations de déploiement dans la CodeCatalyst console. Pour de plus amples informations, veuillez consulter [Quelles actions permettent d'afficher leurs informations de déploiement CodeCatalyst ?](deploy-environments.md#deploy-environments-supported-targets).
**Pour ajouter des informations de déploiement à CodeCatalyst**
1. Si une exécution de flux de travail ne démarrait pas automatiquement lorsque vous avez validé vos modifications[Étape 1 : associer l'environnement à une action de flux de travail](#deploy-environments-add-app-to-environment-assoc), lancez-la manuellement comme suit :
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. Cliquez sur **Exécuter**.
L'exécution du flux de travail lance un nouveau déploiement, ce qui CodeCatalyst entraîne l'ajout d'informations de déploiement à CodeCatalyst.
1. Vérifiez que l'activité de déploiement a été ajoutée à la CodeCatalyst console :
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Environments.**
1. Choisissez votre environnement (par exemple,`Production`).
1. Choisissez l'onglet **Activité de déploiement** et vérifiez qu'un déploiement apparaît avec **le statut** **RÉUSSI**. Cela indique qu'un flux de travail exécuté a correctement déployé les ressources de votre application.
1. Choisissez l'onglet **Cibles de déploiement** et vérifiez que les ressources de votre application apparaissent.