컴퓨팅 환경 파라미터

컴퓨팅 환경은 컴퓨팅 환경의 이름, 유형 및 상태, 컴퓨팅 리소스 정의 (관리형 컴퓨팅 환경인 경우), Amazon EKS 구성 (Amazon EKS 리소스를 사용하는 경우), IAM 권한을 제공하는 데 사용할 서비스 역할, 컴퓨팅 환경의 태그 AWS Batch등 몇 가지 기본 구성 요소로 구분됩니다.

컴퓨팅 환경 이름

computeEnvironmentName

컴퓨팅 환경의 이름입니다. 각 이름의 최대 길이는 128자입니다. 대문자 및 소문자, 숫자, 하이픈(-) 및 밑줄(_)을 포함할 수 있습니다.

타입: 문자열

필수 항목 여부: 예

유형

type

컴퓨팅 환경의 유형입니다. 정의한 EC2 또는 Fargate 컴퓨팅 리소스를 MANAGED AWS Batch 관리하도록 선택하십시오. 자세한 정보는 컴퓨팅 리소스을 참조하세요. 사용자 자신의 EC2 컴퓨팅 리소스를 관리하려면 UNMANAGED를 선택합니다.

타입: 문자열

유효한 값: MANAGED | UNMANAGED

필수 여부: 예

State

state

컴퓨팅 환경의 상태입니다.

상태가 다음과 ENABLED 같으면 AWS Batch 스케줄러가 환경 내에 작업을 배치하려고 시도합니다. 이러한 작업은 컴퓨팅 리소스의 관련 작업 대기열에 있습니다. 컴퓨팅 환경이 관리형이면 작업 대기열에 따라 인스턴스 스케일 아웃 또는 자동 확장이 필요합니다.

상태가 다음과 DISABLED 같으면 AWS Batch 스케줄러는 환경 내에 작업을 배치하려고 하지 않습니다. STARTING 또는 RUNNING 상태의 작업은 정상적으로 계속 진행됩니다. DISABLED 상태의 관리형 컴퓨팅 환경은 스케일 아웃 되지 않습니다.

참고

특정 DISABLED 상태 컴퓨팅 환경에서는 계속해서 청구 요금이 부과될 수 있습니다. 추가 요금이 부과되지 않도록 하려면 컴퓨팅 환경을 끄고 삭제하세요. 자세한 DeleteComputeEnvironment내용은 AWS Batch API 참조 및 AWS Billing 사용 설명서의 예상치 못한 요금 방지를 참조하십시오.

인스턴스가 유휴 상태인 경우 인스턴스는 minvCpus 값만큼 스케일 다운됩니다. 하지만 인스턴스 크기는 변경되지 않습니다. minvCpus 값이 4이고 desiredvCpus 값이 36인 c5.8xlarge 인스턴스를 예로 들어 보겠습니다. 이 인스턴스는 c5.large 인스턴스로 축소되지 않습니다.

타입: 문자열

유효한 값: ENABLED | DISABLED

필수 여부: 아니요

컴퓨팅 리소스

computeResources

컴퓨팅 환경에서 관리하는 컴퓨팅 리소스에 대한 세부 정보입니다. 자세한 정보는 컴퓨팅 환경을 참조하세요.

유형: ComputeResource 객체

필수: 이 파라미터는 관리형 컴퓨팅 환경에 반드시 필요합니다.

type

컴퓨팅 환경의 유형입니다. 관리형 컴퓨팅 환경에서 EC2 온디맨드 인스턴스(EC2) 및 EC2 스팟 인스턴스(SPOT)의 사용 혹은 Fargate 용량(FARGATE)과 Fargate 스팟 용량(FARGATE_SPOT) 사용 중에서 선택할 수 있습니다. SPOT을 선택할 경우 spotIamFleetRole 파라미터를 사용하여 Amazon EC2 스팟 집합 역할도 지정해야 합니다. 자세한 정보는 Amazon EC2 스팟 플릿 역할을 참조하세요.

유효한 값: EC2 | SPOT | FARGATE | FARGATE_SPOT

필수 여부: 예

