최신 버전의 EC2Launch v2 설치하기

최신 버전의 EC2Launch v2 설치하기 (Install the latest version of EC2Launch v2)

다음 방법 중 하나로 EC2 인스턴스에 EC2Launch v2 에이전트를 설치할 수 있어요.

  • Amazon S3에서 에이전트를 다운로드하고 Windows PowerShell로 설치. 다운로드 URL은 'Amazon S3의 EC2Launch v2 다운로드'를 참고하세요.
  • SSM Distributor로 설치.
  • 사용자 지정 이미지를 만들 때 EC2 Image Builder 구성 요소에서 설치.
  • EC2Launch v2가 사전 설치된 AMI에서 인스턴스 시작.

경고 AmazonEC2Launch.msi는 EC2Launch(v1) 및 EC2Config 같은 이전 버전의 EC2 시작 서비스를 제거해요.

설치 단계는 선호하는 방법에 맞는 탭을 선택하세요.

PowerShell

Windows PowerShell로 최신 버전의 EC2Launch v2 에이전트를 설치하려면 다음 단계를 따르세요.

  1. 로컬 디렉토리를 만드세요.
New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
  1. 다운로드 위치의 URL을 설정하세요. 사용할 Amazon S3 URL로 다음 명령을 실행하세요. 다운로드 URL은 'Amazon S3의 EC2Launch v2 다운로드'를 참고하세요.
$Url = "Amazon S3 URL/AmazonEC2Launch.msi"
  1. 다음 복합 명령으로 에이전트를 다운로드하고 설치를 실행하세요.
$DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
msiexec /i "$DownloadFile"

참고 파일을 다운로드할 때 오류가 발생하고 Windows Server 2016 이하를 사용한다면 PowerShell 터미널에서 TLS 1.2를 활성화해야 할 수 있어요. 다음 명령으로 현재 PowerShell 세션에서 TLS 1.2를 활성화한 뒤 다시 시도할 수 있어요.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  1. msiexec 명령은 Windows Server 인스턴스의 다음 위치에 EC2Launch v2를 설치해요: %ProgramFiles%\Amazon\EC2Launch. 설치가 실행됐는지 확인하려면 인스턴스의 로컬 파일 시스템을 확인할 수 있어요.

AWS Systems Manager Distributor

AWS Systems Manager Quick Setup으로 EC2Launch v2의 자동 업데이트를 구성하려면 'Distributor Quick Setup으로 자동 설치 및 업데이트'를 참고하세요. AWS Systems Manager Distributor에서 AWSEC2Launch-Agent 패키지를 일회성으로 설치할 수도 있어요. Systems Manager Distributor에서 패키지를 설치하는 방법은 AWS Systems Manager User Guide의 '패키지 설치 또는 업데이트'를 참고하세요.

EC2 Image Builder 구성 요소

EC2 Image Builder로 사용자 지정 이미지를 빌드할 때 ec2launch-v2-windows 구성 요소를 설치할 수 있어요. EC2 Image Builder로 사용자 지정 이미지를 빌드하는 방법은 EC2 Image Builder User Guide의 'EC2 Image Builder 콘솔 마법사를 사용해 이미지 파이프라인 만들기'를 참고하세요.

AMI

EC2Launch v2는 Windows Server 2022 이상 운영체제용 AMI에 기본으로 사전 설치돼 있어요.

  • Windows_Server-version-English-Full-Base
  • Windows_Server-version-English-Core-Base
  • Windows_Server-version-English-Core-EKS_Optimized
  • 그 외 모든 언어의 Windows Server version AMI
  • SQL이 설치된 Windows Server version AMI

EC2Launch v2는 다음 Windows Server AMI에도 사전 설치돼 있어요. 이러한 AMI는 Amazon EC2 콘솔에서 찾거나 AWS CLI에서 EC2LaunchV2- 검색 접두사를 사용해 찾을 수 있어요.

  • EC2LaunchV2-Windows_Server-2019-English-Core-Base
  • EC2LaunchV2-Windows_Server-2019-English-Full-Base
  • EC2LaunchV2-Windows_Server-2016-English-Core-Base
  • EC2LaunchV2-Windows_Server-2016-English-Full-Base

AWS Systems Manager Distributor Quick Setup으로 EC2Launch v2 자동 설치·업데이트하기

