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.

Aktionsdeklaration

Die Aktionsebene einer Pipeline hat eine grundlegende Struktur, die die folgenden Parameter und Syntax umfasst. Weitere Informationen finden Sie im CodePipeline API-Handbuch zu dem ActionDeclaration Objekt.

Das folgende Beispiel zeigt die Aktionsebene der Pipeline-Struktur sowohl in JSON als auch in YAML.

YAML

 
. . . 

  stages:
    - name: Source
      actions:
        - name: Source
          actionTypeId:
            category: Source
            owner: AWS
            provider: S3
            version: '1'
          runOrder: 1
          configuration:
            PollForSourceChanges: 'false'
            S3Bucket: amzn-s3-demo-bucket
            S3ObjectKey: codedeploy_linux.zip
          outputArtifacts:
            - name: SourceArtifact
          inputArtifacts: []
          region: us-west-2
          namespace: SourceVariables
    - name: Build
      actions:
        - name: Build
          actionTypeId:
            category: Build
            owner: AWS
            provider: CodeBuild
            version: '1'
          runOrder: 1
          configuration:
            EnvironmentVariables: >-
              [{"name":"ETag","value":"#{SourceVariables.ETag}","type":"PLAINTEXT"}]
            ProjectName: my-project
          outputArtifacts:
            - name: BuildArtifact
          inputArtifacts:
            - name: SourceArtifact
          region: us-west-2
          namespace: BuildVariables
          runOrder: 1
          configuration:
            CustomData: >-
              Here are the exported variables from the build action: S3 ETAG:
              #{BuildVariables.ETag}
          outputArtifacts: []
          inputArtifacts: []
          region: us-west-2

