Fargate 시작 유형에 대한 Amazon ECS 태스크 정의 파라미터

유형: 문자열

필수 항목 여부: 예

태스크 정의를 등록할 때 패밀리를 지정합니다. 패밀리는 개정 번호를 사용하여 지정된 태스크 정의의 여러 버전에 대한 이름과 비슷합니다. 특정 패밀리에 등록된 첫 번째 태스크 정의에는 개정 번호 1이 부여되고 그 이후 등록된 태스크 정의에는 순차적으로 개정 번호가 부여됩니다.

유형: 문자열 배열

필수 항목 여부: 아니요

유효 값: FARGATE

태스크 정의의 유효성을 검사하기 위한 시작 유형입니다. 이를 통해 작업 정의에 사용되는 모든 파라미터가 시작 유형의 요구 사항을 충족하는지 확인할 수 있습니다.

유형: 문자열

필수 항목 여부: 아니요

태스크 정의를 등록할 때 태스크 권한의 컨테이너가 사용자 대신 연결된 정책에 지정된 AWS API를 호출하도록 허용하는 IAM 역할에 태스크 역할을 제공할 수 있습니다. 자세한 내용은 Amazon ECS 작업 IAM 역할 단원을 참조하십시오.

유형: 문자열

필수 항목 여부: 조건부

Amazon ECS 컨테이너 에이전트에 사용자를 대신하여 AWS API를 호출할 권한을 부여하는 태스크 실행 역할의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

필수 항목 여부: 예

태스크의 컨테이너에 사용할 Docker 네트워킹 모드. Fargate에서 호스팅되는 Amazon ECS 작업의 경우 awsvpc 네트워크 모드가 필요합니다.

네트워크 모드가 none으로 설정된 경우에는 태스크의 컨테이너가 외부 네트워크와 연결되지 않고 컨테이너 정의에서 포트 매핑을 지정할 수 없습니다.

네트워크 모드가 awsvpc인 경우, 해당 태스크에 탄력적 네트워크 인터페이스가 할당되므로 서비스를 생성하거나 태스크 정의로 태스크를 실행하려면 NetworkConfiguration을 지정해야 합니다. 자세한 내용은 Fargate 시작 유형에 대한 Amazon ECS 작업 네트워킹 옵션 단원을 참조하십시오. awsvpc 네트워크 모드는 Amazon EC2 네트워크 스택을 사용하는 컨테이너에 가장 높은 수준의 네트워킹 성능을 제공합니다. 노출된 컨테이너 포트가 연결된 탄력적 네트워크 인터페이스 포트에 직접 매핑됩니다. 이 때문에 동적 호스트 포트 매핑을 사용할 수 없습니다.

awsvpc 네트워크 모드는 Amazon EC2 네트워크 스택을 사용하는 컨테이너에 가장 높은 수준의 네트워킹 성능을 제공합니다. awsvpc 네트워크 모드에서는 노출된 컨테이너 포트가 연결된 탄력적 네트워크 인터페이스 포트에 직접 매핑됩니다.

이 때문에 동적 호스트 포트 매핑을 사용할 수 없습니다.

awsvpc 네트워크 모드는 필수입니다.

유형: 문자열

필수 항목 여부: 조건부

기본값: LINUX

이 파라미터는 Fargate에서 호스팅되는 Amazon ECS 태스크에 필요합니다.

태스크 정의를 등록할 때 운영 체제 제품군을 지정합니다.

유효한 값은 LINUX, WINDOWS_SERVER_2019_FULL, WINDOWS_SERVER_2019_CORE, WINDOWS_SERVER_2022_FULL 및 WINDOWS_SERVER_2022_CORE입니다.

서비스에서 사용되는 모든 태스크 정의는 이 파라미터에 대해 동일한 값을 가져야 합니다.

태스크 정의가 서비스의 일부인 경우 이 값은 서비스 platformFamily 값과 일치해야 합니다.

유형: 문자열

필수 항목 여부: 조건부

기본값: X86_64

이 파라미터를 null로 두면 Fargate에 호스팅된 작업을 시작할 때 기본값이 자동으로 할당됩니다.

태스크 정의를 등록할 때 CPU 아키텍처를 지정합니다. 유효 값은 X86_64 및 ARM64입니다.

서비스에서 사용되는 모든 태스크 정의는 이 파라미터에 대해 동일한 값을 가져야 합니다.

Linux 태스크가 있는 경우 값을 ARM64로 설정할 수 있습니다. 자세한 내용은 64비트 ARM 워크로드에 대한 Amazon ECS 작업 정의 단원을 참조하십시오.

유형: 문자열

필수 항목 여부: 조건부

태스크에 대해 표시되는 CPU 단위의 하드 제한입니다. JSON 파일에서 CPU 값을 문자열(CPU 단위 또는 가상 CPU(vCPU))로 지정할 수 있습니다. 예를 들어 CPU 값을 1024(CPU 단위) 또는 1 vCPU(vCPU)로 지정할 수 있습니다. 태스크 정의를 등록할 때는 vCPU 값이 CPU 단위를 나타내는 정수로 변환됩니다.