AWS Systems Manager Distributor Quick Setup으로 EC2Launch v2의 자동 업데이트를 설정할 수 있어요. 다음 과정은 인스턴스에 지정한 빈도로 EC2Launch v2 에이전트를 자동 업데이트하는 Systems Manager Association을 설정해요. Distributor Quick Setup이 만드는 Association은 AWS 계정과 리전 안의 인스턴스 또는 AWS Organization 안의 인스턴스를 포함할 수 있어요. 조직 설정에 대한 자세한 내용은 AWS Organizations User Guide의 'Tutorial: Creating and configuring an organization'을 참고하세요.

시작하기 전에 인스턴스가 모든 사전 준비를 충족하는지 확인하세요.

사전 준비 (Prerequisites)

Distributor Quick Setup으로 자동 업데이트를 설정하려면 인스턴스가 다음 사전 준비를 충족해야 해요.

  • EC2Launch v2를 지원하는 실행 중인 인스턴스가 하나 이상 있어야 해요. EC2Launch v2 지원 운영체제를 참고하세요.
  • 인스턴스에서 Systems Manager 설정 작업을 수행했어야 해요. 자세한 내용은 AWS Systems Manager User Guide의 'Systems Manager 설정'을 참고하세요.
  • EC2Launch v2가 인스턴스에 설치된 유일한 시작 에이전트여야 해요. 시작 에이전트가 둘 이상 설치되어 있으면 Distributor Quick Setup 구성이 실패해요. Distributor Quick Setup으로 EC2Launch v2를 구성하기 전에 EC2Config 또는 EC2Launch v1 시작 에이전트가 있다면 제거하세요.

EC2Launch v2용 Distributor Quick Setup 구성하기

Distributor Quick Setup으로 EC2Launch v2 구성을 만들려면 Distributor 패키지 배포 단계를 완료할 때 다음 설정을 사용하세요.

  • Software packages: Amazon EC2Launch v2 agent.
  • Update frequency: 목록에서 빈도를 선택하세요.
  • Targets: 사용 가능한 배포 옵션에서 선택하세요.

구성 상태를 확인하려면 AWS Management Console에서 Systems Manager Quick Setup의 Configurations 탭으로 이동하세요.

  1. AWS Systems Manager 콘솔을 https://console.aws.amazon.com/systems-manager/ 에서 엽니다.
  2. 탐색 창에서 Quick Setup을 선택하세요.
  3. Configurations 탭에서 만든 구성과 연결된 행을 선택하세요. Configurations 탭은 구성을 나열하고 리전, Deployment status, Association status 같은 핵심 세부 정보 요약을 포함해요.

참고 모든 EC2Launch v2 Distributor 구성의 연결 이름은 다음 접두사로 시작해요: AWS-QuickSetup-Distributor-EC2Launch-Agent-.

  1. 세부 정보를 보려면 구성을 선택하고 View details를 선택하세요.

자세한 내용과 문제 해결 단계는 AWS Systems Manager User Guide의 'Quick Setup 결과 문제 해결'을 참고하세요.

Amazon S3의 EC2Launch v2 다운로드

최신 버전의 EC2Launch v2를 설치하려면 다음 위치에서 설치 관리자를 다운로드하세요.

설치 옵션 구성하기

EC2Launch v2를 설치하거나 업그레이드할 때 EC2Launch v2 설치 대화 상자나 명령줄 셸의 msiexec 명령으로 설치 옵션을 구성할 수 있어요.

EC2Launch v2 설치 관리자가 인스턴스에서 처음 실행되면 다음과 같이 인스턴스의 시작 에이전트 설정을 초기화해요.

  • 로컬 경로를 만들고 시작 에이전트 파일을 그곳에 써요. 이를 클린 설치(clean install)라고도 해요.
  • EC2LAUNCH_TELEMETRY 환경 변수가 아직 없으면 만들고, 구성에 따라 설정해요.

구성 세부 정보는 사용할 구성 방법에 맞는 탭을 선택하세요.

Amazon EC2Launch Setup 대화 상자

EC2Launch v2를 설치하거나 업그레이드할 때 EC2Launch v2 설치 대화 상자를 통해 다음 설치 옵션을 구성할 수 있어요.

