View a markdown version of this page

Référence des actions source Amazon ECR - AWS CodePipeline
Type d'actionParamètres de configurationArtefacts d'entréeArtefacts de sortieVariables de sortieAutorisations relatives aux rôles de service : action Amazon ECRDéclaration d'action (exemple Amazon ECR)Consultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Référence des actions source Amazon ECR

Déclenche le pipeline lorsqu'une nouvelle image est envoyée vers le référentiel Amazon ECR. Cette action fournit un fichier de définitions d'image faisant référence à l'URI de l'image qui a été transmise à Amazon ECR. Cette action source est souvent utilisée conjointement avec une autre action source, par exemple CodeCommit, pour attribuer un emplacement source à tous les autres artefacts source. Pour de plus amples informations, veuillez consulter Tutoriel : Création d'un pipeline avec une source et ECS-to-CodeDeploy un déploiement Amazon ECR.

Lorsque vous utilisez la console pour créer ou modifier votre pipeline, CodePipeline crée une EventBridge règle qui démarre votre pipeline lorsqu'une modification se produit dans le référentiel.

Note

Pour Amazon ECR, Amazon S3 ou les CodeCommit sources, vous pouvez également créer un remplacement de source à l'aide d'une entrée de transformation en entrée EventBridge pour utiliser l'revisionValueentrée de votre événement de pipeline, où le revisionValue est dérivé de la variable d'événement source pour votre clé d'objet, votre commit ou votre ID d'image. Pour plus d'informations, consultez l'étape facultative pour la saisie de la transformation d'entrée incluse dans les procédures sous Actions et ressources relatives aux sources Amazon ECR EventBridgeConnexion aux actions de source Amazon S3 avec une source activée pour les événements, ouCodeCommit actions à la source et EventBridge.

Vous devez déjà avoir créé un référentiel Amazon ECR et envoyé une image avant de connecter le pipeline via une action Amazon ECR.

Type d'action

  • Catégorie : Source

  • Propriétaire : AWS

  • Fournisseur : ECR

  • Version : 1

Paramètres de configuration

RepositoryName

Obligatoire : oui

Le nom du référentiel Amazon ECR dans lequel l'image a été envoyée.

ImageTag

Obligatoire : non

Balise utilisée pour l'image.

Note

Si aucune valeur n'est spécifiée pour ImageTag, la valeur par défaut est latest.

Artefacts d'entrée

  • Nombre d'objets : 0

  • Description : Les artefacts d'entrée ne s'appliquent pas à ce type d'action.

Artefacts de sortie

Variables de sortie

Lorsque cette action est configurée, elle produit des variables qui peuvent être référencées par la configuration d'action d'une action en aval dans le pipeline. Cette action produit des variables qui peuvent être visualisées en tant que variables de sortie, même si l'action n'a pas d'espace de noms. Vous configurez une action avec un espace de noms pour rendre ces variables disponibles pour la configuration des actions en aval.

Pour de plus amples informations, veuillez consulter Référence des variables.

RegistryId

L'ID de AWS compte associé au registre qui contient le référentiel.

RepositoryName

Le nom du référentiel Amazon ECR dans lequel l'image a été envoyée.

ImageTag

Balise utilisée pour l'image.

Note

La variable ImageTag de sortie n'est pas générée lorsque la révision de la source est remplacée.

ImageDigest

Hachage sha256 du manifeste de l'image.

ImageURI

URI de l'image.

Autorisations relatives aux rôles de service : action Amazon ECR

Pour le support Amazon ECR, ajoutez ce qui suit à votre déclaration de politique :

{
    "Effect": "Allow",
    "Action": [
        "ecr:DescribeImages"
    ],
    "Resource": "resource_ARN"
},

Pour plus d'informations sur cette action, consultezRéférence des actions source Amazon ECR.

Déclaration d'action (exemple 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"
        }
    ]
},

Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action.