이 필드는 필수이며 다음 값 중 하나를 사용해야 합니다. 이 필드에 따라 memory 파라미터에 지원되는 값의 범위가 결정됩니다. 유효한 태스크 레벨 CPU 및 메모리 조합은 아래 표와 같습니다.

유형: 문자열

필수 항목 여부: 조건부

작업에 표시할 메모리의 하드 제한. 작업 정의에서 메모리 값을 문자열(메비바이트(MiB) 또는 기가바이트(GB) 단위)로 지정할 수 있습니다. 예를 들어 메모리 값을 3072(MiB) 또는 3 GB(GB)로 지정할 수 있습니다. 태스크 정의를 등록할 때는 GB 값이 MiB를 나타내는 정수로 변환됩니다.

이 필드는 필수이며 다음 값 중 하나를 사용해야 합니다. 이 필드에 따라 cpu 파라미터에 지원되는 값의 범위가 결정됩니다.

유형: 문자열

필수 항목 여부: 예

컨테이너의 이름. 최대 255개의 문자(대문자 및 소문자), 숫자, 하이픈 및 밑줄이 허용됩니다. 여러 컨테이너를 한 태스크 정의에 연결하는 경우, 한 컨테이너의 name을 다른 컨테이너의 links에 입력할 수 있습니다. 이는 컨테이너를 연결하기 위한 것입니다.

유형: 문자열

필수 항목 여부: 예

컨테이너를 시작하는 데 사용되는 이미지입니다. 이 문자열은 Docker 대몬(daemon)으로 직접 전달됩니다. 기본적으로 Docker Hub 레지스트리 내 이미지는 사용 가능합니다. repository-url/image:tag 또는 repository-url/image@digest를 사용하여 다른 리포지토리를 지정할 수도 있습니다. 최대 255개의 문자(대문자 및 소문자), 숫자, 하이픈, 밑줄, 콜론, 마침표, 슬래시 및 부호가 허용됩니다. 이 파라미터는 Docker 컨테이너 생성 명령에 있는 Image 및 docker run 명령의 IMAGE 파라미터에 매핑됩니다.

유형: 문자열

유효한 값: enabled|disabled

필수 항목 여부: 아니요

컨테이너 정의에 제공된 컨테이너 이미지 태그가 Amazon ECS에서 이미지 다이제스트로 확인되는지 여부를 지정합니다. 기본적으로 이 동작은 enabled입니다. 컨테이너의 값을 disabled로 설정하면 Amazon ECS에서는 컨테이너 이미지 태그가 다이제스트로 확인되지 않고 컨테이너 정의에 지정된 원본 이미지 URI가 배포에 사용됩니다. 컨테이너 이미지 확인에 대한 자세한 내용은 컨테이너 이미지 확인 단원을 참조하세요.

유형: 정수

필수 항목 여부: 아니요

컨테이너에 표시할 메모리의 양(MiB)입니다. 컨테이너가 여기서 지정된 메모리를 초과하려 하면 해당 컨테이너가 중지됩니다. 태스크 내 모든 컨테이너에 대해 예약된 총 메모리 양은 태스크 memory 값(지정된 경우)보다 작아야 합니다. 이 파라미터는 Docker 컨테이너 생성 명령의 Memory 및 docker run에 대한 --memory 옵션에 매핑됩니다.

Docker 20.10.0 이상의 대몬(daemon)은 컨테이너용으로 최소 6MiB의 메모리를 남겨둡니다. 따라서 컨테이너에 6MiB 미만의 메모리를 지정하지 마세요.

Docker 19.03.13-ce 이하의 대몬(daemon)은 컨테이너용으로 최소 4MiB의 메모리를 남겨둡니다. 따라서 컨테이너에 4MiB 미만의 메모리를 지정하지 마세요.

유형: 정수

필수 항목 여부: 아니요

컨테이너용으로 예약할 메모리의 소프트 제한(MiB)입니다. 시스템 메모리가 경합하는 경우 Docker는 컨테이너 메모리를 이 소프트 제한으로 유지하려고 합니다. 하지만 필요한 경우 컨테이너에서 더 많은 메모리를 사용할 수 있습니다. 컨테이너는 memory 파라미터에 지정된 하드 한도까지(해당하는 경우) 또는 컨테이너 인스턴스의 모든 가용 메모리(둘 중 먼저 발생하는 것)를 사용할 수 있습니다. 이 파라미터는 Docker 컨테이너 생성 명령의 MemoryReservation 및 docker run에 대한 --memory-reservation 옵션에 매핑됩니다.

태스크 레벨 메모리 값이 지정되지 않은 경우 컨테이너 정의의 memory 또는 memoryReservation에 대해 하나 또는 둘 다에 0이 아닌 정수를 지정해야 합니다. 둘 모두 지정하는 경우 memory가 memoryReservation보다 커야 합니다. memoryReservation을 지정하는 경우 컨테이너가 배치된 컨테이너 인스턴스의 가용 메모리 리소스에서 해당 값이 차감됩니다. 그렇지 않으면 memory 값이 사용됩니다.