allocationStrategy

가장 적합한 인스턴스 유형의 EC2 인스턴스가 충분하지 않을 경우 컴퓨팅 리소스에 사용할 할당 전략. 이는 AWS 리전 또는 Amazon EC2 서비스 한도에 있는 인스턴스 유형의 가용성 때문일 수 있습니다. 자세한 정보는 할당 전략을 참조하세요.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

BEST_FIT(기본값)

AWS Batch 가장 비용이 저렴한 인스턴스 유형을 선호하면서 작업 요구 사항에 가장 적합한 인스턴스 유형을 선택합니다. 선택한 인스턴스 유형의 추가 인스턴스를 사용할 수 없는 경우 추가 인스턴스를 사용할 수 있을 AWS Batch 때까지 기다립니다. 사용 가능한 인스턴스가 충분하지 않거나 사용자가 Amazon EC2 서비스 제한에 다다른 경우, 현재 실행 중인 작업이 완료될 때까지 추가 작업이 실행되지 않습니다. 이 할당 전략은 비용은 낮게 유지하지만 확장을 제한할 수 있습니다. BEST_FIT에 스팟 플릿을 사용하는 경우 스팟 플릿 IAM 역할이 반드시 지정되어야 합니다. BEST_FIT 할당 전략을 사용하는 컴퓨팅 리소스는 인프라 업데이트를 지원하지 않으며 일부 파라미터를 업데이트할 수 없습니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

참고

Amazon EKS 리소스를 사용하는 컴퓨팅 환경에는 BEST_FIT가 지원되지 않습니다.

BEST_FIT_PROGRESSIVE

대기열에 있는 작업이 요구 사항을 충족하기에 충분한 크기의 추가 인스턴스 유형을 사용하십시오. 각 유닛 vCPU에 대해 비용이 저렴한 인스턴스 유형을 우선적으로 사용하십시오. 이전에 선택한 인스턴스 유형의 추가 인스턴스를 사용할 수 없는 경우 새 인스턴스 유형을 AWS Batch 선택합니다.

SPOT_CAPACITY_OPTIMIZED

(스팟 인스턴스 컴퓨팅 리소스에만 사용 가능) 대기열에 있는 작업이 요구 사항을 충족하기에 충분한 크기의 추가 인스턴스 유형을 사용하십시오. 중단될 가능성이 적은 인스턴스 유형을 우선적으로 사용하십시오.

SPOT_PRICE_CAPACITY_OPTIMIZED

(스팟 인스턴스 컴퓨팅 환경에만 적용 가능) 가격 및 용량 최적화 할당 전략은 가격과 용량을 모두 고려하여 중단될 가능성이 가장 낮으면서 가장 저렴한 스팟 인스턴스 풀을 선택합니다.

참고

대부분의 인스턴스에서 SPOT_CAPACITY_OPTIMIZED보다 SPOT_PRICE_CAPACITY_OPTIMIZED을 사용하는 것을 권장합니다.

용량 요구 사항을 maxvCpus 충족하려면 온디맨드 또는 스팟 인스턴스를 사용하는, AWS Batch 및 BEST_FIT 전략과 BEST_FIT_PROGRESSIVE 스팟 인스턴스를 사용하는 SPOT_PRICE_CAPACITY_OPTIMIZED 전략을 초과해야 할 수 있습니다. SPOT_CAPACITY_OPTIMIZED 이 경우 단일 인스턴스를 AWS Batch 초과해서는 안 maxvCpus 됩니다.

유효한 값: BEST_FIT | BEST_FIT_PROGRESSIVE | SPOT_CAPACITY_OPTIMIZED | SPOT_PRICE_CAPACITY_OPTIMIZED

필수 여부: 아니요

minvCpus

컴퓨팅 환경이 DISABLED인 경우에도 환경이 유지해야 할 최소 vCPU 수.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

유형: 정수

필수 항목 여부: 아니요

maxvCpus

AWS Batch 컴퓨팅 환경에서 지원할 수 있는 최대 vCPU 수입니다.

참고

