RES환경에 접근하기 위한 IAM 역할 준비 EC2Image Builder 컴포넌트 생성 EC2Image Builder 레시피 준비하기 EC2Image Builder 인프라 구성 Image Builder 이미지 파이프라인 설정 Image Builder 이미지 파이프라인 실행 에 새 소프트웨어 스택 등록 RES

구성 준비 RES 완료 AMIs

RES-ready를 사용하면 AMIs 사용자 정의에 가상 데스크톱 인스턴스 (VDIs) 에 대한 RES 종속성을 사전 설치할 수 있습니다. AMIs RES-ready를 사용하면 미리 베이크된 이미지를 사용하는 VDI 인스턴스의 부팅 시간이 AMIs 향상됩니다. EC2Image Builder를 사용하여 새 소프트웨어 스택을 AMIs 빌드하고 등록할 수 있습니다. Image Builder에 대한 자세한 내용은 Image Builder 사용 설명서를 참조하십시오.

시작하기 전에 의 최신 버전을 배포해야 RES 합니다.

RES환경에 접근하기 위한 IAM 역할 준비

EC2Image Builder에서 RES 환경 서비스에 액세스하려면 RES -라는 IAM 역할을 만들거나 수정해야 EC2InstanceProfileForImageBuilder 합니다. Image Builder에서 사용할 IAM 역할을 구성하는 방법에 대한 자세한 내용은 Image Builder 사용 안내서의AWS Identity and Access Management (IAM) 을 참조하십시오.

역할에 필요한 사항은 다음과 같습니다.

신뢰할 수 있는 관계에는 Amazon EC2 서비스가 포함됩니다.
A mazonSSMManaged InstanceCore 및 EC2InstanceProfileForImageBuilder 정책
배포된 RES 환경에 대한 DynamoDB 및 Amazon S3 액세스가 제한된 사용자 지정 정책 RES

(이 정책은 고객 관리형 또는 고객 인라인 정책 문서일 수 있습니다.)

신뢰할 수 있는 관계 주체:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.amazonaws.com"
            }
            "Action": "sts:AssumeRole"
        }
    ]
}

