최신 버전의 EC2Config 설치

최신 버전의 EC2Config 설치

참고 — Windows Server 2022 이상 운영 체제 버전의 최신 시작 에이전트는 EC2Config와 EC2Launch를 모두 대체하는 EC2Launch v2예요. EC2Launch v2는 AWS Windows Server 2022 및 2025 AMI에 사전 설치되어 있습니다. Windows Server 2016과 2019에는 에이전트를 수동으로 설치·구성할 수도 있어요. 자세한 내용은 "EC2Launch v2 설치"를 참고하세요.

출처: 문서

본문

EC2Config 업데이트 알림을 받는 방법은 "EC2 Windows 시작 에이전트 알림 구독"을, 각 버전의 변경 사항은 "EC2Config 버전 이력"을 참고하세요.

시작하기 전에

  • .NET Framework 3.5 SP1 이상이 설치되어 있는지 확인하세요.
  • 기본적으로 Setup은 설치 중에 설정 파일을 기본 설정 파일로 대체하고 설치가 완료되면 EC2Config 서비스를 재시작해요. EC2Config 서비스 설정을 변경했다면 %Program Files%\Amazon\Ec2ConfigService\Settings 디렉터리에서 config.xml 파일을 복사해 두세요. EC2Config 서비스를 업데이트한 뒤 이 파일을 복원해 구성 변경 사항을 유지할 수 있어요.

EC2Config 버전 확인

인스턴스에 설치된 EC2Config 버전을 확인하려면:

  1. AMI에서 인스턴스를 시작하고 연결합니다.
  2. Control Panel에서 Programs and Features를 선택합니다.
  3. 설치된 프로그램 목록에서 Ec2ConfigService를 찾습니다. 해당 버전 번호가 Version 열에 표시됩니다.

EC2Config 업데이트

인스턴스에 최신 버전의 EC2Config를 다운로드·설치하려면:

  1. EC2Config 설치 프로그램을 다운로드해 압축을 풉니다.
  2. EC2Install.exe를 실행합니다. 전체 옵션 목록은 /? 옵션으로 EC2Install을 실행해 보세요. 기본적으로 설치 프로그램은 프롬프트를 표시합니다. 프롬프트 없이 실행하려면 /quiet 옵션을 사용합니다.

    중요 — 저장해 둔 config.xml 파일의 사용자 지정 설정을 유지하려면 /norestart 옵션으로 EC2Install을 실행하고 설정을 복원한 뒤 EC2Config 서비스를 수동으로 재시작하세요.

  3. EC2Config 버전 4.0 이상을 실행 중이라면 Microsoft Services 스냅인에서 인스턴스의 SSM Agent를 재시작해야 해요.

참고 — 업데이트된 EC2Config 버전 정보는 인스턴스를 재부팅하거나 중지 후 시작하기 전까지 인스턴스 System Log나 Trusted Advisor 검사에 나타나지 않아요.

PowerShell로 최신 EC2Config 다운로드·설치 — PowerShell 창에서 다음 명령을 실행합니다.

$Url = "https://s3.amazonaws.com/ec2-downloads-windows/EC2Config/EC2Install.zip"
$DownloadZipFile = "$env:USERPROFILE\Desktop\" + $(Split-Path -Path $Url -Leaf)
$ExtractPath = "$env:USERPROFILE\Desktop\"
Invoke-WebRequest -Uri $Url -OutFile $DownloadZipFile
$ExtractShell = New-Object -ComObject Shell.Application 
$ExtractFiles = $ExtractShell.Namespace($DownloadZipFile).Items() 
$ExtractShell.NameSpace($ExtractPath).CopyHere($ExtractFiles) 
Start-Process $ExtractPath
Start-Process `
    -FilePath $env:USERPROFILE\Desktop\EC2Install.exe `
    -ArgumentList "/S"

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

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

설치는 C:\Program Files\Amazon\에서 Ec2ConfigService 디렉터리를 확인해 검증합니다.

더 알아보기 (Learn more)