를 사용하여 Docker활성화 플릿 생성 AWS CLI

대기열 역할에는 Amazon ECR에 인증하고 Docker 대기열 환경에서 선택한 이미지를 가져올 수 있는 권한이 필요합니다. 기본 대기열 환경에 대한 플릿 역할 권한은 선택 사항입니다. 호스트 구성 작업 또는 작업자 측 도구가 대기열 세션 외부에서 이미지를 가져올 때 추가합니다.

사전 조건

시작하기 전에 Deadline Cloud 플릿을 생성하고 대기열 및 플릿 역할에 정책을 연결할 수 AWS CLI 있는 권한을 사용하여를 구성합니다. Amazon ECR 프라이빗 리포지토리에 기존 팜, 대기열, 대기열 역할, 플릿 역할 및 컨테이너 이미지도 필요합니다.

플릿 생성

Docker활성화 플릿을 생성하려면

1. 팜, 대기열 및 역할 값을 설정합니다.

   FARM_ID=farm-0123456789abcdef0123456789abcdef
   QUEUE_ID=queue-0123456789abcdef0123456789abcdef
   FLEET_ROLE_ARN=arn:aws:iam::123456789012:role/DeadlineFleetRole
   MAX_WORKERS=10
   
   QUEUE_ROLE_ARN=$(aws deadline get-queue \
       --farm-id "$FARM_ID" \
       --queue-id "$QUEUE_ID" \
       --query roleArn \
       --output text)
   QUEUE_ROLE_NAME=${QUEUE_ROLE_ARN##*/}
   FLEET_ROLE_NAME=${FLEET_ROLE_ARN##*/}
   ECR_READ_ONLY_POLICY=arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly

2. Amazon ECR 읽기 전용 정책을 대기열 역할에 연결합니다. 기본 Docker 대기열 환경은 대기열 자격 증명을 사용하여 이미지를 인증하고 가져옵니다.

   aws iam attach-role-policy \
       --role-name "$QUEUE_ROLE_NAME" \
       --policy-arn "$ECR_READ_ONLY_POLICY"

3. (선택 사항) 호스트 구성 작업 또는 작업자 측 도구가 대기열 세션 외부에서 이미지를 가져와야 하는 경우 동일한 정책을 플릿 역할에 연결합니다.

   aws iam attach-role-policy \
       --role-name "$FLEET_ROLE_NAME" \
       --policy-arn "$ECR_READ_ONLY_POLICY"

4. 다음 플릿 구성docker-fleet-configuration.json으로 라는 파일을 생성합니다.

   {
     "serviceManagedEc2": {
       "instanceCapabilities": {
         "vCpuCount": {
           "min": 4,
           "max": 16
         },
         "memoryMiB": {
           "min": 8192,
           "max": 65536
         },
         "osFamily": "linux",
         "cpuArchitectureType": "x86_64",
         "softwareAddOns": [
           {
             "name": "docker"
           }
         ]
       },
       "instanceMarketOptions": {
         "type": "spot"
       }
     }
   }

5. 서비스 관리형 플릿을 생성하고 플릿 ID를 저장합니다.

   FLEET_ID=$(aws deadline create-fleet \
       --farm-id "$FARM_ID" \
       --display-name "Docker fleet" \
       --role-arn "$FLEET_ROLE_ARN" \
       --min-worker-count 0 \
       --max-worker-count "$MAX_WORKERS" \
       --configuration file://docker-fleet-configuration.json \
       --query fleetId \
       --output text)
   
   echo "$FLEET_ID"

6. 대기열을 플릿과 연결합니다.

   aws deadline create-queue-fleet-association \
       --farm-id "$FARM_ID" \
       --queue-id "$QUEUE_ID" \
       --fleet-id "$FLEET_ID"

플릿 및 역할 권한 확인

컨테이너 지원을 확인하려면

1. 플릿 구성에 Docker 소프트웨어 추가 기능이 포함되어 있는지 확인합니다.

   aws deadline get-fleet \
       --farm-id "$FARM_ID" \
       --fleet-id "$FLEET_ID" \
       --query 'configuration.serviceManagedEc2.instanceCapabilities.softwareAddOns'

   응답에가 포함되어 있는지 확인합니다"name": "docker".

2. 대기열 역할에 Amazon ECR 읽기 전용 정책이 있는지 확인합니다.

   aws iam list-attached-role-policies \
       --role-name "$QUEUE_ROLE_NAME" \
       --query 'AttachedPolicies[?PolicyName==`AmazonEC2ContainerRegistryReadOnly`]'

3. 정책을 플릿 역할에 연결한 경우를 사용하여 명령을 반복합니다--role-name "$FLEET_ROLE_NAME".

플릿은 루트 없는를 제공Docker하지만 대기열에는 여전히 이미지를 식별하는 Docker 대기열 환경이 필요합니다. 대기열 구성 세부 정보는 섹션을 참조하세요서비스 관리형 플릿에 대한 컨테이너 지원.