EC2Launch v1 에이전트를 사용하여 EC2 Windows 인스턴스 시작 중 태스크 수행 - Amazon Elastic Compute Cloud
EC2Launch 작업EC2Launch 디렉터리 구조원격 측정

EC2Launch v1 에이전트를 사용하여 EC2 Windows 인스턴스 시작 중 태스크 수행

Windows Server 2016 및 2019용 Amazon 관리형 AMI에는 EC2Launch라는 Windows Powershell 스크립트 세트가 포함되어 있습니다. EC2Launch는 초기 인스턴스 부팅 중에 작업을 수행합니다. AWS Windows AMI에 포함된 EC2Launch 버전에 대한 자세한 내용은 AWS Windows AMI 참조를 참조하세요.

참고

Windows Server 2016 이상 운영 체제용 최신 시작 에이전트는 EC2Config와 EC2Launch를 모두 대체하며 AWS Windows Server 2016 및 2019 AMI에 EC2LaunchV2-Windows_Server-*로 시작하는 이름으로 사전 설치되어 제공됩니다. 마이그레이션 도구를 사용하여 EC2Launch v2로 마이그레이션하거나, Windows Server 2016 및 2019에 에이전트를 수동으로 설치하고 구성할 수도 있습니다.

IMDSv2에서 EC2Launch를 사용하려면 버전이 1.3.2002730 이상이어야 합니다.

다음 Windows PowerShell 명령을 사용하여 설치된 EC2Launch 버전을 확인할 수 있습니다.

Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version

EC2Launch 작업

EC2Launch는 초기 인스턴스 부팅 중에 기본적으로 다음 작업을 수행합니다.

  • 인스턴스에 대한 정보를 렌더링하는 새로운 월페이퍼(wallpaper)를 설정합니다.

  • 컴퓨터 이름을 인스턴스의 프라이빗 IPv4 주소로 설정합니다.

  • 인스턴스 정보를 Amazon EC2 콘솔에 전송합니다.

  • RDP 인증서 지문을 EC2 콘솔에 전송합니다.

  • 관리자 계정에 대한 무작위 암호를 설정합니다.

  • DNS 접미사를 추가합니다.

  • 분할되지 않은 공간을 포함하도록 운영 체제 파티션을 동적으로 확장합니다.

  • 사용자 데이터를 실행합니다(지정된 경우). 사용자 데이터 지정에 대한 자세한 내용은 사용자 데이터 입력을 사용하여 EC2 인스턴스를 시작할 때 명령 실행 섹션을 참조하세요.

  • 영구 정적 경로를 설정하여 메타데이터 서비스 및 AWS KMS 서버에 도달합니다.

    중요

    사용자 지정 AMI를 이 인스턴스에서 생성한 경우 이 경로는 OS 구성의 일부로서 캡처되며 AMI에서 시작한 새로운 인스턴스는 서브넷 배치와 상관없이 동일한 경로를 유지합니다. 경로를 업데이트하려면 사용자 지정 AMI 시작 시 Server 2016 이후에 대한 메타데이터/KMS 경로 업데이트 섹션을 참조하세요.

다음 작업은 EC2Config 서비스와 역방향 호환성을 유지하는 데 도움이 됩니다. 스타트업 중에 이러한 작업을 수행하도록 EC2Launch를 구성할 수도 있습니다.

  • 둘째 EBS 볼륨을 초기화합니다.

  • Windows Event 로그를 EC2 콘솔 로그에 전송합니다.

  • Windows is ready to use 메시지를 EC2 콘솔에 전송합니다.

EC2Launch 디렉터리 구조

EC2Launch는 기본적으로 루트 디렉터리 C:\ProgramData\Amazon\EC2-Windows\Launch의 Windows Server 2016 이후 AMI에 설치됩니다.

참고

기본적으로 Windows는 파일과 폴더를 C:\ProgramData 아래에 숨깁니다. EC2Launch 디렉터리와 파일을 보려면 Windows 탐색기에 경로를 입력하거나 숨겨진 파일과 폴더를 표시하도록 폴더 속성을 변경해야 합니다.

Launch 디렉터리에는 다음 하위 디렉터리가 포함됩니다.

  • Scripts - EC2Launch를 구성하는 PowerShell 스크립트가 포함됩니다.

  • Module - Amazon EC2와 관련된 스크립트를 빌드하기 위한 모듈이 포함됩니다.

  • Config - 사용자가 사용자 지정할 수 있는 스크립트 구성 파일이 포함됩니다.

  • Sysprep - Sysprep 리소스가 포함됩니다.

  • Settings - Sysprep 그래픽 사용자 인터페이스용 애플리케이션이 포함됩니다.

  • Library - EC2 시작 에이전트용 공유 라이브러리를 포함합니다.

  • Logs - 스크립트가 생성하는 로그 파일이 포함됩니다.

원격 측정

원격 측정 데이터는 AWS가 사용자의 요구 사항을 더 잘 이해하고, 문제를 진단하고, AWS 서비스의 경험을 개선할 기능을 제공하는 데 도움이 되는 추가 정보입니다.

EC2Launch 버전 1.3.2003498 이상은 사용량 지표 및 오류와 같은 원격 측정 데이터를 수집합니다. 이 데이터는 EC2Launch가 실행되는 Amazon EC2 인스턴스에서 수집됩니다. 여기에는 AWS가 소유한 모든 Windows AMI가 포함됩니다.

EC2Launch에서 수집되는 원격 측정 데이터의 유형은 다음과 같습니다.

  • 사용량 정보 - 에이전트 명령, 설치 방법 및 예약된 실행 빈도입니다.

  • 오류 및 진단 정보 - 에이전트 설치 및 실행 오류 코드입니다.

수집되는 데이터의 예:

2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0

원격 측정은 기본적으로 활성화됩니다. 언제든지 원격 측정 데이터 수집을 비활성화할 수 있습니다. 원격 측정이 활성화되면 EC2Launch는 별도로 고객에게 알리지 않고 원격 측정 데이터를 전송합니다.

원격 분석을 사용하거나 비활성화하는 선택 사항이 수집됩니다.

원격 측정 수집을 옵트인 또는 옵트아웃할 수 있습니다. 원격 측정 옵션을 준수하기 위해 원격 측정 옵트인 또는 옵트아웃 선택이 수집됩니다.

원격 측정 가시성

원격 측정이 활성화되면 Amazon EC2 콘솔 출력에 다음과 같이 표시됩니다.

2021/07/15 21:44:12Z: Telemetry: <Data>
인스턴스의 원격 측정 비활성화

시스템 환경 변수를 설정하여 원격 측정을 비활성화하려면 관리자로 다음 명령을 실행합니다.

setx /M EC2LAUNCH_TELEMETRY 0

설치 중 원격 측정을 비활성화하려면 다음과 같이 install.ps1을 실행합니다.

. .\install.ps1 -EnableTelemetry:$false
EC2Launch에 대한 더 많은 주제