기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS CodePipeline 작업 참조 호출
CodePipeline 간접 호출 작업을 사용하여 다운스트림 파이프라인 실행을 트리거하고 파이프라인 간에 파이프라인 변수 및 소스 개정을 전달하는 작업을 간소화할 수 있습니다.
**참고**
이 작업은 V2 유형 파이프라인에서만 지원됩니다.
**Topics**
+ [작업 유형](#action-reference-PipelineInvoke-type)
+ [구성 파라미터](#action-reference-PipelineInvoke-parameters)
+ [입력 아티팩트](#action-reference-PipelineInvoke-input)
+ [출력 아티팩트](#action-reference-PipelineInvoke-output)
+ [CodePipeline 간접 호출 작업에 대한 서비스 역할 정책 권한](#action-reference-PipelineInvoke-permissions-action)
+ [작업 선언](#action-reference-PipelineInvoke-example)
+ [다음 사항도 참조하세요.](#action-reference-PipelineInvoke-links)
## 작업 유형
+ 범주: `Invoke`
+ 소유자: `AWS`
+ 공급자: `CodePipeline`
+ 버전: `1`
## 구성 파라미터
**PipelineName**
필수 항목 여부: 예
실행 시 현재 대상 파이프라인을 시작할 파이프라인의 이름입니다. 호출 파이프라인을 이미 생성했어야 합니다. 작업은 `my-s3-pipeline`이라는 (간접 호출) 파이프라인이 실행을 시작할 때 `s3-pipeline-test` (대상) 파이프라인을 시작합니다.
**SourceRevisions**
필수 여부: 아니요
대상 파이프라인이 간접 호출 파이프라인에 의해 시작될 때 사용할 소스 개정입니다. 예를 들어 S3 소스 작업은 S3 버전 ID 및 객체 키와 같은 출력 변수를 제공합니다. 파이프라인이 호출될 때 사용할 개정 값을 지정할 수 있습니다.
CLI의 경우 소스 개정을 직렬화된 JSON 문자열로 지정합니다. 소스 개정 재정의를 사용하는 방법에 대한 자세한 내용은 *CodePipeline API 안내서*의 [SourceRevisionOverride](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SourceRevisionOverride.html)를 참조하세요.
매핑은 다음 예제와 같이 문자열 형식을 사용합니다.
```
[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]
```
**변수**
필수 여부: 아니요
작업이 지원할 변수의 이름과 값입니다.
CLI의 경우 변수를 직렬화된 JSON 문자열로 지정합니다. 파이프라인 변수 사용에 대한 자세한 내용은 *CodePipeline API 안내서*의 [PipelineVariable](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_PipelineVariable.html)을 참조하세요.
매핑은 다음 예제와 같이 문자열 형식을 사용합니다.
```
[{"name":"VAR1","value":"VALUE1"}]
```
다음 이미지는 콘솔의 파이프라인에 추가된 작업의 예를 보여줍니다.
다음 이미지는 해당 작업의 **편집** 페이지 예를 보여줍니다. 다음 예제에서 `s3-pipeline-test` 파이프라인에는 콘솔에 대해 표시된 대로 구성된 파이프라인 호출 작업이 있습니다. 작업은 `my-s3-pipeline` 파이프라인이 실행을 완료하면 `s3-pipeline-test` 파이프라인을 시작합니다. 이 예에서는 S3\_OBJECT\_VERSION\_ID 소스에 대한 소스 개정 재정의가 지정된 개정 값 `zq8mjNYEexample`로 재정의됨을 보여줍니다.
## 입력 아티팩트
+ **아티팩트 수:** `0`
+ **설명:** 이 작업 유형에는 입력 아티팩트가 적용되지 않습니다.
## 출력 아티팩트
+ **아티팩트 수:** `0`
+ **설명:** 이 작업 유형에는 출력 아티팩트가 적용되지 않습니다.
## CodePipeline 간접 호출 작업에 대한 서비스 역할 정책 권한
CodePipeline이 작업을 실행하면 최소 `codepipeline:StartPipelineExecution` 권한으로 액세스를 유지하기 위해 CodePipeline 서비스 역할 정책에 파이프라인 리소스 ARN으로 범위가 적절하게 축소된 다음 최소 권한이 필요합니다.
```
{
"Sid": "StatementForPipelineInvokeAction",
"Effect": "Allow",
"Action": "codepipeline:StartPipelineExecution",
"Resource": [
"arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}"
]
}
```
## 작업 선언
------
#### [ YAML ]
```
name: Invoke-pipeline
actionTypeId:
category: Invoke
owner: AWS
provider: CodePipeline
version: '1'
runOrder: 2
configuration:
PipelineName: my-s3-pipeline
SourceRevisions: '[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]'
Variables: '[{"name":"VAR1","value":"VALUE1"}]'
```
------
#### [ JSON ]
```
{
"name": "Invoke-pipeline",
"actionTypeId": {
"category": "Invoke",
"owner": "AWS",
"provider": "CodePipeline",
"version": "1"
},
"runOrder": 2,
"configuration": {
"PipelineName": "my-s3-pipeline",
"SourceRevisions": "[{\"actionName\":\"Source\",\"revisionType\":\"S3_OBJECT_VERSION_ID\",\"revisionValue\":\"zq8mjNEXAMPLE"}]",
"Variables": "[{\"name\":\"VAR1\",\"value\":\"VALUE1\"}]"
}
},
```
------
## 다음 사항도 참조하세요.
이 작업을 수행할 때 참조할 수 있는 관련 리소스는 다음과 같습니다.
+ [소스 개정 재정의로 파이프라인 시작](pipelines-trigger-source-overrides.md) - 이 섹션에서는 수동으로 또는 EventBridge 이벤트 입력 변환기를 통해 소스 개정을 사용하여 파이프라인을 시작하는 방법을 설명합니다.