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.

Referenz zur Amazon S3-Quellaktion

Eine Quellaktion löst die Pipeline aus, wenn ein neues Objekt in den konfigurierten Bucket und Objektschlüssel hochgeladen wird.

In diesem Referenzthema wird die Amazon S3-Quellaktion beschrieben, bei CodePipeline der der Quellspeicherort ein Amazon S3-Bucket ist, der für die Versionierung konfiguriert ist. Referenzinformationen zur Amazon S3-Bereitstellungsaktion in finden Sie CodePipeline unterReferenz zur Amazon S3-Bereitstellungsaktion.

Bevor Sie die Pipeline verbinden, erstellen Sie einen Amazon S3-Quell-Bucket, aktivieren Sie die Versionierung und laden Sie Ihre Quelldateien als einzelne ZIP-Datei hoch.

Sie können einen neuen Bucket in Amazon S3 erstellen oder einen vorhandenen Amazon S3-Bucket auswählen, der als Quellspeicherort für Ihre Anwendungsdateien verwendet werden soll. Weitere Informationen zum Aktivieren der Versionierung finden Sie unter Verwenden der Versionierung im Amazon S3-Benutzerhandbuch.

Wenn Amazon S3 der Quellanbieter für Ihre Pipeline ist, können Sie Ihre Quelldatei (en) in eine einzige ZIP-Datei komprimieren und die ZIP-Datei in Ihren Quell-Bucket hochladen. Sie können auch eine einzelne entpackte Datei hochladen. Downstream-Aktionen, die eine ZIP-Datei erwarten, schlagen jedoch fehl.

Wenn Sie die Konsole verwenden, um Ihre Pipeline zu erstellen oder zu bearbeiten, CodePipeline erstellt eine EventBridge Regel, die Ihre Pipeline startet, wenn eine Änderung im Amazon S3-Quell-Bucket erfolgt.

Sie können auch eine Quellüberschreibung mithilfe eines Eingabe-Transformationseintrags erstellen, um das revisionValue In EventBridge für Ihr Pipeline-Ereignis zu verwenden, wobei revisionValue das von der Quellereignisvariablen für Ihren Objektschlüssel, Ihren Commit oder Ihre Bild-ID abgeleitet wird. Weitere Informationen finden Sie in dem optionalen Schritt für die Eingabe der Eingabetransformation, der in den nachfolgenden Verfahren enthalten istHerstellen einer Verbindung zu Amazon S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle.

Aktionstyp

Konfigurationsparameter

Input artifacts (Eingabeartefakte)

Ausgabeartefakte

Ausgabevariablen

Wenn dies konfiguriert ist, werden durch diese Aktion Variablen erzeugt, die von der Aktionskonfiguration einer nachgeschalteten Aktion in der Pipeline referenziert werden können. Diese Aktion erzeugt Variablen, die als Ausgabevariablen angezeigt werden können, auch wenn die Aktion keinen Namespace hat. Sie konfigurieren eine Aktion mit einem Namespace, um diese Variablen für die Konfiguration nachgeschalteter Aktionen zur Verfügung zu stellen.

Weitere Informationen zu Variablen in CodePipeline finden Sie unterVariablenreferenz.

Berechtigungen für Servicerollen: S3-Quellaktion

Für die Unterstützung von S3-Quellaktionen fügen Sie Ihrer Grundsatzerklärung Folgendes hinzu:

JSON

{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectVersion",
        "s3:GetBucketVersioning",
        "s3:GetBucketAcl",
        "s3:GetBucketLocation",
        "s3:GetObjectTagging",
        "s3:GetObjectVersionTagging"
      ],
      "Resource": [
        "arn:aws:s3:::[[S3Bucket]]",
        "arn:aws:s3:::[[S3Bucket]]/*"
      ],
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "111122223333"
        }
      }
    }
  ]
}

Aktionsdeklaration

YAML

Name: Source
Actions:
  - RunOrder: 1
    OutputArtifacts:
      - Name: SourceArtifact
    ActionTypeId:
      Provider: S3
      Owner: AWS
      Version: '1'
      Category: Source
    Region: us-west-2
    Name: Source
    Configuration:
      S3Bucket: amzn-s3-demo-source-bucket
      S3ObjectKey: my-application.zip
      PollForSourceChanges: 'false'
    InputArtifacts: []

JSON

{
    "Name": "Source",
    "Actions": [
        {
            "RunOrder": 1,
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "ActionTypeId": {
                "Provider": "S3",
                "Owner": "AWS",
                "Version": "1",
                "Category": "Source"
            },
            "Region": "us-west-2",
            "Name": "Source",
            "Configuration": {
                "S3Bucket": "amzn-s3-demo-source-bucket",
                "S3ObjectKey": "my-application.zip",
                "PollForSourceChanges": "false"
            },
            "InputArtifacts": []
        }
    ]
},

Weitere Informationen finden Sie auch unter

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