용량 요구 사항을 maxvCpus 충족하려면 온디맨드 또는 스팟 인스턴스를 사용한 사용, SPOT_PRICE_CAPACITY_OPTIMIZED AWS Batch 할당 BEST_FIT 전략과 스팟 인스턴스를 사용한 전략을 초과해야 할 수 있습니다. BEST_FIT_PROGRESSIVE SPOT_CAPACITY_OPTIMIZED 이 경우 단일 인스턴스를 AWS Batch 초과해서는 안 maxvCpus 됩니다. 예를 들어, AWS Batch 는 컴퓨팅 환경에 지정된 인스턴스 중에서 단 하나의 인스턴스만 사용합니다.

유형: 정수

필수 항목 여부: 아니요

desiredvCpus

컴퓨팅 환경에서 원하는 vCPU 수 AWS Batch 작업 대기열 수요에 따라 이 값을 최소값과 최대값 사이에서 수정합니다.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

유형: 정수

필수 항목 여부: 아니요

instanceTypes

시작할 수 있는 인스턴스 유형. 이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다. 지정하지 마세요. 사용자는 특정 인스턴스 패밀리 (예: c5, c5n, 혹은 p3) 내에서 모든 인스턴스 유형을 시작하기 위해 인스턴스 패밀리를 지정할 수 있습니다. 또는 제품군 내에서 특정 크기(예: c5.8xlarge)를 지정할 수 있습니다. 메탈 인스턴스 유형은 인스턴스 패밀리에 속해 있지 않습니다 (예: c5에 c5.metal이 포함되어 있지 않음) 또한 optimal을 선택하여 그때그때 작업 대기열의 요구에 맞는 인스턴스 유형(C4, M4, R4 인스턴스 패밀리 중)을 선택할 수도 있습니다.

참고

컴퓨팅 환경을 생성할 때 컴퓨팅 환경에 대해 선택한 인스턴스 유형은 동일한 아키텍처를 공유해야 합니다. 예를 들어, 동일한 컴퓨팅 환경에서 x86 및 ARM 인스턴스를 함께 사용할 수 없습니다.

참고

현재 optimal에서는 C4, M4 및 R4 인스턴스 패밀리의 인스턴스 유형을 사용합니다. 이러한 인스턴스 패밀리의 인스턴스 유형이 없는 AWS 리전 에서는 C5, M5 및 R5 인스턴스 패밀리의 인스턴스 유형이 사용됩니다.

유형: 문자열 어레이

필수 항목 여부: 예

imageId

이 파라미터는 이제 사용되지 않습니다.

컴퓨팅 환경에서 시작된 인스턴스에 사용되는 Amazon 머신 이미지(AMI) ID입니다. 이 파라미터는 Ec2Configuration 구조의 imageIdOverride 멤버에 의해 재정의됩니다.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

참고

컴퓨팅 환경에 대해 선택한 AMI는 해당 컴퓨팅 환경에 사용자가 사용할 인스턴스 유형의 아키텍처와 일치해야 합니다. 예를 들어, 컴퓨팅 환경에서 A1 인스턴스 유형을 사용하는 경우 선택한 컴퓨팅 리소스 AMI는 반드시 Arm 인스턴스를 지원해야 합니다. Amazon ECS는 아마존 ECS 최적화 아마존 리눅스 2 AMI의 x86과 Arm 버전을 모두 제공합니다. 자세한 내용을 알아보려면 Amazon Elastic Container Service 개발자 안내서의 Amazon ECS 최적화 Amazon Linux 2 AMI를 참조하세요.

타입: 문자열

필수사항: 아니요

subnets

컴퓨팅 리소스를 시작할 VPC 서브넷입니다. 이러한 서브넷은 동일한 VPC에 있어야 합니다. Fargate 컴퓨팅 리소스는 최대 16개의 서브넷을 포함할 수 있습니다. 자세한 내용은 Amazon VPC 사용 설명서의 VPC 및 서브넷을 참조하세요.

참고

