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
<a name="action-reference-ECR"></a>

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: Erstellen Sie eine Pipeline mit einer Amazon ECR-Quelle und Bereitstellung ECS-to-CodeDeploy](tutorials-ecs-ecr-codedeploy.md).

Wenn Sie die Konsole verwenden, um Ihre Pipeline zu erstellen oder zu bearbeiten, CodePipeline wird eine EventBridge Regel erstellt, 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 eines Eingabe-Transformationseintrags erstellen, um das `revisionValue` In EventBridge für Ihr Pipeline-Ereignis zu verwenden, wobei das aus der Quellereignisvariablen für Ihren Objektschlüssel, Ihren Commit oder Ihre Bild-ID abgeleitet `revisionValue` wird. Weitere Informationen finden Sie in dem optionalen Schritt für die Eingabe der Eingabetransformation, der in den Verfahren unter [Amazon ECR-Quellaktionen und Ressourcen EventBridge](create-cwe-ecr-source.md)[Herstellen einer Verbindung zu Amazon S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle](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 (Amazon ECR-Beispiel)](#action-reference-ECR-example)
+ [Weitere Informationen finden Sie auch unter](#action-reference-ECR-links)

## Aktionstyp
<a name="action-reference-ECR-type"></a>
+ Kategorie: `Source`
+ Eigentümer: `AWS`
+ Anbieter: `ECR`
+ Version: `1`

## Konfigurationsparameter
<a name="action-reference-ECR-config"></a>

**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)
<a name="action-reference-ECR-input"></a>
+ **Anzahl der Artefakte: ** `0`
+ **Beschreibung:** Eingabe-Artefakte sind für diesen Aktionstyp nicht gültig.

## Ausgabeartefakte
<a name="action-reference-ECR-output"></a>
+ **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 [Detail.json Image-Datei für Amazon blue/green ECS-Bereitstellungsaktionen](file-reference.md#file-reference-ecs-bluegreen).

## Ausgabevariablen
<a name="action-reference-ECR-variables"></a>

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 [Variablenreferenz](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 Quellrevision überschrieben wird.

**ImageDigest**  
Der `sha256`-Digest des Image-Manifests.

**ImageURI**  
Der URI für das Image.

## Berechtigungen für Servicerollen: Amazon ECR-Aktion
<a name="edit-role-ecr"></a>

Um Amazon ECR-Support zu erhalten, 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 (Amazon ECR-Beispiel)
<a name="action-reference-ECR-example"></a>

------
#### [ 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
<a name="action-reference-ECR-links"></a>

Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion.
+ [Tutorial: Erstellen Sie eine Pipeline mit einer Amazon ECR-Quelle und Bereitstellung ECS-to-CodeDeploy](tutorials-ecs-ecr-codedeploy.md)— Dieses Tutorial enthält eine AppSpec Beispieldatei sowie eine CodeDeploy Beispielanwendung und eine Bereitstellungsgruppe zum Erstellen einer Pipeline mit einer CodeCommit Amazon ECR-Quelle, die auf Amazon ECS-Instances bereitgestellt wird.