예를 들어 컨테이너가 통상적으로 128MiB의 메모리를 사용하지만 경우에 따라 잠깐 동안 사용량이 256MiB까지 급증한다고 가정합니다. 이 경우 memoryReservation을 128MiB로 설정하고 memory 하드 제한을 300MiB로 설정할 수 있습니다. 이 구성은 컨테이너가 컨테이너 인스턴스의 잔여 리소스 중 128MiB의 메모리만 예약하도록 허용합니다. 동시에, 이 구성을 사용하여 필요할 때 컨테이너가 더 많은 메모리 리소스를 사용하도록 허용할 수도 있습니다.

Docker 20.10.0 이상의 대몬(daemon)은 컨테이너용으로 최소 6MiB의 메모리를 남겨둡니다. 따라서 컨테이너에 6MiB 미만의 메모리를 지정하지 마세요.

Docker 19.03.13-ce 이하의 대몬(daemon)은 컨테이너용으로 최소 4MiB의 메모리를 남겨둡니다. 따라서 컨테이너에 4MiB 미만의 메모리를 지정하지 마세요.

유형: 객체 배열

필수 항목 여부: 아니요

포트 매핑은 컨테이너의 네트워크 포트를 외부에 노출시켜 클라이언트가 애플리케이션에 액세스할 수 있도록 합니다. 이 파라미터는 동일한 태스크 내에서 컨테이너 간 통신에도 사용됩니다.

awsvpc 네트워크 모드를 사용하는 태스크 정의의 경우 containerPort만 지정합니다. hostPort는 항상 무시되며 컨테이너 포트는 호스트에서 임의의 높은 번호의 포트에 자동으로 매핑됩니다.

Windows에서의 포트 매핑은 localhost가 아니라 NetNAT 게이트웨이 주소를 사용합니다. Windows에서의 포트 매핑에는 루프백이 없으므로 호스트 자체에서 컨테이너의 매핑된 포트에 액세스할 수 없습니다.

이 파라미터의 필드 대부분(containerPort, hostPort, protocol 포함)은 Docker 컨테이너 생성 명령에 있는 PortBindings와 docker run에 대한 --publish 옵션에 매핑됩니다. 태스크 정의의 네트워크 모드가 host로 설정되어 있으면 호스트 포트가 정의되지 않은 상태이거나 호스트 포트가 포트 매핑의 컨테이너 포트와 일치해야 합니다.

호스트 포트를 지정하는 경우 다음 구문을 사용합니다.

"portMappings": [
    {
        "containerPort": integer,
        "hostPort": integer
    }
    ...
]

호스트 포트가 자동 할당되도록 하려면 다음 구문을 사용합니다.

"portMappings": [
    {
        "containerPort": integer
    }
    ...
]

유형: RepositoryCredentials 객체

필수 항목 여부: 아니요

프라이빗 레지스트리 인증을 위한 리포지토리 보안 인증입니다.

자세한 내용은 Amazon ECS에서 AWS 컨테이너가 아닌 이미지 사용 단원을 참조하십시오.

컨테이너 재시작 정책 및 관련 구성 파라미터. 컨테이너의 재시작 정책을 설정하면 작업을 교체할 필요 없이 Amazon ECS에서 컨테이너를 다시 시작할 수 있습니다. 자세한 내용은 컨테이너 재시작 정책이 있는 Amazon ECS 작업의 개별 컨테이너 재시작 단원을 참조하십시오.

해당 컨테이너에 대한 컨테이너 상태 확인 명령 및 연결된 구성 파라미터. 자세한 내용은 컨테이너 상태 확인을 사용하여 Amazon ECS 작업 상태 확인 단원을 참조하십시오.

유형: 정수

필수 항목 여부: 아니요

Amazon ECS 컨테이너 에이전트가 컨테이너에 대해 예약하는 cpu 단위입니다. Linux에서 이 파라미터는 컨테이너 만들기 섹션의 CpuShares에 매핑됩니다.

이 필드는 Fargate 시작 유형을 사용하는 태스크의 경우 선택 사항입니다. 태스크 내 모든 컨테이너에 대해 예약된 총 CPU 양은 태스크 수준 cpu 값보다 작아야 합니다.

Linux 컨테이너는 할당된 양과 동일한 비율로, 컨테이너 인스턴스의 다른 컨테이너와 할당되지 않은 CPU 단위를 공유합니다. 예를 들어 싱글 코어 인스턴스 유형에서 단일 컨테이너 작업을 컨테이너에 512개 CPU 단위를 지정하고 실행한다고 가정해 보겠습니다. 또한 이 작업은 컨테이너 인스턴스에서 실행되는 유일한 작업입니다. 이 예에서 컨테이너는 언제라도 1,024 CPU 단위 전부를 사용할 수 있습니다. 하지만, 해당 컨테이너 인스턴스에서 동일한 태스크의 다른 사본을 시작했다고 가정합니다. 각 작업에는 필요한 경우 최소 512개의 CPU 단위가 보장됩니다. 마찬가지로 다른 컨테이너가 나머지 CPU를 사용하지 않을 경우 각 컨테이너의 CPU 사용량이 높아질 수 있습니다. 하지만 두 작업이 항상 100% 활성 상태인 경우 CPU 단위는 512개로 제한됩니다.

