AWS-ECSRunTask - AWS Systems Manager 자동화 실행서 참조

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

AWS-ECSRunTask

설명

AWS-ECSRunTask 런북은 지정한 Amazon Elastic Container Service(AmazonECS) 작업을 실행합니다.

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux

Parameters

  • AutomationAssumeRole

    유형: 문자열

    설명: (선택 사항) Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 허용하는 (ARN) 역할의 AWS Identity and Access Management Amazon 리소스 이름(IAM)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.

  • capacityProviderStrategy

    유형: 문자열

    설명: (선택 사항) 작업에 사용할 용량 공급자 전략입니다.

  • cluster

    유형: 문자열

    설명: (선택 사항) 작업을 실행할 클러스터ARN의 짧은 이름입니다. 클러스터를 지정하지 않으면 기본 클러스터가 사용됩니다.

  • count

    유형: 문자열

    설명: (선택 사항) 클러스터에 배치할 지정된 작업의 인스턴스 수입니다. 각 요청에 대해 최대 10개의 작업을 지정할 수 있습니다.

  • enableECSManaged태그

    타입: 부울

    설명: (선택 사항) 작업에 Amazon ECS 관리형 태그를 사용할지 여부를 지정합니다. 자세한 내용은 Amazon Elastic Container Service 개발자 안내서의 Amazon ECS 리소스 태그 지정을 참조하세요.

  • enableExecuteCommand

    타입: 부울

    설명: (선택 사항) 이 태스크의 컨테이너에 대해 실행 명령 기능을 활성화할지 여부를 결정합니다. true인 경우 태스크의 모든 컨테이너에서 실행 명령 기능을 활성화합니다.

  • 그룹

    유형: 문자열

    설명: (선택 사항) 태스크와 연결할 태스크 그룹의 이름입니다. 기본값은 작업 정의의 성입니다. 예: family:my-family-name.

  • launchType

    유형: 문자열

    유효한 값: EC2 | FARGATE | EXTERNAL

    설명: (선택 사항) 독립 실행형 작업을 실행할 인프라입니다.

  • networkConfiguration

    유형: 문자열

    설명: (선택 사항) 태스크의 네트워크 구성입니다. 이 파라미터는 awsvpc 네트워크 모드를 사용하여 자체 탄력적 네트워크 인터페이스를 수신하는 작업 정의에 필요하며 다른 네트워크 모드에서는 지원되지 않습니다.

  • 재정의

    유형: 문자열

    설명: (선택 사항) 지정된 작업 정의에서 컨테이너 이름을 지정하는 JSON 형식의 컨테이너 재정의 목록과 수신해야 하는 재정의 목록입니다. 명령 재정의를 사용하여 작업 정의 또는 Docker 이미지에 지정된 컨테이너에 대한 기본 명령을 재정의할 수 있습니다. 컨테이너의 작업 정의 또는 Docker 이미지에 지정된 기존 환경 변수를 재정의할 수도 있습니다. 또한 환경 재정의를 사용하여 새 환경 변수를 추가할 수 있습니다.

  • placementConstraints

    유형: 문자열

    설명: (선택 사항) 작업에 사용할 배치 제약 조건 객체의 배열입니다. 태스크 정의의 제약 조건과 런타임에 지정된 제약 조건을 포함하여 각 태스크에 최대 10개의 제약 조건을 지정할 수 있습니다.

  • placementStrategy

    유형: 문자열

    설명: (선택 사항) 작업에 사용할 배치 전략 객체입니다. 각 작업에 대해 최대 5개의 전략 규칙을 지정할 수 있습니다.

  • platformVersion

    유형: 문자열

    설명: (선택 사항) 태스크가 사용하는 플랫폼 버전입니다. 플랫폼 버전은 Fargate에서 호스팅되는 작업에 대해서만 지정됩니다. 플랫폼 버전을 지정하지 않으면 LATEST 플랫폼 버전이 사용됩니다.

  • propagateTags

    유형: 문자열

    설명: (선택 사항) 태그가 태스크 정의에서 태스크로 전파되는지 여부를 결정합니다. 값을 지정하지 않으면 태그가 전파되지 않습니다. 태그는 태스크 생성 중에만 태스크로 전파될 수 있습니다.

  • referenceId

    유형: 문자열

    설명: (선택 사항) 작업에 사용할 참조 ID입니다. 참조 ID의 최대 길이는 1,024자입니다.

  • startedBy

    유형: 문자열

    설명: (선택 사항) 작업이 시작될 때 지정된 선택적 태그입니다. 이렇게 하면 ListTasks API 작업 결과를 필터링하여 특정 작업에 속하는 태스크를 식별할 수 있습니다. 최대 36개의 문자(대문자 및 소문자), 숫자, 하이픈(-) 및 밑줄(_)이 허용됩니다.

  • tags

    유형: 문자열

    설명: (선택 사항) 태스크를 분류하고 구성하는 데 도움이 되도록 태스크에 적용할 메타데이터입니다. 각 태그는 사용자 정의 키와 값으로 구성됩니다.

  • taskDefinition

    유형: 문자열

    설명: (선택 사항) 실행할 작업 정의ARN의 familyrevision (family:revision) 또는 전체입니다. 개정이 지정되지 않은 경우 최신 ACTIVE 개정이 사용됩니다.

필수 IAM 권한

실행서를 성공적으로 사용하려면 AutomationAssumeRole 파라미터에 다음 작업이 필요합니다.

  • ecs:RunTask

문서 단계

aws:executeScript - 실행서 입력 파라미터에 대해 지정한 값을 기반으로 Amazon ECS 작업을 실행합니다.