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 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 S3-Quellaktion beschrieben, bei der es CodePipeline sich bei dem Quellspeicherort um einen Amazon S3 S3-Bucket handelt, der für die Versionierung konfiguriert ist. Referenzinformationen zur Amazon S3 S3-Bereitstellungsaktion in CodePipeline finden Sie unterReferenz zur Amazon S3 S3-Bereitstellungsaktion.
Bevor Sie die Pipeline verbinden, erstellen Sie einen Amazon S3 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 S3-Bucket auswählen, der als Quellpfad für Ihre Anwendungsdateien verwendet werden soll. Weitere Informationen zur Aktivierung der Versionierung finden Sie unter Verwenden der Versionierung im Amazon S3 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. Nachgeschaltete Aktionen, die eine ZIP-Datei erwarten, schlagen jedoch fehl.
Wenn Sie die Konsole verwenden, um Ihre Pipeline zu erstellen oder zu bearbeiten, CodePipeline erstellt sie eine EventBridge Regel, die Ihre Pipeline startet, wenn eine Änderung im Amazon S3 S3-Quell-Bucket erfolgt.
Sie können auch mithilfe des Eingabe-Transformationseintrags eine Quellenüberschreibung erstellen, um den revisionValue In EventBridge für Ihr Pipeline-Ereignis zu verwenden, wobei der von der Quellereignisvariablen für Ihren Objektschlüssel, Ihren Commit oder Ihre Image-ID abgeleitet revisionValue wird. Weitere Informationen finden Sie im optionalen Schritt für die Eingabe der Eingabetransformation, der in den nachfolgenden Verfahren enthalten istVerbindung zu Amazon S3 S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle herstellen.
Themen
Aktionstyp
-
Kategorie:
Source -
Eigentümer:
AWS -
Anbieter:
S3 -
Version:
1
Konfigurationsparameter
- S3 Bucket
-
Erforderlich: Ja
Der Name des Amazon S3 S3-Buckets, in dem Quelländerungen erkannt werden sollen.
- S3ObjectKey
-
Erforderlich: Ja
Der Name des Amazon S3 S3-Objektschlüssels, bei dem Quelländerungen erkannt werden sollen.
- AllowOverrideForS3ObjectKey
-
Erforderlich: Nein
AllowOverrideForS3ObjectKeysteuert, ob Quellenüberschreibungen von die bereitsS3ObjectKeyin der Quelle konfigurierte Aktion überschreibenStartPipelineExecutionkönnen. Weitere Informationen zu Quellenüberschreibungen mit dem S3-Objektschlüssel finden Sie unter. Starten Sie eine Pipeline mit einer QuellrevisionsüberschreibungWichtig
Wenn Sie diesen Parameter weglassen
AllowOverrideForS3ObjectKey, ist CodePipeline standardmäßig die Fähigkeit aktiviert, S3 ObjectKey in der Quellaktion zu überschreiben, indem Sie diesen Parameter auf setzen.falseGültige Werte für diesen Parameter sind:
-
true: Falls gesetzt, kann der vorkonfigurierte S3-Objektschlüssel während einer Pipeline-Ausführung durch Überschreibungen der Quellversion außer Kraft gesetzt werden.Anmerkung
Wenn Sie allen CodePipeline Benutzern die Möglichkeit geben möchten, den vorkonfigurierten S3-Objektschlüssel zu überschreiben, während sie eine neue Pipeline-Ausführung starten, müssen Sie auf einstellen.
AllowOverrideForS3ObjectKeytrue -
false:Wenn diese Option gesetzt ist, CodePipeline kann der S3-Objektschlüssel nicht mithilfe von Quellrevisionsüberschreibungen überschrieben werden. Dies ist auch der Standardwert für diesen Parameter.
-
- PollForSourceChanges
-
Erforderlich: Nein
PollForSourceChangessteuert, ob der Amazon S3 S3-Quell-Bucket nach Quelländerungen CodePipeline abgefragt wird. Wir empfehlen, stattdessen CloudWatch Events zu verwenden und Quelländerungen CloudTrail zu erkennen. Weitere Informationen zur Konfiguration von CloudWatch Ereignissen finden Sie unter Migrieren Sie Polling-Pipelines mit einer S3-Quelle und einem CloudTrail S3-Trail (CLI) oderMigrieren Sie Polling-Pipelines mit einer S3-Quelle und einem CloudTrail S3-Trail (Vorlage)CloudFormation.Wichtig
Wenn Sie CloudWatch Ereignisse konfigurieren möchten, müssen Sie
PollForSourceChangesauf einstellen,falseum doppelte Pipeline-Ausführungen zu vermeiden.Gültige Werte für diesen Parameter sind:
-
true: Wenn diese Option gesetzt ist, CodePipeline wird Ihr Quellspeicherort nach Quellenänderungen abgefragt.Anmerkung
Wenn Sie diese Option weglassen
PollForSourceChanges, wird CodePipeline standardmäßig Ihr Quellort nach Quellenänderungen abgefragt. Dieses Verhalten ist das gleiche, als obPollForSourceChangesenthalten wäre und auftruefestgelegt würde. -
false: Wenn diese Option aktiviert ist, CodePipeline wird Ihr Quellort nicht nach Quellenänderungen abgefragt. Verwenden Sie diese Einstellung, wenn Sie beabsichtigen, eine CloudWatch Ereignisregel zur Erkennung von Quellenänderungen zu konfigurieren.
-
Input artifacts (Eingabeartefakte)
-
Anzahl der Artefakte:
0 -
Beschreibung: Eingabe-Artefakte sind für diesen Aktionstyp nicht gültig.
Ausgabeartefakte
-
Anzahl der Artefakte:
1 -
Beschreibung: Stellt die Artefakte bereit, die in dem Quell-Bucket verfügbar sind, der für die Verbindung mit der Pipeline konfiguriert wurde. Die aus dem Bucket generierten Artefakte sind die Ausgabeartefakte für die Amazon S3 S3-Aktion. Die Amazon S3 S3-Objektmetadaten (ETag und Versions-ID) werden CodePipeline als Quellrevision für die ausgelöste Pipeline-Ausführung angezeigt.
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 unterVariablen-Referenz.
- BucketName
-
Der Name des Amazon S3 S3-Buckets bezieht sich auf die Quellenänderung, die die Pipeline ausgelöst hat.
- ETag
-
Das Entitäts-Tag für das Objekt, das sich auf die Quelländerung bezieht, von der die Pipeline ausgelöst wurde. Der ETag ist ein MD5-Hash des Objekts. Das ETag gibt nur Änderungen des Inhalt eines Objekts wieder, nicht der Metadaten eines Objekts.
- ObjectKey
-
Der Name des Amazon S3 S3-Objektschlüssels, der sich auf die Quellenänderung bezieht, die die Pipeline ausgelöst hat.
- VersionId
-
Die Versions-ID für die Version des Objekts, die sich auf die Quelländerung bezieht, von der die Pipeline ausgelöst wurde.
Berechtigungen für Servicerollen: S3-Quellaktion
Für die Unterstützung von S3-Quellaktionen fügen Sie Ihrer Richtlinienerklärung Folgendes hinzu:
Aktionsdeklaration
Weitere Informationen finden Sie auch unter
Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion.
-
Tutorial: Erstellen einer einfachen Pipeline (S3-Bucket)— Dieses Tutorial enthält eine Beispiel-App-Spezifikationsdatei sowie eine CodeDeploy Beispielanwendung und eine Bereitstellungsgruppe. Verwenden Sie dieses Tutorial, um eine Pipeline mit einer Amazon S3 S3-Quelle zu erstellen, die auf Amazon EC2 EC2-Instances bereitgestellt wird.