Linux 컨테이너 인스턴스에서, 컨테이너 인스턴스의 Docker 대몬(daemon)은 CPU 값을 사용하여 실행 컨테이너의 상대적인 CPU 공유 비율을 계산합니다. Linux 커널이 허용하는 최소 유효 CPU 공유 값은 2이고, Linux 커널이 허용하는 최대 유효 CPU 공유 값은 262144입니다. 하지만 CPU 파라미터는 필수 항목이 아니며 컨테이너 정의에서 2 미만이나 262144를 초과하는 CPU 값을 사용할 수 있습니다. CPU 값이 2 미만(null 포함)이거나 262144를 초과하는 경우 동작은 Amazon ECS 컨테이너 에이전트 버전에 따라 달라집니다.

Windows 컨테이너 인스턴스에서 CPU 할당량은 절대 할당량으로 적용됩니다. Windows 컨테이너는 작업 정의에 정의된 지정된 양의 CPU에만 액세스할 수 있습니다. Null 또는 0의 CPU 값이 Docker에 0으로 전달되고, Windows는 이 값을 1개 CPU의 1%로 해석합니다.

추가 예제는 How Amazon ECS manages CPU and memory resources를 참조하세요.

이 파라미터는 Fargate에서 호스팅되는 컨테이너에 대해서는 지원되지 않습니다.

유형: ResourceRequirement 객체

필수 항목 여부: 아니요

Amazon ECS 컨테이너 에이전트가 컨테이너에 대해 예약하는 실제 GPUs 수입니다. 태스크의 모든 컨테이너에 예약된 GPU 수가 태스크가 실행되는 컨테이너 인스턴스에서 사용할 수 있는 GPU 수를 초과하면 안 됩니다. 자세한 내용은 GPU 워크로드에 대한 Amazon ECS 작업 정의 단원을 참조하십시오.

이 파라미터는 Fargate에서 호스팅되는 컨테이너에 대해서는 지원되지 않습니다.

유형: ResourceRequirement 객체

필수 항목 여부: 아니요

InferenceAccelerator 유형의 경우 value는 태스크 정의에 지정된 InferenceAccelerator의 deviceName과 일치합니다. 자세한 내용은 Elastic Inference 액셀러레이터 이름 단원을 참조하십시오.

유형: 부울

필수 항목 여부: 아니요

컨테이너의 essential 파라미터가 true로 표시되어 있고 해당 컨테이너가 어떤 이유로든 실패 또는 중지하는 경우를 가정해 보겠습니다. 이 경우 작업에 포함된 다른 모든 컨테이너도 중지합니다. 컨테이너의 essential 파라미터가 false로 표시된 경우에는 해당 컨테이너의 실패가 태스크의 나머지 컨테이너에 영향을 주지 않습니다. 이 파라미터가 생략된 경우 컨테이너가 필수로 간주됩니다.

모든 태스크에는 하나 이상의 필수 컨테이너가 있어야 합니다. 여러 컨테이너로 구성된 애플리케이션이 있다고 가정해 보겠습니다. 이 경우, 공통 용도로 사용되는 컨테이너를 구성 요소로 그룹화하고, 다른 구성 요소를 여러 작업 정의로 분리합니다. 자세한 내용은 Amazon ECS에 대한 애플리케이션 설계 단원을 참조하십시오.

"essential": true|false

유형: 문자열 배열

필수 항목 여부: 아니요

컨테이너로 전달되는 진입점입니다.

"entryPoint": ["string", ...]

유형: 문자열 배열

필수 항목 여부: 아니요

컨테이너로 전달되는 명령입니다. 이 파라미터는 컨테이너 생성 명령의 Cmd 및 docker run에 대한 COMMAND 파라미터에 매핑됩니다. 여러 인수가 있는 경우 각 인수는 배열에서 각각 분리된 문자열이어야 합니다.

"command": ["string", ...]

유형: 문자열

필수 항목 여부: 아니요

컨테이너에서 명령을 실행할 태스크 디렉터리입니다. 이 파라미터는 Docker 원격 API(Docker Remote API)의 컨테이너 생성(Create a container) 섹션에 있는 WorkingDir(와)과 docker run에 대한 --workdir 옵션에 매핑됩니다.

"workingDirectory": "string"

Fargate의 Windows 컨테이너에서는 사용할 수 없습니다.

유형: 객체 배열

필수 항목 여부: 아니요

컨테이너로 전달할 환경 변수를 포함하는 파일 목록입니다. 이 파라미터는 docker run 명령에 대한 --env-file 옵션에 매핑됩니다.

최대 10개의 환경 파일을 지정할 수 있습니다. 파일의 확장명은 .env여야 합니다. 환경 파일의 각 줄에는 VARIABLE=VALUE 형식의 환경 변수를 포함합니다. #으로 시작하는 줄은 주석으로 처리되며 무시됩니다.

