기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon ECR 소스 작업 참조
<a name="action-reference-ECR"></a>

새 이미지가 Amazon ECR 리포지토리로 푸시될 때 파이프라인을 트리거합니다. 이 작업은 Amazon ECR에 푸시된 이미지의 URI를 참조하는 이미지 정의 파일을 제공합니다. 이 소스 작업은 다른 모든 소스 아티팩트에 대한 소스 위치를 허용하기 위해 CodeCommit 같은 다른 소스 작업과 함께 사용되는 경우가 많습니다. 자세한 내용은 [자습서: Amazon ECR 소스 및 ECS-to-CodeDeploy 배포를 사용하여 파이프라인 생성](tutorials-ecs-ecr-codedeploy.md) 단원을 참조하십시오.

콘솔을 사용하여 파이프라인을 생성 또는 편집하면 CodePipeline에서 리포지토리에서 변경이 발생할 때 파이프라인을 시작하는 EventBridge 규칙이 생성됩니다.

**참고**  
Amazon ECR, Amazon S3 또는 CodeCommit 소스의 경우 입력 변환 항목을 사용하여 소스 재정의를 생성하여 파이프라인 이벤트에 EventBridge의 `revisionValue`를 사용할 수도 있습니다. 여기서 `revisionValue`는 객체 키, 커밋 또는 이미지 ID의 소스 이벤트 변수에서 파생됩니다. 자세한 내용은 [Amazon ECR 소스 작업 및 EventBridge 리소스](create-cwe-ecr-source.md), [이벤트에 대해 활성화된 소스를 사용하여 Amazon S3 소스 작업에 연결](create-S3-source-events.md), 또는 [CodeCommit 소스 작업 및 EventBridge](triggering.md)의 절차에 포함된 입력 변환 항목의 선택적 단계를 참조하세요.

Amazon ECR 작업을 통해 파이프라인을 연결하기 전에 이미 Amazon ECR 리포지토리를 생성하고 이미지를 푸시해야 합니다.

**Topics**
+ [작업 유형](#action-reference-ECR-type)
+ [구성 파라미터](#action-reference-ECR-config)
+ [입력 아티팩트](#action-reference-ECR-input)
+ [출력 아티팩트](#action-reference-ECR-output)
+ [출력 변수](#action-reference-ECR-variables)
+ [서비스 역할 권한: Amazon ECR 작업](#edit-role-ecr)
+ [작업 선언(Amazon ECR 예제)](#action-reference-ECR-example)
+ [다음 사항도 참조하세요.](#action-reference-ECR-links)

## 작업 유형
<a name="action-reference-ECR-type"></a>
+ 범주: `Source`
+ 소유자: `AWS`
+ 공급자: `ECR`
+ 버전: `1`

## 구성 파라미터
<a name="action-reference-ECR-config"></a>

**RepositoryName**  
필수 항목 여부: 예  
이미지가 푸시된 Amazon ECR 리포지토리의 이름입니다.

**ImageTag**  
필수 여부: 아니요  
이미지에 사용되는 태그입니다.  
`ImageTag`의 값을 지정하지 않는 경우, 기본값은 `latest`입니다.

## 입력 아티팩트
<a name="action-reference-ECR-input"></a>
+ **아티팩트 수:** `0`
+ **설명:** 이 작업 유형에는 입력 아티팩트가 적용되지 않습니다.

## 출력 아티팩트
<a name="action-reference-ECR-output"></a>
+ **아티팩트 수:** `1` 
+ **설명:** 이 작업은 파이프라인 실행을 트리거한 이미지의 URI를 포함하는 `imageDetail.json` 파일을 포함하는 아티팩트를 생성합니다. `imageDetail.json` 파일에 대한 자세한 내용은 [Amazon ECS 블루/그린 배포 작업을 위한 imageDetail.json 파일](file-reference.md#file-reference-ecs-bluegreen) 단원을 참조하십시오.

## 출력 변수
<a name="action-reference-ECR-variables"></a>

이 작업을 구성하면 파이프라인에서 다운스트림 작업의 작업 구성에서 참조할 수 있는 변수가 생성됩니다. 이 작업은 작업에 네임스페이스가 없는 경우에도 출력 변수로 볼 수 있는 변수를 생성합니다. 이러한 변수를 다운스트림 작업 구성에서 사용할 수 있도록 네임스페이스를 사용하여 작업을 구성합니다.

자세한 내용은 [변수 참조](reference-variables.md) 단원을 참조하십시오.

**RegistryId**  
리포지토리가 포함된 레지스트리와 연결된 AWS 계정 ID입니다.

**RepositoryName**  
이미지가 푸시된 Amazon ECR 리포지토리의 이름입니다.

**ImageTag**  
이미지에 사용되는 태그입니다.  
소스 개정이 재정의되면 `ImageTag` 출력 변수가 출력되지 않습니다.

**ImageDigest**  
이미지 매니페스트의 `sha256` 다이제스트입니다.

**imageURI**  
이미지의 URI입니다.

## 서비스 역할 권한: Amazon ECR 작업
<a name="edit-role-ecr"></a>

Amazon ECR 지원의 경우 다음을 정책 설명에 추가합니다.

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

이 작업에 대한 자세한 내용은 [Amazon ECR 소스 작업 참조](#action-reference-ECR) 섹션을 참조하세요.

## 작업 선언(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"
        }
    ]
},
```

------

## 다음 사항도 참조하세요.
<a name="action-reference-ECR-links"></a>

이 작업을 수행할 때 참조할 수 있는 관련 리소스는 다음과 같습니다.
+ [자습서: Amazon ECR 소스 및 ECS-to-CodeDeploy 배포를 사용하여 파이프라인 생성](tutorials-ecs-ecr-codedeploy.md) - 이 자습서에서는 Amazon ECS 인스턴스에 배포하는 CodeCommit 및 Amazon ECR 소스가 있는 파이프라인을 생성할 수 있는 샘플 앱 사양 파일과 샘플 CodeDeploy 애플리케이션 및 배포 그룹을 제공합니다.