RES정책:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RESDynamoDBAccess",
            "Effect": "Allow",
            "Action": "dynamodb:GetItem",
            "Resource": "arn:aws:dynamodb:{AWS-Region}:{AWS-Account-ID}:table/{RES-EnvironmentName}.cluster-settings",
            "Condition": {
                "ForAllValues:StringLike": {
                    "dynamodb:LeadingKeys": [
                        "global-settings.gpu_settings.*",
                        "global-settings.package_config.*"
                    ]
                }
            }
        },
        {
            "Sid": "RESS3Access",
            "Effect": "Allow",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::{RES-EnvironmentName}-cluster-{AWS-Region}-{AWS-Account-ID}/idea/vdc/res-ready-install-script-packages/*"
        }
    ]
}

EC2Image Builder 컴포넌트 생성

Image Builder 사용 안내서의 Image Builder 콘솔을 사용하여 구성 요소를 생성하는 지침을 따르십시오.

구성 요소 세부 정보를 입력합니다.

유형에서 빌드를 선택합니다.
이미지 운영 체제 (OS) 의 경우 Linux 또는 Windows를 선택합니다.
구성 요소 이름에는 다음과 같은 의미 있는 이름을 입력합니다research-and-engineering-studio-vdi-<operating-system>.
구성 요소의 버전 번호를 입력하고 필요에 따라 설명을 추가합니다.

정의 문서의 경우 다음 정의 파일을 입력합니다. 오류가 발생하는 경우 YAML 파일이 공간을 많이 차지하기 때문에 파일이 원인일 가능성이 높습니다.

Linux


#  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
#  Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
#  with the License. A copy of the License is located at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
#  or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
#  OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
#  and limitations under the License.
name: research-and-engineering-studio-vdi-linux
description: An RES EC2 Image Builder component to install required RES software dependencies for Linux VDI.
schemaVersion: 1.0
parameters:
  - AWSAccountID:
      type: string
      description: RES Environment AWS Account ID
  - RESEnvName:
      type: string
      description: RES Environment Name
  - RESEnvRegion:
      type: string
      description: RES Environment Region
  - RESEnvReleaseVersion:
      type: string
      description: RES Release Version

phases:
  - name: build
    steps:
       - name: PrepareRESBootstrap
         action: ExecuteBash
         onFailure: Abort
         maxAttempts: 3
         inputs:
            commands:
                - 'mkdir -p /root/bootstrap/logs'
                - 'mkdir -p /root/bootstrap/latest'
       - name: DownloadRESLinuxInstallPackage
         action: S3Download
         onFailure: Abort
         maxAttempts: 3
         inputs:
            - source: 's3://{{ RESEnvName }}-cluster-{{ RESEnvRegion }}-{{ AWSAccountID }}/idea/vdc/res-ready-install-script-packages/linux/res_linux_install_{{ RESEnvReleaseVersion }}.tar.gz'
              destination: '/root/bootstrap/res_linux_install_{{ RESEnvReleaseVersion }}.tar.gz'
              expectedBucketOwner: '{{ AWSAccountID }}'
       - name: RunInstallScript
         action: ExecuteBash
         onFailure: Abort
         maxAttempts: 3
         inputs:
            commands:
                - 'tar -xvf {{ build.DownloadRESLinuxInstallPackage.inputs[0].destination }} -C /root/bootstrap/latest'
                - '/bin/bash /root/bootstrap/latest/virtual-desktop-host-linux/install.sh -r {{ RESEnvRegion }} -n {{ RESEnvName }} -g NONE'
       - name: FirstReboot
         action: Reboot
         onFailure: Abort
         maxAttempts: 3
         inputs:
            delaySeconds: 0
       - name: RunInstallPostRebootScript
         action: ExecuteBash
         onFailure: Abort
         maxAttempts: 3
         inputs:
            commands:
                - '/bin/bash /root/bootstrap/latest/virtual-desktop-host-linux/install_post_reboot.sh'
       - name: SecondReboot
         action: Reboot
         onFailure: Abort
         maxAttempts: 3
         inputs:
            delaySeconds: 0

Windows


#  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
#  Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
#  with the License. A copy of the License is located at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
#  or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
#  OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
#  and limitations under the License.
name: research-and-engineering-studio-vdi-windows
description: An RES EC2 Image Builder component to install required RES software dependencies for Windows VDI.
schemaVersion: 1.0
parameters:
  - AWSAccountID:
      type: string
      description: RES Environment AWS Account ID
  - RESEnvName:
      type: string
      description: RES Environment Name
  - RESEnvRegion:
      type: string
      description: RES Environment Region
  - RESEnvReleaseVersion:
      type: string
      description: RES Release Version

phases:
  - name: build
    steps:
       - name: CreateRESBootstrapFolder
         action: CreateFolder
         onFailure: Abort
         maxAttempts: 3
         inputs:
            - path: 'C:\Users\Administrator\RES\Bootstrap'
              overwrite: true
       - name: DownloadRESWindowsInstallPackage
         action: S3Download
         onFailure: Abort
         maxAttempts: 3
         inputs:
            - source: 's3://{{ RESEnvName }}-cluster-{{ RESEnvRegion }}-{{ AWSAccountID }}/idea/vdc/res-ready-install-script-packages/windows/res_windows_install_{{ RESEnvReleaseVersion }}.tar.gz'
              destination: '{{ build.CreateRESBootstrapFolder.inputs[0].path }}\res_windows_install_{{ RESEnvReleaseVersion }}.tar.gz'
              expectedBucketOwner: '{{ AWSAccountID }}'
       - name: RunInstallScript
         action: ExecutePowerShell
         onFailure: Abort
         maxAttempts: 3
         inputs:
            commands:
                - 'cd {{ build.CreateRESBootstrapFolder.inputs[0].path }}'
                - 'Tar -xf res_windows_install_{{ RESEnvReleaseVersion }}.tar.gz'
                - 'Import-Module .\virtual-desktop-host-windows\Install.ps1'
                - 'Install-WindowsEC2Instance'
       - name: Reboot
         action: Reboot
         onFailure: Abort
         maxAttempts: 3
         inputs:
            delaySeconds: 0

선택적 태그를 생성하고 구성 요소 만들기를 선택합니다.

EC2Image Builder 레시피 준비하기

EC2Image Builder 레시피는 이미지를 사용자 정의하고 모든 것이 예상대로 작동하는지 확인하기 위해 추가하는 구성 요소 집합과 함께 새 이미지를 만들기 위한 시작점으로 사용할 기본 이미지를 정의합니다. 필요한 RES 소프트웨어 종속성을 AMI 사용하여 대상을 구성하려면 레시피를 만들거나 수정해야 합니다. 레시피에 대한 자세한 내용은 레시피 관리를 참조하십시오.

RES지원되는 이미지 운영 체제는 다음과 같습니다.

아마존 리눅스 2 (x86 및ARM64)
우분투 22.04.3 (x86)
윈도우 2019, 2022년 (x86)

Create a new recipe

에서 EC2 Image Builder 콘솔을 엽니다https://console.aws.amazon.com/imagebuilder.
저장된 리소스에서 이미지 레시피를 선택합니다.
이미지 레시피 생성을 선택합니다.
고유한 이름과 버전 번호를 입력합니다.
에서 지원하는 기본 이미지를 선택합니다RES.
인스턴스 구성에서 SSM 에이전트가 사전 설치되어 있지 않은 경우 에이전트를 설치하십시오. 사용자 데이터 및 기타 필요한 사용자 데이터에 정보를 입력합니다.
참고
SSM에이전트 설치 방법에 대한 자세한 내용은 다음을 참조하십시오.
- Linux용 EC2 인스턴스에 SSM 에이전트를 수동으로 설치
- Windows Server용 EC2 인스턴스에서 SSM 에이전트를 수동으로 설치 및 제거
Linux 기반 레시피의 경우 Amazon 관리 aws-cli-version-2-linux 빌드 구성 요소를 레시피에 추가합니다. RES설치 스크립트는 AWS CLI 를 사용하여 DynamoDB 클러스터 설정의 구성 값에 대한 VDI 액세스를 제공합니다. Windows에는 이 구성 요소가 필요하지 않습니다.
Linux 또는 Windows 환경용으로 만든 EC2 Image Builder 구성 요소를 추가하고 필요한 매개 변수 값을 입력합니다. 필수 입력 매개변수는 AWSAccountID, RESEnvNameRESEnvRegion, 및 RESEnvReleaseVersion 입니다.

중요
Linux 환경에서는 aws-cli-version-2-linux 빌드 구성 요소를 먼저 추가한 후 이러한 구성 요소를 순서대로 추가해야 합니다.
(권장) Amazon 관리 simple-boot-test-<linux-or-windows> 테스트 구성 요소를 추가하여 실행이 AMI 가능한지 확인합니다. 이는 최소 권장 사항입니다. 요구 사항을 충족하는 다른 테스트 구성 요소를 선택할 수 있습니다.
필요한 경우 옵션 섹션을 모두 작성하고 원하는 다른 구성 요소를 추가한 다음 레시피 생성을 선택합니다.

Modify a recipe

기존 EC2 Image Builder 레시피가 있는 경우 다음 구성 요소를 추가하여 사용할 수 있습니다.

Linux 기반 레시피의 경우 Amazon 관리 aws-cli-version-2-linux 빌드 구성 요소를 레시피에 추가합니다. RES설치 스크립트는 AWS CLI 를 사용하여 DynamoDB 클러스터 설정의 구성 값에 대한 VDI 액세스를 제공합니다. Windows에는 이 구성 요소가 필요하지 않습니다.
Linux 또는 Windows 환경용으로 만든 EC2 Image Builder 구성 요소를 추가하고 필요한 매개 변수 값을 입력합니다. 필수 입력 매개변수는 AWSAccountID, RESEnvNameRESEnvRegion, 및 RESEnvReleaseVersion 입니다.

중요
Linux 환경에서는 aws-cli-version-2-linux 빌드 구성 요소를 먼저 추가한 후 이러한 구성 요소를 순서대로 추가해야 합니다.
필요한 경우 옵션 섹션을 모두 작성하고 원하는 다른 구성 요소를 추가한 다음 레시피 만들기를 선택합니다.

EC2Image Builder 인프라 구성

인프라 구성을 사용하여 Image Builder가 Image Builder 이미지를 구축하고 테스트하는 데 사용하는 Amazon EC2 인프라를 지정할 수 있습니다. 에서 사용하려면 새 인프라 구성을 생성하거나 기존 인프라 구성을 사용할 수 있습니다. RES

새 인프라 구성을 만들려면 인프라 구성 만들기를 참조하십시오.
기존 인프라 구성을 사용하려면 인프라 구성을 업데이트하세요.

Image Builder 인프라를 구성하려면:

IAM역할에는 이전에 구성한 역할을 입력합니다RES환경에 접근하기 위한 IAM 역할 준비.
인스턴스 유형에서는 메모리가 4GB 이상이고 선택한 기본 AMI 아키텍처를 지원하는 유형을 선택합니다. Amazon EC2 인스턴스 유형을 참조하십시오.
VPC, 서브넷 및 보안 그룹의 경우, 소프트웨어 패키지를 다운로드하려면 인터넷 액세스를 허용해야 합니다. 또한 환경의 cluster-settings DynamoDB 테이블 및 Amazon S3 클러스터 버킷에 대한 액세스가 허용되어야 합니다. RES

Image Builder 이미지 파이프라인 설정

Image Builder 이미지 파이프라인은 기본 이미지, 빌드 및 테스트용 구성 요소, 인프라 구성, 배포 설정을 조합합니다. RESAMIs-ready용 이미지 파이프라인을 구성하려면 새 파이프라인을 생성하거나 기존 파이프라인을 사용할 수 있습니다. 자세한 내용은 AMIImage Builder 사용 안내서의 이미지 파이프라인 생성 및 업데이트를 참조하십시오.

Create a new Image Builder pipeline

에서 Image Builder 콘솔을 엽니다https://console.aws.amazon.com/imagebuilder.
탐색에서 이미지 파이프라인을 선택합니다.
이미지 파이프라인 생성을 선택합니다.
고유한 이름, 선택적 설명, 일정, 빈도를 입력하여 파이프라인 세부 정보를 지정합니다.
레시피 선택에서 기존 레시피 사용을 선택하고 에서 생성한 레시피를 선택합니다EC2Image Builder 레시피 준비하기. 레시피 세부 정보가 정확한지 확인하세요.
이미지 생성 프로세스 정의의 경우 사용 사례에 따라 기본 또는 사용자 지정 워크플로를 선택합니다. 대부분의 경우 기본 워크플로로도 충분합니다. 자세한 내용은 EC2 Image Builder 파이프라인의 이미지 워크플로 구성을 참조하십시오.
인프라 구성 정의에서 기존 인프라 구성 선택을 선택하고 에서 생성한 인프라 구성을 선택합니다EC2Image Builder 인프라 구성. 인프라 세부 정보가 정확한지 확인하십시오.
배포 설정 정의에서 서비스 기본값을 사용하여 배포 설정 생성을 선택합니다. 출력 이미지는 사용자 RES 환경과 AWS 리전 같아야 합니다. 서비스 기본값을 사용하면 Image Builder가 사용되는 지역에 이미지가 생성됩니다.
파이프라인 세부 정보를 검토하고 파이프라인 생성을 선택합니다.

Modify an existing Image Builder pipeline

기존 파이프라인을 사용하려면 에서 만든 레시피를 사용하도록 세부 정보를 EC2Image Builder 레시피 준비하기 수정하세요.
Save changes(변경 사항 저장)를 선택합니다.

Image Builder 이미지 파이프라인 실행

구성된 출력 이미지를 생성하려면 이미지 파이프라인을 시작해야 합니다. 빌드 프로세스는 이미지 레시피의 구성 요소 수에 따라 최대 1시간까지 걸릴 수 있습니다.

이미지 파이프라인을 실행하려면:

이미지 파이프라인에서 에서 Image Builder 이미지 파이프라인 설정 만든 파이프라인을 선택합니다.
액션에서 파이프라인 실행을 선택합니다.

새 소프트웨어 스택을 등록하십시오. RES

의 지침에 따라 소프트웨어 소프트웨어 스택 () AMIs 스택을 등록하십시오.
AMIID에는 내장된 출력 이미지의 AMI ID를 입력합니다Image Builder 이미지 파이프라인 실행.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

사용자 지정 권한 범위 설정

관리자 가이드