AWS Batch Amazon EC2와 AWS Batch Amazon EKS에서는 로컬 영역을 지원합니다. 자세한 내용은 Amazon EC2 사용 설명서의 로컬 영역, Amazon EKS 사용 설명서의 Amazon EKS 및 AWS 로컬 영역, 로컬 영역, Wavength Zone 및 Amazon Elastic 컨테이너 서비스 개발자 안내서의 Amazon ECS 클러스터를 참조하십시오. AWS Outposts

AWS Batch on Fargate는 현재 로컬 영역을 지원하지 않습니다.

컴퓨팅 환경을 업데이트할 때 빈 VPC 서브넷 목록을 제공하면 Fargate와 EC2 컴퓨팅 리소스 간에 결과 동작이 달라집니다. Fargate 컴퓨팅 리소스의 경우 빈 목록을 제공하면 이 파라미터가 지정되지 않은 것처럼 처리되고 아무것도 변경되지 않습니다. EC2 컴퓨팅 리소스의 경우 빈 목록을 제공하면 컴퓨팅 리소스에서 VPC 서브넷이 제거됩니다. VPC 서브넷을 변경하는 경우 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 이는 Fargate와 EC2 컴퓨팅 리소스 모두에 해당됩니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

유형: 문자열 어레이

필수 여부: 예

securityGroupIds

컴퓨팅 환경에서 시작된 인스턴스와 연결된 Amazon EC2 보안 그룹입니다. 하나 이상의 보안 그룹이 securityGroupIds로 또는 launchTemplate에 참조된 시작 템플릿을 사용하여 지정되어야 합니다. 이 파라미터는 Fargate 리소스에서 실행되는 작업에 필요하며 반드시 하나 이상의 보안 그룹을 포함해야 합니다. (Fargate는 시작 템플릿을 지원하지 않습니다.) 보안 그룹이 securityGroupIds 및 launchTemplate을 모두 사용하여 지정될 경우 securityGroupIds 값이 사용됩니다.

컴퓨팅 환경을 업데이트할 때 빈 보안 그룹 목록을 제공하면 Fargate와 EC2 컴퓨팅 리소스 간에 결과 동작이 달라집니다. Fargate 컴퓨팅 리소스의 경우 빈 목록을 제공하면 이 파라미터가 지정되지 않은 것처럼 처리되고 아무 것도 변경되지 않습니다. EC2 컴퓨팅 리소스의 경우 빈 목록을 제공하면 컴퓨팅 리소스에서 보안 그룹이 제거됩니다. 보안 그룹을 변경하는 경우 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 이는 Fargate와 EC2 컴퓨팅 리소스 모두에 해당됩니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

유형: 문자열 어레이

필수 여부: 예

ec2KeyPair

컴퓨팅 환경에서 시작된 인스턴스에 사용되는 EC2 키 페어. 이 키 페어를 사용하여 SSH를 통해 인스턴스에 로그인할 수 있습니다. 컴퓨팅 환경을 업데이트할 때 EC2 키 페어를 변경하면 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

타입: 문자열

필수사항: 아니요

instanceRole

컴퓨팅 환경의 Amazon ECS 인스턴스에 연결할 Amazon EC2 인스턴스 프로파일. 이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다. 지정하지 마세요. 인스턴스 프로파일의 짧은 이름이나 전체 Amazon 리소스 이름(ARN)을 지정할 수 있습니다. 예: ecsInstanceRole또는 arn:aws:iam::aws_account_id:instance-profile/ecsInstanceRole. 자세한 정보는 Amazon ECS 인스턴스 역할을 참조하세요.

컴퓨팅 환경을 업데이트할 때 이 설정을 변경하면 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

타입: 문자열

필수사항: 아니요

tags

컴퓨팅 환경에서 시작된 EC2 인스턴스에 적용될 키-값 페어 태그. 예를 들어 "Name": "AWS Batch Instance - C4OnDemand"를 태그로 지정하여 해당 컴퓨팅 환경의 각 인스턴스가 이 이름을 갖도록 할 수 있습니다. 이는 Amazon EC2 콘솔에서 AWS Batch 인스턴스를 인식하는 데 유용합니다. AWS BatchListTagsForResourceAPI 작업을 사용할 때는 이러한 태그가 보이지 않습니다.

