View a markdown version of this page

Démarrer un pipeline avec un remplacement de révision de la source - AWS CodePipeline
Démarrer un pipeline avec un remplacement de révision de la source (console)Démarrez un pipeline avec un remplacement de révision de la source (CLI)

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émarrer un pipeline avec un remplacement de révision de la source

Vous pouvez utiliser des remplacements pour démarrer un pipeline avec un ID de révision source spécifique que vous fournissez pour l'exécution du pipeline. Par exemple, si vous souhaitez démarrer un pipeline qui traitera un ID de validation spécifique à partir de votre CodeCommit source, vous pouvez ajouter l'ID de validation en tant que remplacement lorsque vous démarrez votre pipeline.

Note

Vous pouvez également créer un remplacement de source à l'aide d'une entrée de transformation d'entrée EventBridge pour utiliser l'revisionValueentrée de votre événement de pipeline, où le revisionValue est dérivé de la variable d'événement source pour votre clé d'objet, votre commit ou votre ID d'image. Pour plus d'informations, consultez l'étape facultative pour la saisie de la transformation d'entrée incluse dans les procédures sous Actions et ressources relatives aux sources Amazon ECR EventBridgeConnexion aux actions de source Amazon S3 avec une source activée pour les événements, ouCodeCommit actions à la source et EventBridge.

Il existe quatre types de révision des sources pour revisionType :

  • COMMIT_ID

  • IMAGE_DIGEST

  • S3_OBJECT_VERSION_ID

  • S3_OBJECT_KEY

Note

Pour les révisions de source COMMIT_ID et les IMAGE_DIGEST types de révisions, l'ID de révision source s'applique à tout le contenu du référentiel, dans toutes les branches.

Note

Pour les S3_OBJECT_VERSION_ID et S3_OBJECT_KEY types de révisions de source, l'un ou l'autre des types peut être utilisé indépendamment, ou ils peuvent être utilisés ensemble pour remplacer la source par un identifiant de version spécifique ObjectKey . PourS3_OBJECT_KEY, le paramètre de configuration AllowOverrideForS3ObjectKey doit être défini surtrue. Pour plus d'informations sur les paramètres de configuration des sources S3, consultezParamètres de configuration.

Démarrer un pipeline avec un remplacement de révision de la source (console)

Pour lancer manuellement un pipeline et la plus récente révision dans un pipeline

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

  2. Dans Nom, choisissez le nom du pipeline que vous souhaitez lancer.

  3. Sur la page des détails du pipeline, choisissez Release change. Le choix de modification de version ouvre la fenêtre de modification de version. Pour remplacer la révision de la source, choisissez la flèche pour développer le champ. Dans Source, entrez l'ID de révision de la source. Par exemple, si votre pipeline possède une CodeCommit source, choisissez l'ID de validation dans le champ que vous souhaitez utiliser.

    Un exemple de l'écran de remplacement dans. CodePipeline

Démarrez un pipeline avec un remplacement de révision de la source (CLI)

Pour démarrer manuellement un pipeline et exécuter l'ID de révision source spécifié pour un artefact via un pipeline

  1. Ouvrez un terminal (Linux, macOS ou Unix) ou une invite de commande (Windows) et exécutez la start-pipeline-execution commande en spécifiant le nom du pipeline que vous souhaitez démarrer. AWS CLI Vous utilisez également --source-revisions cet argument pour fournir l'ID de révision source. La révision source est composée de ActionName, RevisionType et RevisionValue. Les valeurs RevisionType valides sont. COMMIT_ID | IMAGE_DIGEST | S3_OBJECT_VERSION_ID | S3_OBJECT_KEY

    Dans l'exemple suivant, pour commencer à exécuter la modification spécifiée via un pipeline nommécodecommit-pipeline, la commande suivante spécifie le nom de l'action source Source, un type de COMMIT_ID révision et un ID de validation de78a25c18755ccac3f2a9eec099dEXAMPLE.

    aws codepipeline start-pipeline-execution --name codecommit-pipeline --source-revisions actionName=Source,revisionType=COMMIT_ID,revisionValue=78a25c18755ccac3f2a9eec099dEXAMPLE --region us-west-1

  2. Pour vérifier la réussite, affichez l'objet retourné. Cette commande renvoie un ID d'exécution similaire à ce qui suit :

    {
    "pipelineExecutionId": "c53dbd42-This-Is-An-Example"
}
    Note

    Après avoir démarré le pipeline, vous pouvez suivre sa progression dans la CodePipeline console ou en exécutant la get-pipeline-state commande. Pour plus d'informations, consultez Afficher les pipelines (console) et Affichage des détails et de l'historique d'un pipeline (interface de ligne de commande).