컨테이너 정의에 지정된 개별 환경 변수가 있는 경우 환경 파일 내에 포함된 변수보다 우선합니다. 동일한 변수를 포함하는 여러 환경 파일이 지정된 경우 위에서 아래로 처리됩니다. 고유한 변수 이름을 사용하는 것이 좋습니다. 자세한 정보는 개별 환경 변수를 Amazon ECS 컨테이너로 전달을 참조하세요.

유형: 객체 배열

필수 항목 여부: 아니요

컨테이너로 전달할 환경 변수입니다. 이 파라미터는 Docker 컨테이너 생성 명령의 Env 및 docker run 명령에 대한 --env 옵션에 매핑됩니다.

"environment" : [
    { "name" : "string", "value" : "string" },
    { "name" : "string", "value" : "string" }
]

유형: 객체 배열

필수 항목 여부: 아니요

컨테이너에 공개할 보안 암호를 나타내는 객체입니다. 자세한 내용은 Amazon ECS 컨테이너로 민감한 데이터 전달 단원을 참조하십시오.

"secrets": [
    {
        "name": "environment_variable_name",
        "valueFrom": "arn:aws:ssm:region:aws_account_id:parameter/parameter_name"
    }
]

Fargate에서 실행되는 태스크에는 이 파라미터가 지원되지 않습니다.

유형: 부울

필수 항목 여부: 아니요

이 파라미터가 true일 경우 컨테이너 내에서 네트워킹이 해제됩니다.

기본값은 false입니다.

"disableNetworking": true|false

이 파라미터는 awsvpc 네트워크 모드를 사용하는 작업에 대해서는 지원되지 않습니다.

유형: 문자열 배열

필수 항목 여부: 아니요

link 파라미터는 포트 매핑 필요 없이 컨테이너가 서로 통신하도록 허용합니다. 이 파라미터는 작업 정의의 네트워크 모드가 bridge로 설정된 경우에만 지원됩니다. name:internalName 구성은 Docker 링크의 name:alias와 유사합니다. 최대 255개의 문자(대문자 및 소문자), 숫자, 하이픈 및 밑줄이 허용됩니다.

"links": ["name:internalName", ...]

유형: 문자열

필수 항목 여부: 아니요

컨테이너에 사용할 호스트 이름입니다. 이 파라미터는 Docker 컨테이너 생성의 Hostname 및 docker run에 대한 --hostname 옵션에 매핑됩니다.

"hostname": "string"

Fargate에서 실행되는 태스크에는 지원되지 않습니다.

유형: 문자열 배열

필수 항목 여부: 아니요

컨테이너에 제공되는 DNS 서버의 목록입니다.

"dnsServers": ["string", ...]

이 파라미터는 awsvpc 네트워크 모드를 사용하는 작업에 대해서는 지원되지 않습니다.

유형: 객체 배열

필수 항목 여부: 아니요

컨테이너의 /etc/hosts 파일에 추가할 호스트 이름 및 IP 주소 매핑의 목록입니다.

이 파라미터는 Docker 컨테이너 생성 명령의 ExtraHosts 및 docker run에 대한 --add-host 옵션에 매핑됩니다.

"extraHosts": [
      {
        "hostname": "string",
        "ipAddress": "string"
      }
      ...
    ]

유형: 부울

필수 항목 여부: 아니요

이 파라미터가 true일 경우 컨테이너에는 루트 파일 시스템에 대한 읽기 전용 액세스가 부여됩니다. 이 파라미터는 Docker 컨테이너 생성 명령의 ReadonlyRootfs 및 docker run에 대한 --read-only 옵션에 매핑됩니다.

기본값은 false입니다.

"readonlyRootFilesystem": true|false

유형: 객체 배열

필수 항목 여부: 아니요

컨테이너에서 데이터 볼륨의 탑재 지점입니다. 이 파라미터는 create-container Docker API의 Volumes 및 docker run에 대한 --volume 옵션에 매핑됩니다.

Windows 컨테이너는 전체 디렉터리를 동일한 드라이브에 $env:ProgramData로 마운트할 수 있습니다. Windows 컨테이너는 디렉터리를 다른 드라이브에 탑재할 수 없으며, 탑재 지점은 여러 드라이브에 걸쳐 사용할 수 없습니다. Amazon EBS 볼륨을 Amazon ECS 작업에 직접 연결하려면 탑재 지점을 지정해야 합니다.

유형: 객체 배열

필수 항목 여부: 아니요

다른 컨테이너로부터 탑재할 데이터 볼륨입니다. 이 파라미터는 Docker 컨테이너 생성 명령의 VolumesFrom 및 docker run에 대한 --volumes-from 옵션에 매핑됩니다.

"volumesFrom": [
                {
                  "sourceContainer": "string",
                  "readOnly": true|false
                }
              ]

유형: LogConfiguration 객체

필수 항목 여부: 아니요

컨테이너의 로그 구성 사양입니다.

로그 구성을 사용하는 태스크 정의에 대한 자세한 정보는 Amazon ECS 작업 정의 예제 섹션을 참조하세요.