컴퓨팅 환경을 업데이트할 때 EC2 태그를 변경하면 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

유형: 문자열 간 맵

필수 여부: 아니요

placementGroup

컴퓨팅 리소스에 연결할 Amazon EC2 배치 그룹입니다. 이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다. 지정하지 마세요. 다중 노드 병렬 작업을 컴퓨팅 환경에 제출하려면 클러스터 배치 그룹 생성을 고려하고 이 그룹을 사용자 컴퓨팅 리소스와 연결해야 합니다. 이렇게 하면 높은 네트워크 흐름 잠재력으로 단일 가용 영역 내에 있는 인스턴스를 논리적으로 그룹화할 때 다중 노드 병렬 작업이 그대로 유지됩니다. 자세한 내용은 Amazon EC2 Linux 인스턴스 사용 설명서의 배치 그룹을 참조하세요.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

타입: 문자열

필수사항: 아니요

bidPercentage

인스턴스를 시작하기 전에 해당 인스턴스 유형에 대한 온디맨드 가격과 비교하여 EC2 스팟 인스턴스 가격에 대해 설정할 수 있는 최대 비율(%). 예를 들어, 최대 비율이 20%인 경우 스팟 가격은 현행 EC2 인스턴스의 디맨드 가격 보다 20% 적어야 합니다. 항상 최저 (시장) 가격을 지불하고 최대 비율을 넘지 않도록 할 수 있습니다. 이 필드를 비워두면 기본값은 온디맨드 가격의 100%입니다. 대부분의 사용 사례에서는 이 필드를 비워 두는 것이 좋습니다.

컴퓨팅 환경을 업데이트할 때 입찰 비율을 변경하면 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

필수 여부: 아니요

spotIamFleetRole

SPOT 컴퓨팅 환경에 적용되는 Amazon EC2 스팟 플릿 집합 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 할당 전략이 BEST_FIT로 설정되거나 할당 전략이 지정되지 않은 경우 이 역할이 필요합니다. 자세한 정보는 Amazon EC2 스팟 플릿 역할을 참조하세요.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

중요

생성 시 스팟 인스턴스에 태그를 지정하려면 여기에 지정된 스팟 플릿 IAM 역할이 최신 SpotFleetTaggingRoleAmazonEC2 관리형 정책을 사용해야 합니다. 이전에 권장한 AmazonEC2 SpotFleet 역할 관리형 정책에는 스팟 인스턴스에 태그를 지정하는 데 필요한 권한이 없습니다. 자세한 정보는 생성 시 태그가 지정되지 않은 스팟 인스턴스을 참조하세요.

타입: 문자열

필수 항목 여부: 이 파라미터는 SPOT 컴퓨팅 환경에 반드시 필요합니다.

launchTemplate

컴퓨팅 리소스와 연결할 선택적 시작 템플릿입니다. 이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다. 지정하지 마세요. CreateComputeEnvironment 혹은 UpdateComputeEnvironment API 작업에서 지정하는 기타 컴퓨팅 리소스 파라미터는 시작 템플릿의 동일한 파라미터를 재정의합니다. 시작 템플릿을 사용하려면 요청에서 시작 템플릿 ID 또는 시작 템플릿 이름을 지정해야 하지만, 둘 다 지정해서는 안 됩니다. 자세한 정보는 시작 템플릿 지원을 참조하세요.

컴퓨팅 환경을 업데이트할 때 사용자 지정 시작 템플릿을 제거하고 기본 시작 템플릿을 사용하려면 시작 템플릿 사양의 launchTemplateId 또는 launchTemplateName 멤버를 빈 문자열로 설정하십시오. 컴퓨팅 환경에서 시작 템플릿을 제거해도 시작 템플릿에 지정된 AMI는 사용된 적이 있더라도 제거되지 않습니다. 시작 템플릿에서 선택한 AMI를 업데이트하려면 updateToLatestImageVersion 파라미터를 true로 설정해야 합니다. 컴퓨팅 환경을 업데이트할 때 시작 템플릿을 변경하면 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

유형: LaunchTemplateSpecification

객체

필수 여부: 아니요

