'Amazon ECS 작업 정의 렌더링' 작업 YAML - Amazon CodeCatalyst
ECSRenderTaskDefinitionIdentifierDependsOnComputeTypeFleetTimeoutInputsSourcesArtifacts - inputVariables - inputConfigurationtask-definitioncontainer-definition-nameimageenvironment-variablesOutputsArtifactsNameFilesVariables

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

'Amazon ECS 작업 정의 렌더링' 작업 YAML

다음은 Render Amazon ECS 작업 YAML 정의 작업의 정의입니다. 이 작업의 사용 방법을 알아보려면 을 참조하십시오Amazon ECS 작업 정의 수정.

이 작업 정의는 광범위한 워크플로 정의 파일 내에 섹션으로 존재합니다. 이 파일에 대한 자세한 내용은 워크플로 YAML 정의을 참조합니다.

참고

다음에 나오는 대부분의 YAML 속성에는 비주얼 편집기에 해당하는 UI 요소가 있습니다. UI 요소를 검색하려면 Ctrl+F를 사용합니다. 요소가 관련 YAML 속성과 함께 나열됩니다.

# The workflow definition starts here.
# See 최상위 속성 for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.   
  ECSRenderTaskDefinition_nn: 
    Identifier: aws/ecs-render-task-definition@v1
    DependsOn:
      - build-action
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Inputs:
      # Specify a source or an artifact, but not both.
      Sources:
        - source-name-1
      Artifacts:
        - task-definition-artifact
      Variables:
        - Name: variable-name-1
          Value: variable-value-1
        - Name: variable-name-2
          Value: variable-value-2
    Configuration 
      task-definition: task-definition-path
      container-definition-name: container-definition-name
      image: docker-image-name
      environment-variables:
        - variable-name-1=variable-value-1
        - variable-name-2=variable-value-2
    Outputs:
      Artifacts:
        - Name: TaskDefArtifact
          Files: "task-definition*"
      Variables:
        - task-definition

ECSRenderTaskDefinition

(필수)

액션의 이름을 지정합니다. 모든 작업 이름은 워크플로 내에서 고유해야 합니다. 액션 이름은 영숫자 (a-z, A-Z, 0-9), 하이픈 (-), 밑줄 (_) 로 제한됩니다. 공백은 허용되지 않습니다. 액션 이름에 특수 문자와 공백을 사용할 때는 따옴표를 사용할 수 없습니다.

기본값: ECSRenderTaskDefinition_nn.

해당 UI: 구성 탭/ 작업 이름

Identifier

(ECSRenderTaskDefinition/Identifier)

(필수)

작업을 식별합니다. 버전을 변경하려는 경우가 아니면 이 속성을 변경하지 마십시오. 자세한 내용은 사용할 작업 버전 지정 단원을 참조하십시오.

기본값: aws/ecs-render-task-definition@v1.

해당 UI: 워크플로 다이어그램/ ECSRenderTaskDefinition _n/ aws/ @v1 라벨 ecs-render-task-definition

DependsOn

(ECSRenderTaskDefinition/DependsOn)

(선택 사항)

이 작업을 실행하기 위해 성공적으로 실행되어야 하는 작업, 작업 그룹 또는 게이트를 지정하십시오.

'종속 조건' 기능에 대한 자세한 내용은 을 참조하십시오. 시퀀스 작업

해당 UI: 입력 탭/ 기준 - 선택 사항

Compute

(ECSRenderTaskDefinition/Compute)

(선택 사항)

워크플로 작업을 실행하는 데 사용되는 컴퓨팅 엔진. 워크플로 수준 또는 작업 수준에서 컴퓨팅을 지정할 수 있지만 둘 다에서 지정할 수는 없습니다. 워크플로 수준에서 지정된 경우 컴퓨팅 구성은 워크플로에 정의된 모든 작업에 적용됩니다. 워크플로 수준에서는 동일한 인스턴스에서 여러 작업을 실행할 수도 있습니다. 자세한 내용은 작업 간 컴퓨팅 공유 단원을 참조하십시오.

해당 UI: 없음

Type

(ECSRenderTaskDefinition/Compute/Type)

(포함된 Compute 경우 필수)

컴퓨팅 엔진 유형. 다음 값 중 하나를 사용할 수 있습니다.

  • EC2(비주얼 에디터) 또는 EC2 (YAML에디터)

    작업 실행 중 유연성을 위해 최적화되었습니다.

  • Lambda (비주얼 에디터) 또는 (에디터) Lambda YAML

    작업 시작 속도를 최적화했습니다.

컴퓨팅 유형에 대한 자세한 정보는 컴퓨팅 유형을 참고하세요.

해당 UI: 구성 탭/ 컴퓨팅 유형

Fleet

(ECSRenderTaskDefinition/Compute/Fleet)

(선택 사항)

