Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

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

# 사전 정의된 변수 사용
<a name="workflows-using-predefined-variables"></a>

*사전 정의된 변수*는 워크플로에서 자동으로 내보내고 워크플로 작업에 사용할 수 있는 키-값 페어입니다.

변수에 대한 자세한 내용은 [워크플로에서 변수 사용](workflows-working-with-variables.md) 섹션을 참조하세요.

**Topics**
+ [사전 정의된 변수 참조의 예](workflows-predefined-examples.md)
+ [사전 정의된 변수 참조](workflows-working-with-variables-reference-output-vars.md)
+ [워크플로에서 내보내는 사전 정의된 변수 확인](workflows-working-with-variables-determine-output-vars.md)
+ [사전 정의된 변수 목록](workflow-ref-action-variables.md)

# 사전 정의된 변수 참조의 예
<a name="workflows-predefined-examples"></a>

다음 예시에서는 워크플로 정의 파일에서 사전 정의된 변수를 참조하는 방법을 보여줍니다.

사전 정의된 변수에 대한 자세한 내용은 [사전 정의된 변수 사용](workflows-using-predefined-variables.md) 섹션을 참조하세요.

**Topics**
+ [예시: 'CommitId' 사전 정의된 변수 참조](#workflows-working-with-variables-ex-refer-action)
+ [예시: 'BranchName' 사전 정의된 변수 참조](#workflows-working-with-variables-ex-branch)

## 예시: 'CommitId' 사전 정의된 변수 참조
<a name="workflows-working-with-variables-ex-refer-action"></a>

다음 예시에서는 `MyBuildAction` 작업에서 사전 정의된 `CommitId` 변수를 참조하는 방법을 보여줍니다. `CommitId` 변수는 CodeCatalyst에서 자동으로 출력됩니다. 자세한 내용은 [사전 정의된 변수 목록](workflow-ref-action-variables.md) 섹션을 참조하세요.

예시에서는 빌드 작업에서 사용되는 변수를 보여주지만 모든 작업에서 `CommitId`를 사용할 수 있습니다.

```
MyBuildAction:
    Identifier: aws/build@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      Steps:
      #Build Docker image and tag it with a commit ID
        - Run: docker build -t image-repo/my-docker-image:latest .
        - Run: docker tag image-repo/my-docker-image:${WorkflowSource.CommitId}
```

## 예시: 'BranchName' 사전 정의된 변수 참조
<a name="workflows-working-with-variables-ex-branch"></a>

다음 예시에서는 `CDKDeploy` 작업에서 사전 정의된 `BranchName` 변수를 참조하는 방법을 보여줍니다. `BranchName` 변수는 CodeCatalyst에서 자동으로 출력됩니다. 자세한 내용은 [사전 정의된 변수 목록](workflow-ref-action-variables.md) 섹션을 참조하세요.

예시에서는 **AWS CDK 배포** 작업에 사용되는 변수를 보여 주지만, 모든 작업에서 `BranchName`을 사용할 수 있습니다.

```
CDKDeploy:
    Identifier: aws/cdk-deploy@v2
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      StackName: app-stack-${WorkflowSource.BranchName}
```

# 사전 정의된 변수 참조
<a name="workflows-working-with-variables-reference-output-vars"></a>

Amazon CodeCatalyst 워크플로 내의 모든 작업에서 사전 정의된 변수를 참조할 수 있습니다.

다음 지침에 따라 워크플로에서 사전 정의된 변수를 참조합니다.

사전 정의된 변수에 대한 자세한 내용은 [사전 정의된 변수 사용](workflows-using-predefined-variables.md) 섹션을 참조하세요.

**사전 조건**  
`CommitId`와 같이 참조하려는 사전 정의된 변수의 이름을 결정합니다. 자세한 내용은 [워크플로에서 내보내는 사전 정의된 변수 확인](workflows-working-with-variables-determine-output-vars.md) 섹션을 참조하세요.

------
#### [ Visual ]

*사용할 수 없습니다. YAML을 선택하여 YAML 지침을 봅니다.*

------
#### [ YAML ]

**사전 정의된 변수 참조(YAML 편집기)**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 프로젝트를 선택합니다.

1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.

1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다.

1. **편집**을 선택합니다.

1. **YAML**을 선택합니다.

1. CodeCatalyst 작업에서 다음 구문을 사용하여 사전 정의된 변수 참조를 추가합니다.

   ```
   ${action-group-name.action-name-or-WorkflowSource.variable-name}
   ```

   다음과 같이 바꿉니다.
   + *action-group-name*: 작업 이름의 그룹.
**참고**  
작업 그룹이 없거나 변수가 동일한 작업 그룹의 작업에서 생성되는 경우 *action-group-name*을 생략할 수 있습니다.
   + *action-name-or-WorkflowSource*:

     변수를 출력하는 작업의 이름.

     또는

     `WorkflowSource`, 변수가 `BranchName` 또는 `CommitId` 변수인 경우.
   + *variable-nam*을 변수 이름으로 바꿉니다.

   예제:

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${MyFirstECSAction.cluster}
   ```

   또 다른 예시:

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${WorkflowSource.CommitId}
   ```

   더 많은 예시는 [사전 정의된 변수 참조의 예](workflows-predefined-examples.md)를 참조합니다. 자세한 내용은 작업에 해당하는 [워크플로 YAML 정의](workflow-reference.md) 섹션을 참조하세요.

1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다.

1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다.

------

# 워크플로에서 내보내는 사전 정의된 변수 확인
<a name="workflows-working-with-variables-determine-output-vars"></a>

다음 절차를 사용하여 워크플로가 실행될 때 내보내는 사전 정의된 변수를 결정합니다. 그런 다음 동일한 워크플로 내에서 이러한 변수를 참조할 수 있습니다.

사전 정의된 변수에 대한 자세한 내용은 [사전 정의된 변수 사용](workflows-using-predefined-variables.md) 섹션을 참조하세요.

**워크플로에서 내보내는 사전 정의된 변수 확인**
+ 다음 중 하나를 수행하세요.
  + **워크플로를 한 번 실행합니다**. 실행이 완료되면 워크플로에서 내보내는 변수가 실행 세부 정보 페이지의 **변수** 탭에 표시됩니다. 자세한 내용은 [워크플로 실행 상태 및 세부 정보 보기](workflows-view-run.md) 섹션을 참조하세요.
  + **[사전 정의된 변수 목록](workflow-ref-action-variables.md) 섹션을 참조하세요**. 이 참조에는 사전 정의된 각 변수의 변수 이름(키)과 값이 나열됩니다.

**참고**  
워크플로 변수의 최대 총 크기는 [CodeCatalyst의 워크플로 할당량](workflows-quotas.md)에 나열되어 있습니다. 총 크기가 최대값을 초과하면 최대값에 도달한 후 발생하는 작업이 실패할 수 있습니다.

# 사전 정의된 변수 목록
<a name="workflow-ref-action-variables"></a>

다음 섹션을 참조하여 워크플로 실행의 일부로 CodeCatalyst 작업에 의해 자동으로 생성되는 사전 정의된 변수를 확인하세요.

사전 정의된 변수에 대한 자세한 내용은 [사전 정의된 변수 사용](workflows-using-predefined-variables.md) 섹션을 참조하세요.

**참고**  
이 목록에는 CodeCatalyst 소스 및 [CodeCatalyst 작업](workflows-actions.md#workflows-actions-types)에서 내보내는 사전 정의된 변수만 포함됩니다. GitHub Actions 또는 CodeCatalyst Labs 작업과 같은 다른 유형의 작업을 사용하는 경우 대신 [워크플로에서 내보내는 사전 정의된 변수 확인](workflows-working-with-variables-determine-output-vars.md)를 참조하세요.

**나열**

**참고**  
모든 CodeCatalyst 작업이 사전 정의된 변수를 생성하는 것은 아닙니다. 작업이 목록에 없으면 변수가 생성되지 않습니다.
+ ['BranchName' 및 'CommitId' 변수](workflows-sources-variables.md)
+ ['스 CloudFormation 택 배포' 변수](deploy-action-cfn-variables.md)
+ ['Amazon ECS에 배포' 변수](deploy-action-ecs-variables.md)
+ ['Kubernetes 클러스터에 배포' 변수](deploy-action-eks-variables.md)
+ ['AWS CDK 배포' 변수](cdk-dep-action-variables.md)
+ ['AWS CDK 부트스트랩' 변수](cdk-boot-action-variables.md)
+ ['AWS Lambda 간접 호출' 변수](lam-invoke-action-variables.md)
+ ['Amazon ECS 작업 정의 렌더링' 변수](render-ecs-action-variables.md)