이 파라미터는 Docker 컨테이너 생성 명령의 LogConfig 및 docker run에 대한 --log-driver 옵션에 매핑됩니다. 기본적으로 컨테이너는 Docker 대몬(daemon)이 사용하는 것과 동일한 로깅 드라이버를 사용합니다. 하지만 컨테이너는 이 파라미터를 사용하여 컨테이너 정의에 로그 드라이버를 지정함으로써 Docker 대몬(daemon)과 다른 로깅 드라이버를 사용할 수 있습니다. 컨테이너에 다른 로깅 드라이버를 사용하려면 컨테이너 인스턴스에서(또는 원격 로깅 옵션의 다른 로그 서버에서) 로그 시스템이 올바르게 구성되어야 합니다.

컨테이너에 대한 로그 구성을 지정할 때 다음 사항에 유의해야 합니다.

"logConfiguration": {
      "logDriver": "awslogs","fluentd","gelf","json-file","journald","logentries","splunk","syslog","awsfirelens",
      "options": {"string": "string"
        ...},
	"secretOptions": [{
		"name": "string",
		"valueFrom": "string"
	}]
}

유형: FirelensConfiguration 객체

필수 항목 여부: 아니요

컨테이너의 FireLens 구성입니다. 컨테이너 로그에 대한 로그 라우터를 지정하고 구성하는 데 사용됩니다. 자세한 정보는 Amazon ECS 로그를 AWS 서비스 또는 AWS Partner로 전송 섹션을 참조하세요.

{
    "firelensConfiguration": {
        "type": "fluentd",
        "options": {
            "KeyName": ""
        }
    }
}

유형: 문자열 배열

필수 항목 여부: 아니요

Active Directory 인증을 위한 컨테이너를 구성하는 보안 인증 사양(CredSpec) 파일에 대한 SSM 또는 Amazon S3의 ARN 목록입니다. 이 파라미터를 dockerSecurityOptions 대신 사용하는 것이 좋습니다. 최대 ARN 수는 1개입니다.

각 ARN의 형식은 두 가지입니다.

두 형식 모두에서 MyARN을 SSM 또는 Amazon S3의 ARN으로 바꿉니다.

credspec에서는 사용자 이름, 암호 및 연결할 도메인을 포함하는 보안 암호에 대한 Secrets Manager의 ARN을 제공해야 합니다. 보안을 강화하기 위해 도메인 없는 인증의 경우 인스턴스가 도메인에 조인되지 않습니다. 인스턴스의 다른 애플리케이션은 도메인 없는 보안 인증을 사용할 수 없습니다. 작업을 다른 도메인에 조인해야 하는 경우에도 이 파라미터를 사용하여 동일한 인스턴스에서 작업을 실행할 수 있습니다. 자세한 내용은 Using gMSAs for Windows Containers 및 Using gMSAs for Linux Containers를 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

컨테이너 내부에서 사용할 사용자입니다. 이 파라미터는 Docker 컨테이너 생성 명령의 User 및 docker run에 대한 --user 옵션에 매핑됩니다.

다음 형식을 사용하여 user를 지정할 수 있습니다. UID 또는 GID를 지정하는 경우 이를 양의 정수로 지정해야 합니다.

"user": "string"

유형: 객체 배열

필수 항목 여부: 아니요

컨테이너에 정의할 ulimit 값 목록. 이 값은 운영 체제에 설정된 기본 리소스 할당량 설정을 다시 정의합니다. 이 파라미터는 Docker 컨테이너 생성 명령의 Ulimits 및 docker run에 대한 --ulimit 옵션에 매핑됩니다.

Fargate에 호스팅되는 Amazon ECS 작업은 nofile 리소스 제한 파라미터를 제외하고 운영 체제에서 설정한 기본 리소스 제한 값을 사용합니다. nofile 리소스 제한은 컨테이너가 사용할 수 있는 열린 파일 수에 대한 제한을 설정합니다. Fargate에서 기본 nofile 소프트 제한은 65535이고 하드 제한은 65535입니다. 두 제한의 값을 모두 최대 1048576으로 설정할 수 있습니다. 자세한 내용은 태스크 리소스 제한 단원을 참조하십시오.

이 파라미터를 사용하려면 컨테이너 인스턴스에서 Docker 원격 API 버전 1.18 이상을 사용해야 합니다.

"ulimits": [
      {
        "name": "core"|"cpu"|"data"|"fsize"|"locks"|"memlock"|"msgqueue"|"nice"|"nofile"|"nproc"|"rss"|"rtprio"|"rttime"|"sigpending"|"stack",
        "softLimit": integer,
        "hardLimit": integer
      }
      ...
    ]

유형: 문자열 대 문자열 맵

필수 항목 여부: 아니요

컨테이너에 추가할 레이블의 키/값 맵입니다. 이 파라미터는 Docker 컨테이너 생성 명령의 Labels 및 docker run에 대한 --label 옵션에 매핑됩니다.

이 파라미터를 사용하려면 컨테이너 인스턴스에서 Docker 원격 API 버전 1.18 이상을 사용해야 합니다.

"dockerLabels": {"string": "string"
      ...}

유형: LinuxParameters 객체

필수 항목 여부: 아니요

컨테이너에 적용되는 Linux 관련 옵션(예: KernelCapabilities)

"linuxParameters": {
      "capabilities": {
        "add": ["string", ...],
        "drop": ["string", ...]
        }
      }