워크플로 또는 워크플로 작업을 실행할 시스템 또는 플릿을 지정합니다. 온디맨드 플릿을 사용하면 작업이 시작되면 워크플로에서 필요한 리소스를 프로비저닝하고 작업이 완료되면 시스템이 폐기됩니다. 온디맨드 플릿의 예:,. Linux.x86-64.Large Linux.x86-64.XLarge 온디맨드 플릿에 대한 자세한 내용은 을 참조하십시오. 온디맨드 플릿 속성

프로비전된 플릿을 사용하면 워크플로 작업을 실행할 전용 컴퓨터 세트를 구성합니다. 이러한 시스템은 유휴 상태로 유지되므로 작업을 즉시 처리할 수 있습니다. 프로비전된 플릿에 대한 자세한 내용은 을 참조하십시오. 프로비저닝된 플릿 속성

생략된 경우 기본값은 Fleet 입니다. Linux.x86-64.Large

해당 UI: 구성 탭/ 컴퓨팅 플릿

Timeout

(ECSRenderTaskDefinition/Timeout)

(선택 사항)

작업이 CodeCatalyst 종료되기 전에 작업을 실행할 수 있는 시간을 분 (편집기) 또는 시간과 분 (비주얼 편집기) 단위로 지정합니다. YAML 최소값은 5분이고 최대값은 에 설명되어 의 워크플로 할당량 CodeCatalyst 있습니다. 기본 타임아웃은 최대 타임아웃과 동일합니다.

해당 UI: 구성 탭/ 타임아웃 - 선택 사항

Inputs

(ECSRenderTaskDefinition/Inputs)

(선택 사항)

이 Inputs 섹션에서는 워크플로우 실행 중에 ECSRenderTaskDefinition 필요한 데이터를 정의합니다.

참고

Render Amazon ECS 작업 정의 작업당 하나의 입력 (소스 또는 아티팩트) 만 허용됩니다. 변수는 이 총계에 포함되지 않습니다.

해당 UI: 입력 탭

Sources

(ECSRenderTaskDefinition/Inputs/Sources)

(작업 정의 파일이 소스 리포지토리에 저장되어 있는 경우 필수)

작업 정의 파일이 소스 리포지토리에 저장되어 있는 경우 해당 소스 리포지토리의 레이블을 지정하세요. 현재 지원되는 레이블은 뿐입니다WorkflowSource.

작업 정의 파일이 소스 리포지토리에 포함되어 있지 않은 경우 이 파일은 다른 작업에서 생성된 아티팩트에 있어야 합니다.

소스에 대한 자세한 내용은 소스 리포지토리를 워크플로에 연결 단원을 참조하십시오.

해당 UI: 입력 탭/ 소스 - 선택 사항

Artifacts - input

(ECSRenderTaskDefinition/Inputs/Artifacts)

(작업 정의 파일이 이전 작업의 출력 아티팩트에 저장되어 있는 경우 필수)

배포하려는 작업 정의 파일이 이전 작업에서 생성된 아티팩트에 포함되어 있는 경우 여기에 해당 아티팩트를 지정하세요. 작업 정의 파일이 아티팩트에 포함되어 있지 않은 경우 해당 파일은 소스 리포지토리에 있어야 합니다.

예제를 포함한 아티팩트에 대한 자세한 내용은 을 참조하십시오. 작업 간 아티팩트 및 파일 공유

해당 UI: 구성 탭/ 아티팩트 - 선택 사항

Variables - input

(ECSRenderTaskDefinition/Inputs/Variables)

(필수)

작업에 사용할 수 있도록 하려는 입력 변수를 정의하는 이름/값 쌍의 시퀀스를 지정합니다. 변수 이름은 영숫자 (a-z, A-Z, 0-9), 하이픈 (-), 밑줄 (_) 로 제한됩니다. 공백은 허용되지 않습니다. 변수 이름에 특수 문자와 공백을 사용할 때는 따옴표를 사용할 수 없습니다.

예제를 비롯한 변수에 대한 자세한 내용은 을 참조하십시오워크플로에서 변수 사용.

해당 UI: 입력 탭/ 변수 - 선택 사항

Configuration

(ECSRenderTaskDefinition/Configuration)

(필수)

작업의 구성 속성을 정의할 수 있는 섹션입니다.

해당 UI: 구성 탭

task-definition

(ECSRenderTaskDefinition/Configuration/task-definition)

(필수)

기존 작업 정의 파일의 경로를 지정합니다. 파일이 소스 리포지토리에 있는 경우 경로는 소스 리포지토리 루트 폴더를 기준으로 합니다. 파일이 이전 워크플로 작업의 아티팩트에 있는 경우 경로는 아티팩트 루트 폴더를 기준으로 합니다. 작업 정의 파일에 대한 자세한 내용은 Amazon Elastic Container Service 개발자 안내서의 작업 정의를 참조하십시오.

해당 UI: 구성 탭/ 작업 정의

container-definition-name

(ECSRenderTaskDefinition/Configuration/container-definition-name)

