View a markdown version of this page

Referenz zur Amazon ECR-Quellaktion - AWS CodePipeline
AktionstypKonfigurationsparameterInput artifacts (Eingabeartefakte)AusgabeartefakteAusgabevariablenBerechtigungen für Servicerollen: Amazon ECR-AktionAktionserklärung (Amazon ECR-Beispiel)Weitere Informationen finden Sie auch unter

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: Erstellen Sie eine Pipeline mit einer Amazon ECR-Quelle und Bereitstellung ECS-to-CodeDeploy.

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 EventBridgeHerstellen einer Verbindung zu Amazon S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle, oder CodeCommit Quellaktionen und EventBridge 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.

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.

Anmerkung

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

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 Variablenreferenz.

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.

Anmerkung

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

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 unterReferenz zur Amazon ECR-Quellaktion.

Aktionserklärung (Amazon ECR-Beispiel)

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"
        }
    ]
},

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