유형: ContainerDependency 객체의 배열

필수 항목 여부: 아니요

컨테이너 시작 및 종료에 대해 정의된 종속성입니다. 컨테이너는 여러 종속성을 포함할 수 있습니다. 컨테이너가 시작될 때 종속성이 정의되면 컨테이너를 종료할 때 종속성이 취소됩니다. 문제 해결 예는 컨테이너 종속성 섹션을 참조하세요.

이 파라미터를 사용하려면 태스크 또는 서비스에서 플랫폼 버전 1.3.0 이상(Linux) 또는 1.0.0(Windows)을 사용해야 합니다.

"dependsOn": [
    {
        "containerName": "string",
        "condition": "string"
    }
]

유형: 정수

필수 항목 여부: 아니요

예제 값: 120

컨테이너에 대한 종속성 해결을 포기하기 전에 대기할 시간(초)입니다.

예를 들어 containerA에 대한 태스크 정의에서 containerB에 대한 종속성이 COMPLETE, SUCCESS 또는 HEALTHY 상태인 두 개의 컨테이너를 지정합니다. containerB에 대해 startTimeout 값이 지정되고 그 시간 내에 원하는 상태에 도달하지 않으면 containerA는 시작하지 않습니다.

이 파라미터를 사용하려면 태스크 또는 서비스에서 플랫폼 버전 1.3.0 이상(Linux)을 사용해야 합니다. 최대값은 120초입니다.

유형: 정수

필수 항목 여부: 아니요

예제 값: 120

자체적으로 정상적으로 종료하지 않을 경우 컨테이너를 강제 종료하기까지 대기할 시간(초)입니다.

이 파라미터를 사용하려면 태스크 또는 서비스에서 플랫폼 버전 1.3.0 이상(Linux)을 사용해야 합니다. 파라미터를 지정하지 않으면 기본값인 30초가 사용됩니다. 최대값은 120초입니다.

유형: SystemControl 객체

필수 항목 여부: 아니요

컨테이너에서 설정할 네임스페이스 커널 파라미터의 목록입니다. 이 파라미터는 Docker 컨테이너 생성 명령에 있는 Sysctls 및 docker run에 대한 --sysctl 옵션에 매핑됩니다. 예를 들어 net.ipv4.tcp_keepalive_time 설정을 구성하여 연결을 더 오래 유지할 수 있습니다.

awsvpc 또는 host 네트워크 모드도 사용하는 단일 작업에서 여러 컨테이너에 네트워크 관련 systemControls 파라미터를 지정하지 않는 것이 좋습니다. 이렇게 하면 다음과 같은 단점이 있습니다.

태스크 내 컨테이너에 사용할 IPC 리소스 네임스페이스를 설정하는 경우, 시스템 제어에 다음 사항이 적용됩니다. 자세한 정보는 IPC 모드을 참조하세요.

"systemControls": [
    {
         "namespace":"string",
         "value":"string"
    }
]

유형: 부울

필수 항목 여부: 아니요

이 파라미터가 true일 경우 이것을 사용하여 stdin 또는 tty를 할당해야 하는 컨테이너화된 애플리케이션을 배포할 수 있습니다. 이 파라미터는 Docker 컨테이너 생성 명령의 OpenStdin 및 docker run에 대한 --interactive 옵션에 매핑됩니다.

기본값은 false입니다.

유형: 부울

필수 항목 여부: 아니요

이 파라미터가 true일 경우 TTY가 할당됩니다. 이 파라미터는 Docker 컨테이너 생성 명령의 Tty 및 docker run에 대한 --tty 옵션에 매핑됩니다.

기본값은 false입니다.

유형: 문자열

필수 항목 여부: 예

Amazon Elastic Inference 액셀러레이터 디바이스 이름입니다. deviceName은 컨테이너 정의에서도 참조해야 합니다. Elastic Inference accelerator를 참조하세요.

유형: 문자열

필수 항목 여부: 예

사용할 Elastic Inference 액셀러레이터입니다.

유형: ProxyConfiguration 객체

필수 항목 여부: 아니요

App Mesh 프록시에 대한 구성 세부 정보입니다.

"proxyConfiguration": {
    "type": "APPMESH",
    "containerName": "string",
    "properties": [
        {
           "name": "string",
           "value": "string"
        }
    ]
}

유형: 문자열

필수 항목 여부: 아니요

볼륨의 이름입니다. 최대 255자의 문자(대문자 및 소문자), 숫자, 하이(-) 및 밑줄(_)이 허용됩니다. 이 이름은 컨테이너 정의 mountPoints 객체의 sourceVolume 파라미터에서 참조됩니다.

필수 항목 여부: 아니요

host 파라미터는 바인드 탑재의 수명 주기를 태스크가 아니라 호스트 Amazon EC2 인스턴스와 연결하는 데 사용합니다. host 파라미터가 비어 있으면 Docker 대몬이 데이터 볼륨의 호스트 경로를 할당하지만 해당 볼륨과 연결된 컨테이너가 실행을 중지한 후 데이터 유지가 보장되지 않습니다.