(필수)

Docker 이미지가 실행될 컨테이너의 이름을 지정합니다. 이 이름은 작업 정의 파일의containerDefinitions, name 필드에서 찾을 수 있습니다. 자세한 내용은 Amazon Elastic 컨테이너 서비스 개발자 안내서의 이름을 참조하십시오.

해당 UI: 구성 탭/ 컨테이너 이름

image

(ECSRenderTaskDefinition/Configuration/image)

(필수)

Render Amazon ECS 작업 정의 작업에서 작업 정의 파일에 추가하려는 Docker 이미지의 이름을 지정합니다. 액션은 이 이름을 작업 정의 파일의containerDefinitions, image 필드에 추가합니다. image필드에 값이 이미 있는 경우 액션은 해당 값을 덮어씁니다. 이미지 이름에 변수를 포함할 수 있습니다.

예시:

을 MyDockerImage:${WorkflowSource.CommitId} 지정하면 작업이 작업 정의 파일에 MyDockerImage:commit-id 추가됩니다. 여기서 commit-id 워크플로에서 런타임 시 생성되는 커밋 ID입니다.

my-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s)지정하면 액션이 추가됩니다.my-ecr-repo/이미지-레포:date +%m-%d-%y-%H-%m-%s 작업 정의 파일로, 여기서 my-ecr-repo 는 Amazon Elastic 컨테이너 레지스트리 (ECR) 에 URI 속하며 date +%m-%d-%y-%H-%m-%s 워크플로에서 런타임 시 month-day-year-hour-minute-second 생성되는 형식의 타임스탬프입니다.

이 image 필드에 대한 자세한 내용은 Amazon Elastic 컨테이너 서비스 개발자 안내서의 이미지를 참조하십시오. 변수에 대한 자세한 내용은 을 참조하십시오워크플로에서 변수 사용.

해당 UI: 구성 탭/ 이미지 이름

environment-variables

(ECSRenderTaskDefinition/Configuration/environment-variables)

(필수)

Render Amazon ECS 작업 정의 작업에서 작업 정의 파일에 추가하려는 환경 변수를 지정합니다. 이 작업은 작업 정의 파일의containerDefinitions, environment 필드에 변수를 추가합니다. 파일에 변수가 이미 있는 경우 액션은 기존 변수 값을 덮어쓰고 새 변수를 추가합니다. Amazon ECS 환경 변수에 대한 자세한 내용은 Amazon Elastic Container Service 개발자 안내서의 환경 변수 지정을 참조하십시오.

해당 UI: 구성 탭/ 환경 변수 - 선택 사항

Outputs

(ECSRenderTaskDefinition/Outputs)

(필수)

워크플로우 실행 중 작업에 의해 출력되는 데이터를 정의합니다.

해당 UI: 출력 탭

Artifacts

(ECSRenderTaskDefinition/Outputs/Artifacts)

(필수)

액션으로 생성된 아티팩트를 지정합니다. 이러한 아티팩트를 다른 작업의 입력으로 참조할 수 있습니다.

예제를 포함한 아티팩트에 대한 자세한 내용은 을 참조하십시오. 작업 간 아티팩트 및 파일 공유

해당 UI: 출력 탭/ 아티팩트

Name

(ECSRenderTaskDefinition/Outputs/Artifacts/Name)

(필수)

업데이트된 작업 정의 파일을 포함할 아티팩트의 이름을 지정합니다. 기본값은 MyTaskDefinitionArtifact입니다. 그런 다음 이 아티팩트를 Amazon에 배포 ECS 작업에 대한 입력으로 지정해야 합니다. 이 아티팩트를 Amazon에 배포 ECS 작업에 입력으로 추가하는 방법을 이해하려면 을 참조하십시오예: Amazon ECS taskdef 수정.

해당 UI: 출력 탭/아티팩트/이름

Files

(ECSRenderTaskDefinition/Outputs/Artifacts/Files)

(필수)

아티팩트에 포함할 파일을 지정합니다. 로 task-definition- 시작하는 업데이트된 작업 정의 파일이 task-definition-* 포함되도록 지정해야 합니다.

해당 UI: 출력 탭/아티팩트/파일

Variables

(ECSRenderTaskDefinition/Outputs/Variables)

(필수)

렌더링 액션에서 설정할 변수 이름을 지정합니다. 렌더링 액션은 이 변수 값을 업데이트된 작업 정의 파일의 이름 (예:task-definition-random-string.json) 으로 설정합니다. 그런 다음 ECSAmazon으로 배포 작업의 작업 정의 (시각적 편집기) 또는 task-definition (yaml 편집기) 속성에 이 변수를 지정해야 합니다. 이 변수를 Amazon에 배포 ECS 작업에 추가하는 방법을 이해하려면 을 참조하십시오예: Amazon ECS taskdef 수정.

기본값: task-definition

해당 UI: 출력 탭/변수/이름 필드