기본 설치 옵션 (Basic Install options)

  • Send Telemetry – 설정 대화 상자에 이 기능을 포함하면 설치 관리자가 EC2LAUNCH_TELEMETRY 환경 변수를 값 1로 설정해요. Send Telemetry를 비활성화하면 설치 관리자가 환경 변수를 값 0으로 설정해요. EC2Launch v2 에이전트가 실행되면 EC2LAUNCH_TELEMETRY 환경 변수를 읽어 텔레메트리 데이터를 업로드할지 결정해요. 값이 1이면 업로드하고, 그렇지 않으면 업로드하지 않아요.
  • Default configuration – EC2Launch v2의 기본 구성은 기존 로컬 시작 에이전트가 있으면 덮어쓰는 것이에요. 인스턴스에서 처음 설치를 실행하면 기본 구성이 클린 설치를 수행해요. 초기 설치에서 기본 구성을 비활성화하면 설치가 실패해요. 나중에 인스턴스에서 다시 설치를 실행하면 기본 구성을 비활성화해 %ProgramData%/Amazon/EC2Launch/config/agent-config.yml 파일을 교체하지 않는 업그레이드를 수행할 수 있어요.

예시: 텔레메트리로 EC2Launch v2 업그레이드하기

다음 예시는 현재 설치를 업그레이드하고 텔레메트리를 활성화하도록 구성된 EC2Launch v2 설정 대화 상자를 보여줘요. 이 구성은 에이전트 구성 파일을 교체하지 않는 설치를 수행하고, EC2LAUNCH_TELEMETRY 환경 변수를 값 1로 설정해요.

명령줄 (Command line)

EC2Launch v2를 설치하거나 업그레이드할 때 명령줄 셸의 msiexec 명령으로 다음 설치 옵션을 구성할 수 있어요.

ADDLOCAL 매개변수 값

  • Basic (필수) – 시작 에이전트를 설치해요. 이 값이 ADDLOCAL 매개변수에 없으면 설치가 종료돼요.
  • Clean – ADDLOCAL 매개변수에 Clean 값을 포함하면 설치 관리자가 에이전트 구성 파일을 다음 위치에 써요: %ProgramData%/Amazon/EC2Launch/config/agent-config.yml. 에이전트 구성 파일이 이미 있으면 덮어써요. ADDLOCAL 매개변수에서 Clean 값을 빼면 설치 관리자가 에이전트 구성 파일을 교체하지 않는 업그레이드를 수행해요.
  • Telemetry – ADDLOCAL 매개변수에 Telemetry 값을 포함하면 설치 관리자가 EC2LAUNCH_TELEMETRY 환경 변수를 값 1로 설정해요. ADDLOCAL 매개변수에서 Telemetry 값을 빼면 설치 관리자가 환경 변수를 값 0으로 설정해요. EC2Launch v2 에이전트가 실행되면 EC2LAUNCH_TELEMETRY 환경 변수를 읽어 텔레메트리 데이터를 업로드할지 결정해요. 값이 1이면 업로드하고, 그렇지 않으면 업로드하지 않아요.

예시: 텔레메트리로 EC2Launch v2 설치하기

& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q

EC2Launch v2 버전 확인하기

다음 절차 중 하나로 인스턴스에 설치된 EC2Launch v2 버전을 확인하세요.

PowerShell

Windows PowerShell로 설치된 EC2Launch v2 버전을 다음과 같이 확인하세요.

  1. AMI에서 인스턴스를 시작하고 연결하세요.
  2. PowerShell에서 다음 명령을 실행해 설치된 EC2Launch v2 버전을 확인하세요:
& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version

Windows 제어판

Windows 제어판에서 설치된 EC2Launch v2 버전을 다음과 같이 확인하세요.

  1. AMI에서 인스턴스를 시작하고 연결하세요.
  2. Windows 제어판을 열고 Programs and Features를 선택하세요.
  3. 설치된 프로그램 목록에서 Amazon EC2Launch를 찾으세요. 버전 번호가 Version 열에 나타나요.

AWS Windows AMI의 최신 업데이트를 보려면 AWS Windows AMI Reference의 'Windows AMI version history'를 참고하세요. EC2Launch v2 최신 버전은 'EC2Launch v2 version history'를 참고하세요. 새 버전의 EC2Launch v2 서비스가 출시되면 알림을 받을 수 있어요. 자세한 내용은 'EC2 Windows 시작 에이전트 알림 구독하기'를 참고하세요.

더 알아보기 (Learn more)