launchTemplateId

시작 템플릿의 ID입니다.

타입: 문자열

필수사항: 아니요

launchTemplateName

시작 템플릿의 이름입니다.

타입: 문자열

필수사항: 아니요

version

시작 템플릿의 버전 번호, $Latest 또는 $Default입니다.

값이 $Latest인 경우 시작 템플릿의 최신 버전이 사용됩니다. 값이 $Default인 경우 시작 템플릿의 기본 버전이 사용됩니다. 인프라 업데이트 중에 컴퓨팅 환경에 대해 둘 중 하나 $Latest 또는 $Default 지정된 경우, 시작 템플릿 버전을 AWS Batch 재평가하여 다른 버전의 시작 템플릿을 사용할 수 있습니다. 업데이트에 시작 템플릿이 지정되지 않은 경우에도 마찬가지입니다.

기본값: $Default.

타입: 문자열

필수사항: 아니요

ec2Configuration

EC2 컴퓨팅 환경의 인스턴스에 대해 Amazon Machine Image(AMI) 선택에 사용되는 정보를 제공합니다. Ec2Configuration이 지정되지 않으면 기본값은 Amazon Linux 2(ECS_AL2)입니다. 2021년 3월 31일 이전에는 GPU가 아닌 AWS Graviton 인스턴스의 경우 이 기본값은 Amazon Linux (ECS_AL1) 였습니다.

컴퓨팅 환경을 업데이트할 때 이 파라미터를 변경하면 컴퓨팅 환경의 인프라 업데이트가 필요합니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

참고

이 파라미터는 Fargate 리소스에서 실행되는 작업에는 적용되지 않습니다.

타입: Ec2Configuration객체 배열

필수: 아니요

imageIdOverride

이미지 유형과 일치하는 컴퓨팅 환경에서 시작된 인스턴스에 사용되는 AMI ID. 이 설정은 computeResource 오브젝트의 imageId 세트보다 우선합니다.

타입: 문자열

필수사항: 아니요

imageKubernetesVersion

컴퓨팅 환경의 Kubernetes 버전입니다. 값을 지정하지 않으면 AWS Batch 에서 지원하는 최신 버전이 사용됩니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.

필수 여부: 아니요

imageType

AMI를 선택하기 위해 인스턴스 유형과 일치시킬 이미지 유형입니다. 지원되는 값은 ECS 및 EKS 리소스에 따라 다릅니다.

ECS

imageIdOverride 파라미터를 지정하지 않으면 최근 Amazon ECS에 최적화된 Amazon Linux 2 AMI(ECS_AL2)가 사용됩니다. 업데이트에서 새 이미지 유형을 지정했지만 imageIdOverride 매개변수도 imageId 지정하지 않은 경우, 에서 지원하는 해당 이미지 유형에 최적화된 최신 Amazon ECS AWS Batch AMI가 사용됩니다.

ECS_AL2

Amazon Linux 2: 모든 비 GPU 인스턴스 패밀리에 대한 기본값입니다.

ECS_AL2_NVIDIA

Amazon Linux 2 (GPU): 모든 GPU 인스턴스 패밀리 (예: P4 및G4) 의 기본값이며 AWS Graviton 기반이 아닌 모든 인스턴스 유형에 사용할 수 있습니다.

ECS_AL1

Amazon Linux. Amazon Linux는 표준 지원 수준에 도달했습니다. end-of-life 자세한 내용은 Amazon Linux AMI를 참조하세요.

EKS

imageIdOverride 파라미터를 지정하지 않으면 최근 Amazon EKS에 최적화된 Amazon Linux AMI(EKS_AL2)가 사용됩니다. 업데이트에서 새 이미지 유형을 지정했지만 또는 imageIdOverride 파라미터는 imageId 지정하지 않은 경우 AWS Batch 지원하는 해당 이미지 유형에 맞게 최적화된 최신 Amazon EKS AMI가 사용됩니다.

EKS_AL2

Amazon Linux 2: 모든 비 GPU 인스턴스 패밀리에 대한 기본값입니다.

EKS_AL2_NVIDIA

