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 d'action source Amazon ECR
Déclenche le pipeline lorsqu'une nouvelle image est envoyée au référentiel Amazon ECR. Cette action fournit un fichier de définitions d'image faisant référence à l'URI de l'image 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 Amazon ECR et déploiement ECS-to-CodeDeploy](tutorials-ecs-ecr-codedeploy.md).
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 intervient dans le référentiel.
**Note**
Pour Amazon ECR, Amazon S3 ou les CodeCommit sources, vous pouvez également créer une substitution de source en utilisant l'entrée input transform pour utiliser l'événement `revisionValue` in EventBridge pour votre pipeline, dérivé de la `revisionValue` variable d'événement source correspondant à votre clé d'objet, à votre commit ou à votre identifiant d'image. Pour plus d'informations, consultez l'étape facultative de saisie de la transformation d'entrée incluse dans les procédures [Actions et ressources relatives aux sources Amazon ECR EventBridge](create-cwe-ecr-source.md) décrites sous[Connexion aux actions source Amazon S3 avec une source activée pour les événements](create-S3-source-events.md), ou[CodeCommit actions à la source et EventBridge](triggering.md).
Vous devez déjà avoir créé un référentiel Amazon ECR et envoyé une image avant de connecter le pipeline par le biais d'une action Amazon ECR.
**Topics**
+ [Type d'action](#action-reference-ECR-type)
+ [Paramètres de configuration](#action-reference-ECR-config)
+ [Artefacts d'entrée](#action-reference-ECR-input)
+ [Artefacts de sortie](#action-reference-ECR-output)
+ [Variables de sortie](#action-reference-ECR-variables)
+ [Autorisations relatives aux rôles de service : action Amazon ECR](#edit-role-ecr)
+ [Déclaration d'action (exemple Amazon ECR)](#action-reference-ECR-example)
+ [Consultez aussi](#action-reference-ECR-links)
## Type d'action
+ Catégorie : `Source`
+ Propriétaire : `AWS`
+ Fournisseur : `ECR`
+ Version : `1`
## Paramètres de configuration
**RepositoryName**
Obligatoire : oui
Nom du référentiel Amazon ECR dans lequel l'image a été transférée.
**ImageTag**
Obligatoire : non
Balise utilisée pour l'image.
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
+ **Nombre d'objets :** `1`
+ **Description :** Cette action produit un artefact qui contient un fichier `imageDetail.json` dans lequel figure l'URI de l'image ayant déclenché l'exécution du pipeline. Pour de plus amples informations concernant le fichier `imageDetail.json`, veuillez consulter [Fichier ImageDetail.json pour les actions de déploiement d'Amazon ECS blue/green](file-reference.md#file-reference-ecs-bluegreen).
## 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 aux variables](reference-variables.md).
**RegistryId**
L'ID de AWS compte associé au registre qui contient le référentiel.
**RepositoryName**
Nom du référentiel Amazon ECR dans lequel l'image a été transférée.
**ImageTag**
Balise utilisée pour l'image.
La variable `ImageTag` de sortie n'est pas sortie 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, consultez[Référence d'action source Amazon ECR](#action-reference-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"
}
]
},
```
------
## Consultez aussi
Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action.
+ [Tutoriel : Création d'un pipeline avec une source Amazon ECR et déploiement ECS-to-CodeDeploy](tutorials-ecs-ecr-codedeploy.md)— Ce didacticiel fournit un exemple de fichier de spécifications d'application ainsi qu'un exemple d' CodeDeploy application et de groupe de déploiement pour créer un pipeline avec une CodeCommit source Amazon ECR déployée sur des instances Amazon ECS.