View a markdown version of this page

AWS CodePipeline Aktionsreferenz aufrufen - AWS CodePipeline
AktionstypKonfigurationsparameterInput artifacts (Eingabeartefakte)AusgabeartefakteBerechtigungen für die Aktion zum CodePipeline Aufrufen der Aktion „Dienst“AktionsdeklarationWeitere Informationen finden Sie auch unter

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS CodePipeline Aktionsreferenz aufrufen

Sie verwenden eine CodePipeline Aufrufaktion, um das Auslösen von Downstream-Pipeline-Ausführungen und die Übergabe von Pipeline-Variablen und Quellrevisionen zwischen Pipelines zu vereinfachen.

Anmerkung

Diese Aktion wird nur für Pipelines vom Typ V2 unterstützt.

Aktionstyp

  • Kategorie: Invoke

  • Eigentümer: AWS

  • Anbieter: CodePipeline

  • Version: 1

Konfigurationsparameter

PipelineName

Erforderlich: Ja

Der Name der Pipeline, die bei der Ausführung die aktuelle Zielpipeline startet. Sie müssen die aufrufende Pipeline bereits erstellt haben. Die Aktion startet die s3-pipeline-test (Ziel-) Pipeline, wenn die angegebene (aufrufende) Pipeline eine Ausführung my-s3-pipeline startet.

SourceRevisions

Erforderlich: Nein

Die Quellrevisionen, die die Zielpipeline verwenden soll, wenn sie von der aufrufenden Pipeline gestartet wird. Beispielsweise stellt eine S3-Quellaktion Ausgabevariablen wie die S3-Versions-ID und den Objektschlüssel bereit. Sie können einen Revisionswert angeben, der verwendet werden soll, wenn die Pipeline aufgerufen wird.

Für die CLI geben Sie Quellrevisionen als serialisierte JSON-Zeichenfolge an. Weitere Informationen zur Verwendung von Quellrevisionsüberschreibungen finden Sie SourceRevisionOverride im CodePipeline API-Handbuch.

Das Mapping verwendet ein Zeichenfolgenformat, wie im folgenden Beispiel gezeigt:

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

Erforderlich: Nein

Die Namen und Werte der Variablen, die die Aktion unterstützen soll.

Für die CLI geben Sie Variablen als serialisierte JSON-Zeichenfolge an. Weitere Informationen zur Verwendung von Pipeline-Variablen finden Sie PipelineVariable im CodePipeline API-Handbuch.

Das Mapping verwendet ein Zeichenkettenformat, wie im folgenden Beispiel gezeigt:

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

Die folgende Abbildung zeigt ein Beispiel für die Aktion, die einer Pipeline in der Konsole hinzugefügt wurde.

Eine Pipeline mit einer S3-Quelle und einer Build-Phase, die die Aktion zum Aufrufen der Pipeline enthält

Die folgende Abbildung zeigt ein Beispiel für die Seite „Bearbeiten“ für die Aktion. Im folgenden Beispiel ist für die Pipeline mit dem Namen s3-pipeline-test eine Aktion zum Aufrufen einer Pipeline konfiguriert, wie für die Konsole gezeigt. Die Aktion startet die s3-pipeline-test Pipeline, wenn die angegebene Pipeline eine Ausführung my-s3-pipeline abgeschlossen hat. Das Beispiel zeigt, dass die Quellversion für die Quellcodeüberschreibung der S3_OBJECT_VERSION_ID mit dem angegebenen Revisionswert von überschrieben wird. zq8mjNYEexample

Die Aktionsseite „Bearbeiten“ für eine neue Pipeline mit der Aktion zum Aufrufen der Pipeline

Input artifacts (Eingabeartefakte)

  • Anzahl der Artefakte: 0

  • Beschreibung: Eingabe-Artefakte sind für diesen Aktionstyp nicht gültig.

Ausgabeartefakte

  • Anzahl der Artefakte: 0

  • Beschreibung: Ausgabeartefakte gelten nicht für diesen Aktionstyp.

Berechtigungen für die Aktion zum CodePipeline Aufrufen der Aktion „Dienst“

Wenn die Aktion CodePipeline ausgeführt wird, erfordert die CodePipeline Servicerollenrichtlinie die entsprechende codepipeline:StartPipelineExecution Berechtigung, die entsprechend auf den ARN der Pipeline-Ressource heruntergeregelt ist, um den Zugriff mit den geringsten Rechten aufrechtzuerhalten.

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

Aktionsdeklaration

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\"}]"
    }
},

Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion.