AWS-ECSRunTask - AWS Systems Manager 자동화 런북 참조

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

AWS-ECSRunTask

설명

AWS-ECSRunTask런북은 사용자가 지정하는 Amazon Elastic Container 서비스 (Amazon ECS) 작업을 실행합니다.

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux

Parameters

  • AutomationAssumeRole

    타입: 문자열

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

  • capacityProviderStrategy

    타입: 문자열

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

  • cluster

    타입: 문자열

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

  • count

    타입: 문자열

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

  • ECS를 활성화합니다. ManagedTags

    타입: 부울

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

  • enableExecuteCommand

    타입: 부울

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

  • 그룹

    타입: 문자열

    설명: (선택 사항) 작업과 연결할 작업 그룹의 이름입니다. 기본값은 작업 정의의 패밀리 이름입니다. 예를 들어 family:my-family-name입니다.

  • 런치 타입

    타입: 문자열

    유효한 값: EC2 | 파게이트 | 외부

    설명: (선택 사항) 독립형 작업을 실행하기 위한 인프라.

  • networkConfiguration

    타입: 문자열

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

  • 보합

    타입: 문자열

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

  • 배치 제약조건

    타입: 문자열

    설명: (선택 사항) 작업에 사용할 배치 제약 오브젝트의 배열입니다. 작업 정의의 제약 조건 및 런타임에 지정된 제약 조건을 포함하여 각 작업에 대해 최대 10개의 제약 조건을 지정할 수 있습니다.

  • 배치 전략

    타입: 문자열

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

  • platformVersion

    타입: 문자열

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

  • propagateTags

    타입: 문자열

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

  • referenceId

    타입: 문자열

    설명: (선택 사항) 작업에 사용할 참조 ID입니다. 참조 ID의 최대 길이는 1024자일 수 있습니다.

  • 시작일:

    타입: 문자열

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

  • tags

    타입: 문자열

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

  • 작업 정의

    타입: 문자열

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

필수 IAM 권한

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

  • ecs:RunTask

문서 단계

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