Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Referensi tindakan sumber Amazon ECR
<a name="action-reference-ECR"></a>

Memicu pipeline saat gambar baru didorong ke repositori Amazon ECR. Tindakan ini menyediakan file definisi gambar yang merujuk URI untuk gambar yang didorong ke Amazon ECR. Tindakan sumber ini sering digunakan bersama dengan aksi sumber lain, seperti CodeCommit, untuk memungkinkan lokasi sumber untuk semua artefak sumber lainnya. Untuk informasi selengkapnya, lihat [Tutorial: Membuat pipeline dengan sumber dan ECS-to-CodeDeploy penerapan Amazon ECR](tutorials-ecs-ecr-codedeploy.md).

Saat Anda menggunakan konsol untuk membuat atau mengedit pipeline, CodePipeline buat EventBridge aturan yang memulai pipeline saat terjadi perubahan di repositori.

**catatan**  
Untuk Amazon ECR, Amazon S3, CodeCommit atau sumber, Anda juga dapat membuat penggantian sumber menggunakan entri transformasi input untuk menggunakan `revisionValue` peristiwa EventBridge in untuk pipeline Anda, yang berasal dari variabel peristiwa sumber untuk kunci objek, komit, atau ID gambar Anda. `revisionValue` Untuk informasi selengkapnya, lihat langkah opsional untuk entri transformasi masukan yang disertakan dalam prosedur di bawah[Tindakan sumber dan sumber daya Amazon ECR EventBridge](create-cwe-ecr-source.md),[Menyambungkan ke tindakan sumber Amazon S3 dengan sumber yang diaktifkan untuk acara](create-S3-source-events.md), atau[CodeCommit tindakan sumber dan EventBridge](triggering.md).

Anda harus sudah membuat repositori Amazon ECR dan mendorong gambar sebelum Anda menghubungkan pipeline melalui tindakan Amazon ECR.

**Topics**
+ [Tipe tindakan](#action-reference-ECR-type)
+ [Parameter konfigurasi](#action-reference-ECR-config)
+ [Artefak masukan](#action-reference-ECR-input)
+ [Artefak keluaran](#action-reference-ECR-output)
+ [Variabel keluaran](#action-reference-ECR-variables)
+ [Izin peran layanan: Tindakan Amazon ECR](#edit-role-ecr)
+ [Deklarasi tindakan (contoh Amazon ECR)](#action-reference-ECR-example)
+ [Lihat juga](#action-reference-ECR-links)

## Tipe tindakan
<a name="action-reference-ECR-type"></a>
+ Kategori: `Source`
+ Pemilik: `AWS`
+ Penyedia: `ECR`
+ Versi: `1`

## Parameter konfigurasi
<a name="action-reference-ECR-config"></a>

**RepositoryName**  
Wajib: Ya  
Nama repositori Amazon ECR tempat gambar didorong.

**ImageTag**  
Wajib: Tidak  
Tag yang digunakan untuk gambar.  
Jika nilai untuk tidak `ImageTag` ditentukan, nilai default ke. `latest`

## Artefak masukan
<a name="action-reference-ECR-input"></a>
+ **Jumlah artefak:** `0`
+ **Deskripsi:** Artefak masukan tidak berlaku untuk jenis tindakan ini.

## Artefak keluaran
<a name="action-reference-ECR-output"></a>
+ **Jumlah artefak:** `1` 
+ **Deskripsi:** Tindakan ini menghasilkan artefak yang berisi `imageDetail.json` file yang berisi URI untuk gambar yang memicu eksekusi pipeline. Untuk informasi tentang `imageDetail.json` file, lihat[File ImageDetail.json untuk tindakan penerapan Amazon ECS blue/green](file-reference.md#file-reference-ecs-bluegreen).

## Variabel keluaran
<a name="action-reference-ECR-variables"></a>

Ketika dikonfigurasi, tindakan ini menghasilkan variabel yang dapat direferensikan oleh konfigurasi tindakan tindakan hilir dalam pipeline. Tindakan ini menghasilkan variabel yang dapat dilihat sebagai variabel keluaran, bahkan jika tindakan tidak memiliki namespace. Anda mengonfigurasi tindakan dengan namespace untuk membuat variabel-variabel tersebut tersedia untuk konfigurasi tindakan hilir.

Untuk informasi selengkapnya, lihat [Referensi variabel](reference-variables.md).

**RegistryId**  
ID AWS akun yang terkait dengan registri yang berisi repositori.

**RepositoryName**  
Nama repositori Amazon ECR tempat gambar didorong.

**ImageTag**  
Tag yang digunakan untuk gambar.  
Variabel `ImageTag` keluaran bukan keluaran saat revisi sumber diganti

**ImageDigest**  
`sha256`Intisari manifes gambar.

**ImageURI**  
URI untuk gambar.

## Izin peran layanan: Tindakan Amazon ECR
<a name="edit-role-ecr"></a>

Untuk dukungan Amazon ECR, tambahkan yang berikut ini ke pernyataan kebijakan Anda:

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

Untuk informasi lebih lanjut tentang tindakan ini, lihat[Referensi tindakan sumber Amazon ECR](#action-reference-ECR).

## Deklarasi tindakan (contoh 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"
        }
    ]
},
```

------

## Lihat juga
<a name="action-reference-ECR-links"></a>

Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan tindakan ini.
+ [Tutorial: Membuat pipeline dengan sumber dan ECS-to-CodeDeploy penerapan Amazon ECR](tutorials-ecs-ecr-codedeploy.md)— Tutorial ini menyediakan contoh file spesifikasi aplikasi dan contoh CodeDeploy aplikasi dan grup penyebaran untuk membuat pipeline dengan sumber ECR dan CodeCommit Amazon yang menyebarkan ke instans Amazon ECS.