Amazon Linux 2 (가속): 모든 GPU 인스턴스 패밀리 (예: P4 및G4) 의 기본값이며 AWS Graviton 기반이 아닌 모든 인스턴스 유형에 사용할 수 있습니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.

필수 여부: 예

Amazon EKS 구성

AWS Batch 컴퓨팅 환경을 지원하는 Amazon EKS 클러스터를 위한 구성 클러스터가 있어야 컴퓨팅 환경을 생성할 수 있습니다.

eksClusterArn

Amazon EKS 클러스터의 Amazon 리소스 이름(ARN)입니다. 예를 들면, arn:aws:eks:us-east-1:123456789012:cluster/ClusterForBatch입니다.

타입: 문자열

필수 항목 여부: 예

kubernetesNamespace

Amazon EKS 클러스터의 네임스페이스입니다. AWS Batch 이 네임스페이스에서 파드를 관리합니다. 값은 비어 있거나 null일 수 없습니다. 길이는 64자 미만이어야 하고 default로 설정할 수 없으며 'kube-'로 시작할 수 없으며 정규식 ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$와 일치해야 합니다. 자세한 내용은 Kubernetes 설명서의 네임스페이스를 참조하세요.

타입: 문자열

필수 항목 여부: 예

유형: 오브젝트 EksConfiguration

필수 여부: 아니요

서비스 역할

serviceRole

사용자를 대신하여 다른 AWS 서비스를 AWS Batch 호출할 수 있게 해주는 IAM 역할의 전체 Amazon 리소스 이름 (ARN). 자세한 정보는 서비스 연결 역할 사용: AWS Batch을 참조하세요. 서비스 역할을 지정하지 않는 것을 권장합니다. 이렇게 하면 AWSServiceRoleForBatch서비스 연결 AWS Batch 역할을 사용합니다.

중요

계정에서 AWS Batch 서비스 연결 역할 (AWSServiceRoleForBatch) 을 이미 만든 경우 여기서 역할을 지정하지 않는 한 해당 역할이 컴퓨팅 환경에 기본적으로 사용됩니다. 계정에 AWS Batch 서비스 연결 역할이 없고 여기에 지정된 역할이 없는 경우 서비스는 계정에 서비스 연결 역할을 만들려고 합니다. AWS Batch AWSServiceRoleForBatch 서비스 연결 역할에 대한 자세한 정보는 서비스 연결 역할 권한에 대한 AWS Batch 섹션을 참조하십시오.

AWSServiceRoleForBatch 서비스 연결 역할을 사용하여 컴퓨팅 환경을 생성한 경우 일반 IAM 역할을 사용하도록 변경할 수 없습니다. 마찬가지로 일반 IAM 역할로 컴퓨팅 환경을 생성한 경우 AWSServiceRoleForBatch 서비스 연결 역할을 사용하도록 변경할 수 없습니다. 인프라 업데이트가 필요한 컴퓨팅 환경의 파라미터를 업데이트하려면 AWSServiceRoleForBatch 서비스 연결 역할을 사용해야 합니다. 자세한 정보는 컴퓨팅 환경 업데이트을 참조하세요.

지정된 역할이 / 이외의 다른 경로가 있으면 전체 역할 ARN을 지정(권장 사항)하거나 경로에 역할 이름에 접두사를 추가해야 합니다.

참고

서비스 역할을 생성한 방법에 따라 AWS Batch 서비스 역할의 Amazon 리소스 이름 (ARN) 에 service-role 경로 접두사가 포함될 수 있습니다. 서비스 역할 이름만 지정하는 경우 ARN에서 경로 접두사를 사용하지 service-role 않는 AWS Batch 것으로 가정합니다. 이러한 이유로 컴퓨팅 환경을 생성할 때는 서비스 역할의 전체 ARN을 지정하는 것이 좋습니다.

타입: 문자열

필수사항: 아니요

Tags

tags

컴퓨팅 환경에 연결할 키-값 페어 태그. 자세한 정보는 AWS Batch 리소스에 태그 지정을 참조하세요.

유형: 문자열 간 맵

필수 여부: 아니요