

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Riferimento all'azione sorgente di Amazon ECR
<a name="action-reference-ECR"></a>

Attiva la pipeline quando una nuova immagine viene inviata al repository Amazon ECR. Questa azione fornisce un file di definizioni delle immagini che fa riferimento all'URI per l'immagine che è stata inviata ad Amazon ECR. Questa azione sorgente viene spesso utilizzata in combinazione con un'altra azione sorgente, ad esempio CodeCommit, per consentire una posizione di origine per tutti gli altri artefatti di origine. Per ulteriori informazioni, consulta [Tutorial: crea una pipeline con una sorgente e una distribuzione Amazon ECR ECS-to-CodeDeploy](tutorials-ecs-ecr-codedeploy.md).

Quando usi la console per creare o modificare la pipeline, CodePipeline crea una EventBridge regola che avvia la pipeline quando si verifica una modifica nel repository.

**Nota**  
Per Amazon ECR, Amazon S3 CodeCommit o sorgenti, puoi anche creare un'override di origine utilizzando input transform entry per utilizzare l' EventBridge in per `revisionValue` il tuo evento pipeline, dove è derivato dalla variabile `revisionValue` dell'evento source per la chiave oggetto, il commit o l'ID immagine. Per ulteriori informazioni, consulta il passaggio facoltativo per l'immissione della trasformazione di input incluso nelle procedure riportate in, o. [Azioni e risorse relative ai sorgenti di Amazon ECR EventBridge](create-cwe-ecr-source.md) [Connessione alle azioni di origine di Amazon S3 con una fonte abilitata per gli eventi](create-S3-source-events.md) [CodeCommit azioni di origine e EventBridge](triggering.md)

Devi aver già creato un repository Amazon ECR e inviato un'immagine prima di connettere la pipeline tramite un'azione Amazon ECR.

**Topics**
+ [Tipo di operazione](#action-reference-ECR-type)
+ [Parametri di configurazione](#action-reference-ECR-config)
+ [Input artifact (Artefatti di input)](#action-reference-ECR-input)
+ [Artefatti di output](#action-reference-ECR-output)
+ [Variabili di output](#action-reference-ECR-variables)
+ [Autorizzazioni per ruoli di servizio: azione Amazon ECR](#edit-role-ecr)
+ [Dichiarazione di azione (esempio di Amazon ECR)](#action-reference-ECR-example)
+ [Consulta anche](#action-reference-ECR-links)

## Tipo di operazione
<a name="action-reference-ECR-type"></a>
+ Categoria: `Source`
+ Proprietario: `AWS`
+ Provider: `ECR`
+ Versione: `1`

## Parametri di configurazione
<a name="action-reference-ECR-config"></a>

**RepositoryName**  
Obbligatorio: sì  
Il nome del repository Amazon ECR in cui è stata inserita l'immagine.

**ImageTag**  
Obbligatorio: no  
Il tag utilizzato per l'immagine.  
Se non viene specificato un valore per `ImageTag`, il valore predefinito è `latest`.

## Input artifact (Artefatti di input)
<a name="action-reference-ECR-input"></a>
+ **Numero di artefatti:** `0`
+ **Descrizione:** gli artefatti di input non si applicano a questo tipo di azione.

## Artefatti di output
<a name="action-reference-ECR-output"></a>
+ **Numero di artefatti:** `1` 
+ **Descrizione:** questa azione produce un artefatto che contiene un file `imageDetail.json` contenente l'URI per l'immagine che ha attivato l'esecuzione della pipeline. Per ulteriori informazioni sul file `imageDetail.json`, consulta [File ImageDetail.json per le azioni di distribuzione di Amazon ECS blue/green](file-reference.md#file-reference-ecs-bluegreen).

## Variabili di output
<a name="action-reference-ECR-variables"></a>

Quando è configurata, questa azione produce variabili che possono essere referenziate dalla configurazione dell'azione di un'azione downstream nella pipeline. Questa azione produce variabili che possono essere viste come variabili di output, anche se l'azione non ha uno spazio dei nomi. È possibile configurare un'azione con uno spazio dei nomi per rendere tali variabili disponibili per la configurazione delle azioni downstream.

Per ulteriori informazioni, consulta [Riferimento alle variabili](reference-variables.md).

**RegistryId**  
L'ID AWS dell'account associato al registro che contiene il repository.

**RepositoryName**  
Il nome del repository Amazon ECR in cui è stata inserita l'immagine.

**ImageTag**  
Il tag utilizzato per l'immagine.  
La variabile `ImageTag` di output non viene emessa quando viene sovrascritta la revisione del codice sorgente

**ImageDigest**  
Il file digest `sha256` del manifest delle immagini.

**ImageURI**  
L'URI dell'immagine.

## Autorizzazioni per ruoli di servizio: azione Amazon ECR
<a name="edit-role-ecr"></a>

Per il supporto di Amazon ECR, aggiungi quanto segue alla tua dichiarazione sulla politica:

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

Per ulteriori informazioni su questa azione, consulta[Riferimento all'azione sorgente di Amazon ECR](#action-reference-ECR).

## Dichiarazione di azione (esempio di Amazon ECR)
<a name="action-reference-ECR-example"></a>

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

------

## Consulta anche
<a name="action-reference-ECR-links"></a>

Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.
+ [Tutorial: crea una pipeline con una sorgente e una distribuzione Amazon ECR ECS-to-CodeDeploy](tutorials-ecs-ecr-codedeploy.md)— Questo tutorial fornisce un esempio di file di specifiche dell'app e un gruppo di CodeDeploy applicazione e distribuzione di esempio per creare una pipeline con una fonte CodeCommit Amazon ECR da distribuire su istanze Amazon ECS.