View a markdown version of this page

AWS CodePipeline invoquer la référence de l'action - AWS CodePipeline
Type d'actionParamètres de configurationArtefacts d'entréeArtefacts de sortieAutorisations relatives à la politique de rôle de service pour l'action d' CodePipeline invocationDéclaration d'actionConsultez aussi

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.

AWS CodePipeline invoquer la référence de l'action

Vous utilisez une action d' CodePipeline invocation pour simplifier le déclenchement des exécutions de pipeline en aval et la transmission de variables de pipeline et de révisions de source entre les pipelines.

Note

Cette action n'est prise en charge que pour les pipelines de type V2.

Type d'action

  • Catégorie : Invoke

  • Propriétaire : AWS

  • Fournisseur : CodePipeline

  • Version : 1

Paramètres de configuration

PipelineName

Obligatoire : oui

Le nom du pipeline qui, lors de son exécution, démarrera le pipeline cible actuel. Vous devez déjà avoir créé le pipeline d'appel. L'action démarre le pipeline s3-pipeline-test (cible) lorsque le pipeline (d'appel) nommé my-s3-pipeline démarre une exécution.

SourceRevisions

Obligatoire : non

Les révisions de source que vous souhaitez que le pipeline cible utilise lorsqu'il est démarré par le pipeline d'appel. Par exemple, une action source S3 fournit des variables de sortie telles que l'ID de version S3 et la clé d'objet. Vous pouvez spécifier une valeur de révision à utiliser lorsque le pipeline est invoqué.

Pour la CLI, vous spécifiez les révisions de source sous la forme d'une chaîne JSON sérialisée. Pour plus d'informations sur l'utilisation des remplacements de révision de source, consultez SourceRevisionOverride le Guide des CodePipeline API.

Le mappage utilise un format de chaîne, comme illustré dans l'exemple suivant :

[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]
Variables

Obligatoire : non

Les noms et les valeurs des variables que vous souhaitez que l'action prenne en charge.

Pour la CLI, vous spécifiez les variables sous la forme d'une chaîne JSON sérialisée. Pour plus d'informations sur l'utilisation des variables de pipeline, consultez PipelineVariable le Guide des CodePipeline API.

Le mappage utilise un format de chaîne, comme illustré dans l'exemple suivant :

[{"name":"VAR1","value":"VALUE1"}]

L'image suivante montre un exemple de l'action ajoutée à un pipeline dans la console.

Un pipeline avec une source S3 et une étape de construction qui inclut l'action d'invocation du pipeline

L'image suivante montre un exemple de page d'édition pour l'action. Dans l'exemple suivant, le pipeline nommé s3-pipeline-test possède une action d'appel de pipeline configurée comme indiqué pour la console. L'action démarre le s3-pipeline-test pipeline lorsque le pipeline nommé my-s3-pipeline termine une exécution. L'exemple montre que le remplacement de la révision de la source pour le code source S3_OBJECT_VERSION_ID est remplacé par la valeur de révision spécifiée de. zq8mjNYEexample

La page Modifier l'action pour un nouveau pipeline avec l'action d'invocation du pipeline

Artefacts d'entrée

  • Nombre d'objets : 0

  • Description : Les artefacts d'entrée ne s'appliquent pas à ce type d'action.

Artefacts de sortie

  • Nombre d'objets : 0

  • Description : Les artefacts de sortie ne s'appliquent pas à ce type d'action.

Autorisations relatives à la politique de rôle de service pour l'action d' CodePipeline invocation

Lors de l' CodePipeline exécution de l'action, la politique de rôle de CodePipeline service nécessite l'codepipeline:StartPipelineExecutionautorisation, limitée de manière appropriée à l'ARN de la ressource du pipeline afin de conserver l'accès avec le moins de privilèges possible.

 {
            "Sid": "StatementForPipelineInvokeAction",
            "Effect": "Allow",
            "Action": "codepipeline:StartPipelineExecution",
            "Resource": [
                "arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}"
            ]
        }

Déclaration d'action

YAML
name: Invoke-pipeline
actionTypeId:
  category: Invoke
  owner: AWS
  provider: CodePipeline
  version: '1'
runOrder: 2
configuration:
  PipelineName: my-s3-pipeline
  SourceRevisions: '[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]'
  Variables: '[{"name":"VAR1","value":"VALUE1"}]'
JSON
{
    "name": "Invoke-pipeline",
    "actionTypeId": {
        "category": "Invoke",
        "owner": "AWS",
        "provider": "CodePipeline",
        "version": "1"
    },
    "runOrder": 2,
    "configuration": {
        "PipelineName": "my-s3-pipeline",
        "SourceRevisions": "[{\"actionName\":\"Source\",\"revisionType\":\"S3_OBJECT_VERSION_ID\",\"revisionValue\":\"zq8mjNEXAMPLE\"}]",
        "Variables": "[{\"name\":\"VAR1\",\"value\":\"VALUE1\"}]"
    }
},

Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action.