Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Referencia de acciones de origen de Amazon ECR
Activa la canalización cuando se envía una nueva imagen al repositorio de Amazon ECR. Esta acción proporciona un archivo de definiciones de imagen que hace referencia al URI de la imagen que se ha enviado a Amazon ECR. Esta acción de origen se utiliza a menudo junto con otra acción de origen, como CodeCommit, para permitir una ubicación de origen para todos los demás artefactos de origen. Para obtener más información, consulte [Tutorial: Creación de una canalización con una fuente y ECS-to-CodeDeploy una implementación de Amazon ECR](tutorials-ecs-ecr-codedeploy.md).
Cuando utilizas la consola para crear o editar tu canalización, CodePipeline crea una EventBridge regla que inicia tu canalización cuando se produce un cambio en el repositorio.
**nota**
Para Amazon ECR, Amazon S3 o CodeCommit Sources, también puedes crear una anulación de fuente mediante la entrada input transform para usar la entrada `revisionValue` in EventBridge para tu evento de canalización, donde `revisionValue` se deriva de la variable de evento de origen para tu clave de objeto, confirmación o ID de imagen. Para obtener más información, consulte el paso opcional para la entrada de transformación de entrada, que se incluye en los procedimientos de [Acciones y recursos fuente de Amazon ECR EventBridge](create-cwe-ecr-source.md), [Conexión a acciones de origen de Amazon S3 con un origen habilitado para eventos](create-S3-source-events.md) o [CodeCommit acciones de origen y EventBridge](triggering.md).
Ya debe haber creado un repositorio de Amazon ECR y enviado una imagen antes de conectar la canalización a través de una acción de Amazon ECR.
**Topics**
+ [Tipo de acción](#action-reference-ECR-type)
+ [Parámetros de configuración](#action-reference-ECR-config)
+ [Artefactos de entrada](#action-reference-ECR-input)
+ [Artefactos de salida](#action-reference-ECR-output)
+ [Variables de salida](#action-reference-ECR-variables)
+ [Permisos del rol de servicio: acción de Amazon ECR](#edit-role-ecr)
+ [Declaración de acción (ejemplo de Amazon ECR)](#action-reference-ECR-example)
+ [Véase también](#action-reference-ECR-links)
## Tipo de acción
+ Categoría: `Source`
+ Propietario: `AWS`
+ Proveedor: `ECR`
+ Versión: `1`
## Parámetros de configuración
**RepositoryName**
Obligatorio: sí
El nombre del repositorio de Amazon ECR al que se envió la imagen.
**ImageTag**
Obligatorio: no
La etiqueta utilizada para la imagen.
Si no se especifica un valor para `ImageTag`, el valor predeterminado es `latest`.
## Artefactos de entrada
+ **Número de artefactos:** `0`
+ **Descripción:** los artefactos de entrada no se aplican a este tipo de acción.
## Artefactos de salida
+ **Número de artefactos:** `1`
+ **Descripción:** esta acción produce un artefacto que contiene un archivo `imageDetail.json` que contiene el URI de la imagen que desencadenó la ejecución de la canalización. Para obtener más información sobre el archivo `imageDetail.json`, consulte [Archivo ImageDetail.json para las acciones de implementación de Amazon ECS blue/green](file-reference.md#file-reference-ecs-bluegreen).
## Variables de salida
Cuando se configura, esta acción produce variables a las que se puede hacer referencia mediante la configuración de acción de una acción descendente en la canalización. Esta acción produce variables que se pueden ver como variables de salida, incluso si la acción no tiene un espacio de nombres. Configure una acción con un espacio de nombres para que esas variables estén disponibles para la configuración de las acciones posteriores.
Para obtener más información, consulte [Referencia de variables](reference-variables.md).
**RegistryId**
El ID de AWS cuenta asociado al registro que contiene el repositorio.
**RepositoryName**
El nombre del repositorio de Amazon ECR al que se envió la imagen.
**ImageTag**
La etiqueta utilizada para la imagen.
La variable de salida `ImageTag` no se genera cuando se anula la revisión de origen
**ImageDigest**
El resumen `sha256` del manifiesto de la imagen.
**ImageURI**
El URI de la imagen.
## Permisos del rol de servicio: acción de Amazon ECR
Para admitir Amazon ECR, añada lo siguiente a su instrucción de política:
```
{
"Effect": "Allow",
"Action": [
"ecr:DescribeImages"
],
"Resource": "resource_ARN"
},
```
Para obtener más información sobre esta acción, consulte [Referencia de acciones de origen de Amazon ECR](#action-reference-ECR).
## Declaración de acción (ejemplo de 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"
}
]
},
```
------
## Véase también
Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta acción.
+ [Tutorial: Creación de una canalización con una fuente y ECS-to-CodeDeploy una implementación de Amazon ECR](tutorials-ecs-ecr-codedeploy.md)— Este tutorial proporciona un ejemplo de archivo de especificaciones de la CodeDeploy aplicación y un grupo de implementación para crear una canalización con una CodeCommit fuente de Amazon ECR que se implemente en instancias de Amazon ECS.