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 ECR-Quellaktion
Löst die Pipeline aus, wenn ein neues Image in das Amazon ECR-Repository übertragen wird. Diese Aktion stellt eine Bilddefinitionsdatei bereit, die auf den URI für das Bild verweist, das an Amazon ECR übertragen wurde. Diese Quellaktion wird häufig in Verbindung mit einer anderen Quellaktion verwendet, z. B. CodeCommit, um einen Quellspeicherort für alle weiteren Quellartefakte zuzulassen. Weitere Informationen finden Sie unter [Tutorial: Eine Pipeline mit einer Amazon ECR-Quelle und ECS-to-CodeDeploy Bereitstellung erstellen](tutorials-ecs-ecr-codedeploy.md).
Wenn Sie die Konsole verwenden, um Ihre Pipeline zu erstellen oder zu bearbeiten, CodePipeline erstellt diese eine EventBridge Regel, die Ihre Pipeline startet, wenn eine Änderung im Repository erfolgt.
**Anmerkung**
Für Amazon ECR, Amazon S3 oder CodeCommit Quellen können Sie auch eine Quellüberschreibung mithilfe des Eingabe-Transformationseintrags 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 Verfahren unter [Amazon ECR-Quellaktionen und Ressourcen EventBridge](create-cwe-ecr-source.md)[Verbindung zu Amazon S3 S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle herstellen](create-S3-source-events.md), oder [CodeCommit Quellaktionen und EventBridge](triggering.md) enthalten ist.
Sie müssen bereits ein Amazon ECR-Repository erstellt und ein Image übertragen haben, bevor Sie die Pipeline über eine Amazon ECR-Aktion verbinden.
**Topics**
+ [Aktionstyp](#action-reference-ECR-type)
+ [Konfigurationsparameter](#action-reference-ECR-config)
+ [Input artifacts (Eingabeartefakte)](#action-reference-ECR-input)
+ [Ausgabeartefakte](#action-reference-ECR-output)
+ [Ausgabevariablen](#action-reference-ECR-variables)
+ [Berechtigungen für Servicerollen: Amazon ECR-Aktion](#edit-role-ecr)
+ [Aktionserklärung (Beispiel Amazon ECR)](#action-reference-ECR-example)
+ [Weitere Informationen finden Sie auch unter](#action-reference-ECR-links)
## Aktionstyp
+ Kategorie: `Source`
+ Eigentümer: `AWS`
+ Anbieter: `ECR`
+ Version: `1`
## Konfigurationsparameter
**RepositoryName**
Erforderlich: Ja
Der Name des Amazon ECR-Repositorys, in das das Bild übertragen wurde.
**ImageTag**
Erforderlich: Nein
Das Tag, das für das Image verwendet wird.
Wenn kein Wert für `ImageTag` angegeben ist, wird standardmäßig der Wert `latest` verwendet.
## Input artifacts (Eingabeartefakte)
+ **Anzahl der Artefakte:** `0`
+ **Beschreibung:** Eingabe-Artefakte sind für diesen Aktionstyp nicht gültig.
## Ausgabeartefakte
+ **Anzahl der Artefakte:** `1`
+ **Beschreibung:** Diese Aktion erzeugt ein Artefakt, das die Datei `imageDetail.json` enthält. Diese Datei enthält den URI für das Image, durch das die Pipeline-Ausführung ausgelöst wurde. Informationen zur `imageDetail.json`-Datei finden Sie unter [ImageDetail.json-Datei für Amazon ECS-Bereitstellungsaktionen blue/green](file-reference.md#file-reference-ecs-bluegreen).
## 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 finden Sie unter [Variablen-Referenz](reference-variables.md).
**RegistryId**
Die AWS Konto-ID, die der Registrierung zugeordnet ist, die das Repository enthält.
**RepositoryName**
Der Name des Amazon ECR-Repositorys, in das das Bild übertragen wurde.
**ImageTag**
Das Tag, das für das Image verwendet wird.
Die `ImageTag` Ausgabevariable wird nicht ausgegeben, wenn die Quellversion überschrieben wird
**ImageDigest**
Der `sha256`-Digest des Image-Manifests.
**ImageURI**
Der URI für das Image.
## Berechtigungen für Servicerollen: Amazon ECR-Aktion
Für Amazon ECR-Support fügen Sie Ihrer Richtlinienerklärung Folgendes hinzu:
```
{
"Effect": "Allow",
"Action": [
"ecr:DescribeImages"
],
"Resource": "resource_ARN"
},
```
Weitere Informationen zu dieser Aktion finden Sie unter[Referenz zur Amazon ECR-Quellaktion](#action-reference-ECR).
## Aktionserklärung (Beispiel Amazon ECR)
------
#### [ YAML ]
```
Name: Source
Actions:
- InputArtifacts: []
ActionTypeId:
Version: '1'
Owner: AWS
Category: Source
Provider: ECR
OutputArtifacts:
- Name: SourceArtifact
RunOrder: 1
Configuration:
ImageTag: latest
RepositoryName: my-image-repo
Name: ImageSource
```
------
#### [ JSON ]
```
{
"Name": "Source",
"Actions": [
{
"InputArtifacts": [],
"ActionTypeId": {
"Version": "1",
"Owner": "AWS",
"Category": "Source",
"Provider": "ECR"
},
"OutputArtifacts": [
{
"Name": "SourceArtifact"
}
],
"RunOrder": 1,
"Configuration": {
"ImageTag": "latest",
"RepositoryName": "my-image-repo"
},
"Name": "ImageSource"
}
]
},
```
------
## Weitere Informationen finden Sie auch unter
Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion.
+ [Tutorial: Eine Pipeline mit einer Amazon ECR-Quelle und ECS-to-CodeDeploy Bereitstellung erstellen](tutorials-ecs-ecr-codedeploy.md)— Dieses Tutorial enthält eine Beispiel-App-Spezifikationsdatei sowie eine CodeDeploy Beispielanwendung und eine Bereitstellungsgruppe zum Erstellen einer Pipeline mit einer CodeCommit Amazon ECR-Quelle, die auf Amazon ECS-Instances bereitgestellt wird.