Windows 컨테이너는 전체 디렉터리를 동일한 드라이브에 $env:ProgramData로 마운트할 수 있습니다.

유형: 부울

필수 항목 여부: 아니요

시작 시 볼륨을 구성할 수 있는지 여부를 지정합니다. true로 설정하면 독립 실행형 작업을 실행하거나 서비스를 생성 또는 업데이트할 때 볼륨을 구성할 수 있습니다. true로 설정하면 작업 정의에서 다른 볼륨 구성을 제공할 수 없습니다. 작업에 연결하도록 Amazon EBS 볼륨을 구성하려면 이 파라미터를 true로 설정해야 합니다. configuredAtLaunch를 true로 설정하고 볼륨 구성을 시작 단계로 연기하면 볼륨 유형이나 특정 볼륨 설정으로 제한되지 않는 작업 정의를 생성할 수 있습니다. 그러면 여러 실행 환경에서 작업 정의를 재사용할 수 있습니다. 자세한 내용은 Amazon EBS volumes를 참조하세요.

유형: DockerVolumeConfiguration 객체

필수 항목 여부: 아니요

이 파라미터는 Docker 볼륨을 사용할 때 지정됩니다. Docker 볼륨은 EC2 인스턴스에서 작업을 실행하는 경우에만 지원됩니다. Windows 컨테이너는 local 드라이버의 사용만 지원합니다. 바인드 탑재를 사용하려면 대신에 host를 지정하세요.

유형: EFSVolumeConfiguration 객체

필수 항목 여부: 아니요

이 파라미터는 Amazon EFS 볼륨을 사용할 때 지정됩니다.

유형: FSxWindowsFileServerVolumeConfiguration 객체

필수 여부: 예

이 파라미터는 작업을 저장할 Amazon FSx for Windows File Server 파일 시스템을 사용할 때 지정됩니다.

유형: 문자열

필수 항목 여부: 아니요

하나의 태그를 구성하는 키-값 쌍의 일부분입니다. 키는 더 구체적인 태그 값에 대해 범주와 같은 역할을 하는 일반적인 레이블입니다.

유형: 문자열

필수 항목 여부: 아니요

하나의 태그를 구성하는 키-값 쌍의 선택적 부분입니다. 하나의 값은 태그 범주(키) 내에서 서술자 역할을 수행합니다.

유형: EphemeralStorage 객체

필수 항목 여부: 아니요

태스크에 할당되는 임시 스토리지 용량(GB)입니다. 이 파라미터는 AWS Fargate에서 호스팅되는 태스크에 대해 제공되는 임시 스토리지 총량을 기본 용량 이상으로 확장할 때 사용합니다. 자세한 내용은 Amazon ECS에서 바인드 탑재 사용 단원을 참조하십시오.

Fargate에서 실행되는 태스크에는 지원되지 않습니다.

유형: 문자열

필수 항목 여부: 아니요

해당 태스크의 컨테이너에 사용할 IPC 리소스 네임스페이스입니다. 유효한 값은 host, task 또는 none입니다. host를 지정하면 동일한 컨테이너 인스턴스에서 host IPC 모드를 지정한 태스크 내 모든 컨테이너가 동일한 IPC 리소스를 호스트 Amazon EC2 인스턴스와 공유합니다. task를 지정하면 지정된 태스크 내 모든 컨테이너가 동일한 IPC 리소스를 공유합니다. none이 지정된 경우, 태스크 컨테이너 내에 있는 IPC 리소스는 프라이빗이며, 태스크 또는 컨테이너 인스턴스의 다른 컨테이너와 공유되지 않습니다. 값을 지정하지 않을 경우, IPC 리소스 네임스페이스 공유는 컨테이너 인스턴스의 Docker 데몬 설정에 따라 달라집니다.

host IPC 모드를 사용하는 경우, 원치 않는 IPC 네임스페이스 노출이 발생할 위험이 커집니다.

해당 태스크 내 컨테이너에 대해 systemControls를 사용하여 네임스페이스가 있는 커널 파라미터를 설정하는 경우, IPC 리소스 네임스페이스에 다음 사항이 적용됩니다.

유형: 문자열

유효한 값: host | task

필수 항목 여부: 아니요

해당 태스크의 컨테이너에 사용할 프로세스 네임스페이스입니다. 유효한 값은 host 또는 task입니다. Linux 컨테이너에서 유효한 값은 task뿐입니다. 예를 들어 사이드카 모니터링에서는 동일한 작업에서 실행 중인 다른 컨테이너에 대한 정보에 액세스하기 위해 pidMode가 필요할 수 있습니다.

task을 지정하면 지정된 태스크 내 모든 컨테이너가 동일한 프로세스 네임스페이스를 공유합니다.

값을 지정하지 않을 경우, 기본값은 각 컨테이너의 프라이빗 네임스페이스입니다.

유형: 부울

유효한 값: true | false

필수 항목 여부: 아니요

이 파라미터가 true로 설정된 경우 작업의 페이로드에서 Amazon ECS와 Fargate는 작업 컨테이너의 결함 주입 요청을 수락합니다. 이 파라미터는 기본적으로 false로 설정되어 있습니다.