

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.

# Ajouter une action d'approbation manuelle à un pipeline dans CodePipeline
<a name="approvals-action-add"></a>

Vous pouvez ajouter une action d'approbation à une étape d'un CodePipeline pipeline au point où vous souhaitez que le pipeline s'arrête afin que quelqu'un puisse approuver ou rejeter manuellement l'action. 

**Note**  
Les actions d'approbation ne peuvent pas être ajoutées aux étapes Source. Les étapes Source peuvent uniquement contenir des actions source. 

Si vous souhaitez utiliser Amazon SNS pour envoyer des notifications lorsqu'une action d'approbation est prête à être révisée, vous devez d'abord remplir les conditions préalables suivantes : 
+ Autorisez votre rôle CodePipeline de service à accéder aux ressources Amazon SNS. Pour plus d'informations, consultez [Accorder des autorisations Amazon SNS à un rôle de service CodePipeline](approvals-service-role-permissions.md).
+ Accordez l'autorisation à une ou plusieurs identités IAM de votre organisation pour mettre à jour le statut d'une action d'approbation. Pour plus d'informations, consultez [Accorder des autorisations d'approbation à un utilisateur IAM dans CodePipeline](approvals-iam-permissions.md).

Dans cet exemple, vous créez une nouvelle étape d'approbation et ajoutez une action d'approbation manuelle à cette étape. Vous pouvez également ajouter une action d'approbation manuelle à une étape existante contenant d'autres actions.

## Ajouter une action d'approbation manuelle à un CodePipeline pipeline (console)
<a name="approvals-action-add-console"></a>

Vous pouvez utiliser la CodePipeline console pour ajouter une action d'approbation à un CodePipeline pipeline existant. Vous devez utiliser la AWS CLI si vous souhaitez ajouter des actions d'approbation lorsque vous créez un nouveau pipeline. 

1. Ouvrez la CodePipeline console à l'adresse [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

1. Dans **Nom**, choisissez le pipeline.

1. Sur la page des détails du pipeline, choisissez **Edit**.

1. Si vous souhaitez ajouter une action d'approbation à une nouvelle étape, choisissez **\$1 Add stage (\$1 Ajouter une étape)** à l'endroit du pipeline où vous voulez ajouter une demande d'approbation et nommez l'étape. Dans la page **Add stage (Ajouter une étape)**, dans **Stage name (Nom de l'étape)**, entrez le nom de la nouvelle étape. Par exemple, ajoutez une nouvelle étape et nommez-la `Manual_Approval`.

   Si vous souhaitez ajouter une action d'approbation à une étape existante, choisissez **Modifier une étape**. 

1. Dans l'étape où vous souhaitez ajouter l'action d'approbation, choisissez **\$1 Add action group (\$1 Ajouter un groupe d'actions)**.

1. Sur la page **Modifier l'action**, procédez comme suit :

   1. Dans **Action name (Nom de l'action)**, saisissez un nom pour identifier l'action.

   1. Dans **Fournisseur d'action**, sous **Approbation**, choisissez **Approbation manuelle**.

   1. (Facultatif) Dans **ARN de la rubrique SNS**, choisissez le nom de la rubrique à utiliser pour envoyer des notifications pour l'action d'approbation.

   1. (Facultatif) Dans **URL pour la révision**, saisissez l'URL de la page ou de l'application que vous souhaitez que l'approbateur examine. Les approbateurs peuvent accéder à cette URL via un lien inclus dans la vue de la console du pipeline. 

   1. (Facultatif) Dans **Commentaires**, saisissez toute autre information que vous souhaitez partager avec le vérificateur.

   1. Choisissez **Enregistrer**.

## Ajouter une action d'approbation manuelle à un CodePipeline pipeline (CLI)
<a name="approvals-action-add-cli"></a>

Vous pouvez utiliser l'interface de ligne de commande pour ajouter une action d'approbation à un pipeline existant, ou lorsque vous en créez un. Pour ce faire, vous devez inclure une action d'approbation avec le type Approbation manuelle à une étape que vous êtes en train de créer ou de modifier. 

Pour plus d'informations sur la création et la modification des pipelines, consultez [Création d'un pipeline, d'étapes et d'actions](pipelines-create.md) et [Modifier un pipeline dans CodePipeline](pipelines-edit.md).

Pour ajouter une étape à un pipeline qui inclut uniquement une action d'approbation, vous devez inclure un élément similaire à l'exemple suivant, lors de la création ou de la mise à jour du pipeline. 

**Note**  
La section `configuration` est facultative. Il s'agit juste d'une partie, et non pas de toute la structure, du fichier. Pour de plus amples informations, veuillez consulter [CodePipeline référence de structure de pipeline](reference-pipeline-structure.md).

```
{
    "name": "MyApprovalStage",
    "actions": [
        {
            "name": "MyApprovalAction",
            "actionTypeId": {
                "category": "Approval",
                "owner": "AWS",
                "version": "1",
                "provider": "Manual"
            },
            "inputArtifacts": [],
            "outputArtifacts": [],
            "configuration": {
                "NotificationArn": "arn:aws:sns:us-east-2:80398EXAMPLE:MyApprovalTopic",
                "ExternalEntityLink": "http://example.com",
                "CustomData": "The latest changes include feedback from Bob."},
            "runOrder": 1
        }
    ]
}
```

Si l'action d'approbation se trouve dans une étape qui comporte d'autres actions, la section de votre fichier JSON contenant l'étape peut être similaire à l'exemple suivant.

**Note**  
La section `configuration` est facultative. Il s'agit juste d'une partie, et non pas de toute la structure, du fichier. Pour de plus amples informations, veuillez consulter [CodePipeline référence de structure de pipeline](reference-pipeline-structure.md).

```
,
{
    "name": "Production",
    "actions": [
        {
            "inputArtifacts": [],
            "name": "MyApprovalAction",
            "actionTypeId": {
                "category": "Approval",
                "owner": "AWS",
                "version": "1",
                "provider": "Manual"
            },
            "outputArtifacts": [],
            "configuration": {
                "NotificationArn": "arn:aws:sns:us-east-2:80398EXAMPLE:MyApprovalTopic",
                "ExternalEntityLink": "http://example.com",
                "CustomData": "The latest changes include feedback from Bob."
            },
            "runOrder": 1
        },
        {
            "inputArtifacts": [
                {
                    "name": "MyApp"
                }
            ],
            "name": "MyDeploymentAction",
            "actionTypeId": {
                "category": "Deploy",
                "owner": "AWS",
                "version": "1",
                "provider": "CodeDeploy"
            },
            "outputArtifacts": [],
            "configuration": {
                "ApplicationName": "MyDemoApplication",
                "DeploymentGroupName": "MyProductionFleet"
            },
            "runOrder": 2
        }
    ]
}
```