As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Referência da ação de origem do Amazon ECR
Aciona o pipeline quando uma nova imagem é enviada por push para o repositório do Amazon ECR. Essa ação fornece um arquivo de definições de imagem que faz referência ao URI da imagem que foi enviada por push ao Amazon ECR. Essa ação de origem geralmente é usada em conjunto com outra ação de origem, como CodeCommit, para permitir um local de origem para todos os outros artefatos de origem. Para obter mais informações, consulte [Tutorial: Crie um pipeline com uma fonte e ECS-to-CodeDeploy implantação do Amazon ECR](tutorials-ecs-ecr-codedeploy.md).
Quando você usa o console para criar ou editar seu pipeline, CodePipeline cria uma EventBridge regra que inicia seu pipeline quando ocorre uma alteração no repositório.
**nota**
Para Amazon ECR, Amazon S3 CodeCommit ou fontes, você também pode criar uma substituição de origem usando a entrada de transformação de entrada para usar `revisionValue` o EventBridge in para seu evento de pipeline, onde `revisionValue` o é derivado da variável de evento de origem para sua chave de objeto, confirmação ou ID de imagem. Para saber mais, consulte a etapa opcional da entrada da transformação de entrada incluída nos procedimentos em [Recursos e ações de origem do Amazon ECR EventBridge](create-cwe-ecr-source.md), [Conexão a ações de origem do Amazon S3 com uma fonte habilitada para eventos](create-S3-source-events.md) ou [CodeCommit ações de origem e EventBridge](triggering.md).
Você já deve ter criado um repositório do Amazon ECR e enviado uma imagem por push para que possa conectar o pipeline por meio de uma ação do Amazon ECR.
**Topics**
+ [Tipo de ação](#action-reference-ECR-type)
+ [Parâmetros de configuração](#action-reference-ECR-config)
+ [Input artifacts (Artefatos de entrada)](#action-reference-ECR-input)
+ [Artefatos de saída](#action-reference-ECR-output)
+ [Variáveis de saída](#action-reference-ECR-variables)
+ [Permissões do perfil de serviço: ação do Amazon ECR](#edit-role-ecr)
+ [Declaração de ação (exemplo do Amazon ECR)](#action-reference-ECR-example)
+ [Consulte também](#action-reference-ECR-links)
## Tipo de ação
+ Categoria: `Source`
+ Proprietário: `AWS`
+ Fornecedor: `ECR`
+ Versão: `1`
## Parâmetros de configuração
**RepositoryName**
Obrigatório: Sim
O nome do repositório do Amazon ECR ao qual a imagem foi enviada por push.
**ImageTag**
Obrigatório: não
A tag usada para a imagem.
Se não for especificado um valor para `ImageTag`, o valor assumirá `latest` como padrão.
## Input artifacts (Artefatos de entrada)
+ **Número de artefatos:** `0`
+ **Descrição:** os artefatos de entrada não se aplicam a esse tipo de ação.
## Artefatos de saída
+ **Número de artefatos:** `1`
+ **Descrição:** esta ação produz um artefato que contém um arquivo `imageDetail.json` que contém o URI da imagem que acionou a execução do pipeline. Para mais informações sobre o arquivo `imageDetail.json`, consulte [Arquivo ImageDetail.json para ações de implantação do Amazon ECS blue/green](file-reference.md#file-reference-ecs-bluegreen).
## Variáveis de saída
Quando configurada, essa ação produz variáveis que podem ser referenciadas pela configuração de ação de uma ação downstream no pipeline. Esta ação produz variáveis que podem ser visualizadas como variáveis de saída, mesmo que a ação não tenha um namespace. Configure uma ação com um namespace a fim de disponibilizar as variáveis para a configuração de ações downstream.
Para obter mais informações, consulte [Referência de variáveis](reference-variables.md).
**RegistryId**
O ID da AWS conta associado ao registro que contém o repositório.
**RepositoryName**
O nome do repositório do Amazon ECR ao qual a imagem foi enviada por push.
**ImageTag**
A tag usada para a imagem.
A variável de saída `ImageTag` não é produzida quando a revisão da origem é substituída
**ImageDigest**
O resumo `sha256` do manifesto da imagem.
**ImageURI**
O URI da imagem.
## Permissões do perfil de serviço: ação do Amazon ECR
Para compatibilidade com o Amazon ECR, adicione o seguinte à declaração da política:
```
{
"Effect": "Allow",
"Action": [
"ecr:DescribeImages"
],
"Resource": "resource_ARN"
},
```
Para obter mais informações sobre a ação, consulte [Referência da ação de origem do Amazon ECR](#action-reference-ECR).
## Declaração de ação (exemplo do 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"
}
]
},
```
------
## Consulte também
Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.
+ [Tutorial: Crie um pipeline com uma fonte e ECS-to-CodeDeploy implantação do Amazon ECR](tutorials-ecs-ecr-codedeploy.md)— Este tutorial fornece um exemplo de arquivo de especificação do aplicativo e um exemplo de grupo de CodeDeploy aplicação e implantação para criar um pipeline com uma CodeCommit fonte do Amazon ECR que é implantada em instâncias do Amazon ECS.