사전 정의된 변수 사용

사전 정의된 변수는 워크플로에서 자동으로 생성되며 워크플로 작업에 사용할 수 있는 키-값 쌍입니다.

사전 정의된 변수는 모든 워크플로 작업에 사용할 수 있습니다.

사전 정의된 변수 참조

다음 지침을 사용하여 사전 정의된 변수를 참조할 수 있습니다.

전제 조건

참조하려는 사전 정의된 변수의 이름 (예:) 을 결정합니다. CommitId 자세한 정보는 워크플로에서 내보내는 사전 정의된 변수 결정을 참조하세요.

Visual

사용할 수 없습니다. YAML 지침을 보려면 YAML을 선택하십시오.

YAML

미리 정의된 변수를 참조하려면 (YAML 편집기)

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

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

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

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

5. 편집을 선택합니다.

6. YAML을 선택합니다.

7. CodeCatalyst 액션에 다음 구문을 사용하여 사전 정의된 변수 참조를 추가합니다.

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

   바꾸기:

   • action-group-name액션 그룹 이름과 함께.

     참고

     작업 그룹이 없거나 동일한 작업 그룹의 작업에 의해 변수가 생성되는 경우에는 action-group-name생략할 수 있습니다.

   • action-name-or- WorkflowSource 포함:

     변수를 출력하는 액션의 이름.

     또는

     WorkflowSource, 변수가 BranchName 또는 CommitId 변수인 경우

   • 변수 이름이 포함된 변수 이름

   예:

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

   또 다른 예시:

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

   더 많은 예제는 사전 정의된 변수의 예를 참조합니다. 자세한 내용은 해당 작업에 워크플로우 YAML 정의 대한 를 참조하십시오.

8. (선택 사항) [Validate] 를 선택하여 커밋하기 전에 워크플로의 YAML 코드를 검증하십시오.

9. [Commit] 을 선택하고 커밋 메시지를 입력한 다음 [Commit] 을 다시 선택합니다.

워크플로에서 내보내는 사전 정의된 변수 결정

다음과 같은 두 가지 방법으로 워크플로에서 내보내는 사전 정의된 변수를 결정할 수 있습니다.

• 워크플로를 한 번 실행합니다. 실행이 완료되면 워크플로에서 생성된 변수가 실행 세부 정보 페이지의 변수 탭에 표시됩니다. 자세한 정보는 워크플로 실행 상태 및 세부 정보 보기을 참조하세요.

• 를 참조하십시오. 사전 정의된 변수 목록 이 참조에는 사전 정의된 각 변수의 변수 이름 (키) 과 값이 나열되어 있습니다.

참고

워크플로 변수의 최대 총 크기는 에 나열되어 있습니다. 워크플로우 할당량 전체 크기가 최대값을 초과하는 경우 최대값에 도달한 후에 발생하는 작업이 실패할 수 있습니다.

사전 정의된 변수의 예

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

예제

• 예: "CommitId" 사전 정의된 변수 참조
• 예: "BranchName" 사전 정의된 변수 참조

예: "CommitId" 사전 정의된 변수 참조

다음 예제는 작업에서 CommitId 사전 정의된 변수를 참조하는 방법을 보여줍니다. MyBuildAction 에서 CommitId 변수를 자동으로 출력합니다. CodeCatalyst

이 예제에서는 빌드 작업에 사용되는 변수를 보여 주지만 모든 작업에 사용할 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" 사전 정의된 변수 참조

다음 예제는 작업에서 BranchName 사전 정의된 변수를 참조하는 방법을 보여줍니다. CDKDeploy 에서 BranchName 변수를 자동으로 출력합니다. CodeCatalyst

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

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