JSON

 
. . . 

        "stages": [
            {
                "name": "Source",
                "actions": [
                    {
                        "name": "Source",
                        "actionTypeId": {
                            "category": "Source",
                            "owner": "AWS",
                            "provider": "S3",
                            "version": "1"
                        },
                        "runOrder": 1,
                        "configuration": {
                            "PollForSourceChanges": "false",
                            "S3Bucket": "amzn-s3-demo-bucket",
                            "S3ObjectKey": "aws-codepipeline-s3-aws-codedeploy_linux.zip"
                        },
                        "outputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "inputArtifacts": [],
                        "region": "us-west-2",
                        "namespace": "SourceVariables"
                    }
                ]
            },
            {
                "name": "Build",
                "actions": [
                    {
                        "name": "Build",
                        "actionTypeId": {
                            "category": "Build",
                            "owner": "AWS",
                            "provider": "CodeBuild",
                            "version": "1"
                        },
                        "runOrder": 1,
                        "configuration": {
                            "EnvironmentVariables": "[{\"name\":\"ETag\",\"value\":\"#{SourceVariables.ETag}\",\"type\":\"PLAINTEXT\"}]",
                            "ProjectName": "my-build-project"
                        },
                        "outputArtifacts": [
                            {
                                "name": "BuildArtifact"
                            }
                        ],
                        "inputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "region": "us-west-2",
                        "namespace": "BuildVariables"
                    }
                ]
      
. . . 

Eine Liste der Beispiel-configuration Details für den jeweiligen Anbietertyp finden Sie unter Gültige Konfigurationsparameter für jeden Anbietertyp.

Die Aktionsstruktur hat folgende Anforderungen:

Name

Den Namen der Aktion.

Region

Für Aktionen, bei denen der Anbieter ein ist, der der Ressource. AWS-Service AWS-Region

Cross-Region Aktionen verwenden Sie das Region Feld, um anzugeben AWS-Region , wo die Aktionen erstellt werden sollen. Die für diese Aktion erstellten AWS Ressourcen müssen in derselben Region erstellt werden, die im region Feld angegeben ist. Für die folgenden Aktionstypen können Sie keine regionsübergreifenden Aktionen erstellen:

roleArn

Der ARN der IAM-Servicerolle, die die angegebene Aktion ausführt. Dies wird durch das RolEearn vorausgesetzt, das auf Pipeline-Ebene angegeben wird.

Namespace

Aktionen können mit Variablen konfiguriert werden. Sie legen die Namespace- und Variableninformationen für Ausführungsvariablen im Feld namespace fest. Referenzinformationen zu Ausführungsvariablen und Aktionsausgabevariablen finden Sie unter Variablenreferenz.

Aktion TypeId

Die Aktionstyp-ID wird als Kombination der folgenden vier Felder identifiziert.

category

Die Art der Aktion oder des Schritts in der Pipeline, z. B. eine Quellaktion. Jeder Aktionstyp hat einen bestimmten Satz gültiger Aktionsanbieter. Eine Liste der gültigen Anbieter nach Aktionstyp finden Sie unterReferenz der Aktionsstruktur.

Dies sind die gültigen actionTypeId Kategorien (Aktionstypen) für CodePipeline:

owner

Für alle derzeit unterstützten Aktionstypen ist die einzig gültige BesitzerzeichenfolgeAWS,ThirdParty, oderCustom. Die gültige Besitzerzeichenfolge für eine bestimmte Aktion finden Sie imReferenz der Aktionsstruktur.

Weitere Informationen finden Sie in der CodePipeline -API-Referenz.

version

Die Version der Aktion.

provider

Der Aktionsanbieter, z. CodeBuild B.

InputArtifacts

Dieses Feld enthält die Eingabe-Artefaktstruktur, sofern dies für die Aktionskategorie unterstützt wird. Das Eingabeartefakt einer Aktion muss genau mit dem Ausgabeartefakt übereinstimmen, das in einer vorangegangenen Aktion deklariert wurde. Wenn beispielsweise eine vorherige Aktion die folgende Erklärung enthält:

"outputArtifacts": [
    {
    "MyApp"
    }
],

und keine anderen Ausgabeartefakte vorhanden sind, muss das Eingabeartefakt einer nachfolgenden Aktion folgendermaßen lauten:

"inputArtifacts": [
    {
    "MyApp"
    }
],

Beispielsweise kann eine Quellaktion keine Eingabeartefakte haben, da es sich um die erste Aktion in der Pipeline handelt. Eine Quellaktion hat jedoch immer Ausgabeartefakte, die von der folgenden Aktion verarbeitet werden. Die Ausgabeartefakte für eine Quellaktion sind die Anwendungsdateien aus dem Quell-Repository, die gezippt und über den Artefakt-Bucket bereitgestellt werden. Sie werden von der folgenden Aktion verarbeitet, z. B. einer CodeBuild Aktion, die mit Build-Befehlen auf die Anwendungsdateien einwirkt.

Ein Beispiel für Aktionen, die keine Ausgabeartefakte haben können, sind Bereitstellungsaktionen, die keine Ausgabeartefakte haben, da es sich bei diesen Aktionen in der Regel um die letzte Aktion in einer Pipeline handelt.

Name

Der Artefaktname für die Eingabeartefakte der Aktion.

Ausgabe-Artefakte

Namen von Ausgabeartefakten müssen in einer Pipeline eindeutig sein. Eine Pipeline kann z. B. eine Aktion mit einem Ausgabeartefakt namens "MyApp" und eine weitere Aktion mit einem Ausgabeartefakt namens "MyBuiltApp" enthalten. Eine Pipeline kann jedoch nicht zwei Aktionen enthalten, die beide ein Ausgabeartefakt mit dem Namen "MyApp" haben.

Dieses Feld enthält die Ausgabe-Artefaktstruktur, sofern dies für die Aktionskategorie unterstützt wird. Das Ausgabeartefakt einer Aktion muss exakt mit dem Ausgabeartefakt übereinstimmen, das in einer vorangegangenen Aktion deklariert wurde. Wenn beispielsweise eine vorherige Aktion die folgende Erklärung enthält:

"outputArtifacts": [
    {
    "MyApp"
    }
],

und keine anderen Ausgabeartefakte vorhanden sind, muss das Eingabeartefakt einer nachfolgenden Aktion folgendermaßen lauten:

"inputArtifacts": [
    {
    "MyApp"
    }
],

Beispielsweise kann eine Quellaktion keine Eingabeartefakte haben, da es sich um die erste Aktion in der Pipeline handelt. Eine Quellaktion hat jedoch immer Ausgabeartefakte, die von der folgenden Aktion verarbeitet werden. Die Ausgabeartefakte für eine Quellaktion sind die Anwendungsdateien aus dem Quell-Repository, die gezippt und über den Artefakt-Bucket bereitgestellt werden. Sie werden von der folgenden Aktion verarbeitet, z. B. einer CodeBuild Aktion, die mit Build-Befehlen auf die Anwendungsdateien einwirkt.

Ein Beispiel für Aktionen, die keine Ausgabeartefakte haben können, sind Bereitstellungsaktionen, die keine Ausgabeartefakte haben, da es sich bei diesen Aktionen in der Regel um die letzte Aktion in einer Pipeline handelt.

Name

Der Artefaktname für die Ausgabeartefakte der Aktion.

Konfiguration (nach Aktionsanbieter)

Die Aktionskonfiguration enthält Details und Parameter, die dem Anbietertyp entsprechen. Im folgenden Abschnitt sind die Beispielparameter für die Aktionskonfiguration spezifisch für die S3-Quellaktion.

Die Aktionskonfiguration und die input/output Artefaktlimits können je nach Aktionsanbieter variieren. Eine Liste mit Beispielen für die Aktionskonfiguration nach Aktionsanbieter finden Sie unter Referenz der Aktionsstruktur und in Gültige Konfigurationsparameter für jeden Anbietertyp der Tabelle unter. Die Tabelle enthält einen Link zur Aktionsreferenz für jeden Anbietertyp, in der die Konfigurationsparameter für jede Aktion detailliert aufgeführt sind. Eine Tabelle mit den Grenzwerten für Eingabe- und Ausgabeartefakte für jeden Aktionsanbieter finden Sie unterGültige Eingabe- und Ausgabeartefakte für jeden Aktionstyp.

Die folgenden Überlegungen gelten für die Arbeit mit Aktionen:

Bestellung ausführen

Eine positive Ganzzahl, die die Ausführungsreihenfolge der Aktion innerhalb der Phase angibt. Parallele Aktionen in der Phase werden so dargestellt, dass sie dieselbe Ganzzahl haben. Beispielsweise werden zwei Aktionen mit einer Ausführungsreihenfolge von zwei parallel ausgeführt, nachdem die erste Aktion in der Phase ausgeführt wird.

Der standardmäßige runOrder-Wert für eine Aktion ist 1. Der Wert muss eine positive Ganzzahl (natürliche Zahl) sein. Sie können keine Bruchzahlen, Dezimalzahlen, negative Zahlen oder Null verwenden. Für eine serielle Reihenfolge von Aktionen geben Sie die niedrigste Zahl für die erste Aktion und höhere Zahlen für jede der verbleibenden Aktionen in der Abfolge an. Parallele Aktionen geben Sie an, indem Sie dieselbe Ganzzahl für jede Aktion verwenden, die parallel ausgeführt werden soll. In der Konsole können Sie eine serielle Sequenz für eine Aktion angeben, indem Sie auf der Ebene in der Phase, auf der sie ausgeführt werden soll, die Option Aktionsgruppe hinzufügen auswählen. Sie können auch eine parallele Reihenfolge angeben, indem Sie Aktion hinzufügen wählen. Aktionsgruppe bezieht sich auf eine Ausführungsreihenfolge von einer oder mehreren Aktionen auf derselben Ebene.

Wenn Sie beispielsweise drei Aktionen der Reihe nach in einer Phase ausführen möchten, geben Sie der ersten Aktion den runOrder-Wert 1, der zweiten Aktion den runOrder-Wert 2 und der dritten den runOrder-Wert 3. Wenn Sie jedoch die zweite und dritte Aktion parallel ausführen möchten, geben Sie der ersten Aktion den runOrder-Wert 1 und sowohl der zweiten als auch der dritten Aktion den runOrder-Wert 2.