Modifier un pipeline dans CodePipeline

Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon. com/codesuite/codepipeline/home.

Les noms de tous les pipelines associés à votre AWS compte sont affichés.

Dans Name, choisissez le nom du pipeline que vous souhaitez modifier. Une vue détaillée du pipeline s'affiche alors, laquelle indique notamment l'état de chaque action, dans chaque étape du pipeline.

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

Pour modifier le type de pipeline, choisissez Modifier sur la carte Modifier : propriétés du pipeline. Choisissez l'une des options suivantes, puis cliquez sur OK.

Les types de pipelines diffèrent en termes de caractéristiques et de prix. Pour de plus amples informations, veuillez consulter Types de pipelines.

Pour modifier les variables du pipeline, choisissez Modifier les variables sur la carte Modifier : Variables. Ajoutez ou modifiez des variables pour le niveau du pipeline, puis choisissez OK.

Pour plus d'informations sur les variables au niveau du pipeline, consultezRéférence aux variables. Pour un didacticiel avec une variable au niveau du pipeline transmise au moment de l'exécution du pipeline, voir. Tutoriel : Utiliser des variables au niveau du pipeline

Pour modifier les déclencheurs du pipeline, choisissez Modifier les déclencheurs sur la carte Modifier : déclencheurs. Ajoutez ou modifiez des déclencheurs, puis choisissez OK.

Pour plus d'informations sur l'ajout de déclencheurs, consultez les étapes de création d'une connexion à Bitbucket Cloud GitHub (via GitHub App), GitHub Enterprise Server, GitLab .com ou GitLab autogérée, telles que. GitHub connexions

Pour modifier les étapes et les actions sur la page d'édition, effectuez l'une des opérations suivantes :

Par exemple, si vous souhaitez ajouter une action en série à une étape dans un pipeline :

Lorsque vous avez terminé de modifier votre pipeline, cliquez sur Enregistrer les modifications du pipeline pour revenir à la page récapitulative.

Pour tester votre action, choisissez Release change pour traiter cette validation via le pipeline et valider une modification de la source spécifiée dans l'étape source du pipeline. Ou suivez les étapes décrites Lancement manuel d'un pipeline pour utiliser le AWS CLI pour publier manuellement une modification.

Ouvrez une session de terminal (Linux, macOS ou Unix) ou une invite de commande (Windows) et exécutez la get-pipeline commande pour copier la structure du pipeline dans un fichier JSON. Par exemple, pour un pipeline nommé MyFirstPipeline, saisissez la commande suivante :

aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

Cette commande ne renvoie rien, mais le fichier que vous avez créé doit apparaître dans le répertoire où vous avez exécuté la commande.

Ouvrez le fichier JSON dans un éditeur de texte brut et modifiez la structure du fichier pour refléter les modifications que vous souhaitez apporter au pipeline. Par exemple, vous pouvez ajouter ou supprimer des étapes, ou ajouter une autre action à une étape.

L'exemple suivant montre comment ajouter une autre étape de déploiement dans le fichier pipeline.json. Cette étape s'exécute après la première étape de déploiement nomméeStaging.

,      
        {
            "name": "Staging",
            "actions": [
                    {
                        "inputArtifacts": [
                            {
                                "name": "MyApp"
                            }
                        ],
                        "name": "Deploy-CodeDeploy-Application",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                            "ApplicationName": "CodePipelineDemoApplication",
                            "DeploymentGroupName": "CodePipelineDemoFleet"
                        },
                        "runOrder": 1
                    }
                ]
             },      
        {
            "name": "Production",
            "actions":  [
                    {
                        "inputArtifacts": [
                            {
                                "name": "MyApp"
                            }
                        ],
                        "name": "Deploy-Second-Deployment",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                        "ApplicationName": "CodePipelineDemoApplication",
                        "DeploymentGroupName": "CodePipelineProductionFleet"
                        },
                        "runOrder": 1
                    }
                ]
        }
    ]
}

Pour plus d'informations sur l'ajout d'une action d'approbation à un pipeline à l'aide du CLI, consultez Ajout d'une action d'approbation manuelle à un pipeline dans CodePipeline .

Assurez-vous que le paramètre PollForSourceChanges est défini comme suit dans votre fichier JSON :

                "PollForSourceChanges": "false",

CodePipeline utilise Amazon CloudWatch Events pour détecter les modifications apportées à votre référentiel CodeCommit source et à votre branche ou à votre compartiment source Amazon S3. L'étape suivante comporte les instructions de création manuelle de ces ressources. Vous pouvez définir l'indicateur sur falsepour désactiver les vérifications périodiques, lesquelles ne sont pas nécessaires lorsque vous utilisez les méthodes de détection des modifications recommandées.

Pour ajouter une action de génération, de test ou de déploiement dans une région différente de celle de votre pipeline, vous devez ajouter les éléments suivants à la structure de pipeline. Pour obtenir des instructions complètes, veuillez consulter Ajouter une action interrégionale dans CodePipeline.

Si vous utilisez la structure de pipeline extraite à l'aide de la commande get-pipeline, vous devez modifier la structure dans le fichier JSON. Vous devez supprimer les lignes metadata du fichier afin que la commande update-pipeline puisse l'utiliser. Supprimez la section de la structure de pipeline dans le fichier JSON (les lignes "metadata": { } et les champs "created", "pipelineARN" et "updated").

Par exemple, supprimez les lignes suivantes de la structure :

"metadata": {  
  "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name",
  "created": "date",
  "updated": "date"
  }

Enregistrez le fichier.

Si vous utilisez l'interface de ligne de commande pour modifier un pipeline, vous devez gérer manuellement les ressources de détection des modifications recommandées pour votre pipeline :

Pour appliquer les modifications, exécutez la commande update-pipeline en spécifiant le fichier JSON du pipeline :

aws codepipeline update-pipeline --cli-input-json file://pipeline.json

Cette commande affiche toute la structure du pipeline mise à jour.

Ouvrez la CodePipeline console et choisissez le pipeline que vous venez de modifier.

Le pipeline affiche vos modifications. La prochaine fois que vous apporterez une modification à l'emplacement source, le pipeline exécute cette modification via sa structure révisée.

Pour exécuter manuellement la dernière mise à jour dans la structure révisée du pipeline, exécutez la commande start-pipeline-execution. Pour de plus amples informations, veuillez consulter Lancement manuel d'un pipeline.