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

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

EC2Launch는 Windows Server 2016 및 2019 AMI에서 EC2Config 서비스를 대체한 Windows PowerShell 스크립트 세트입니다. 이러한 AMI 중 다수는 여전히 사용할 수 있습니다. EC2Launch v2는 지원되는 모든 Windows 버전에 대한 최신 시작 에이전트이며, EC2Config와 EC2Launch를 모두 대체합니다. 자세한 내용은 EC2Launch v2 에이전트를 사용하여 EC2 Windows 인스턴스 시작 중 태스크 수행 단원을 참조하십시오.

참고

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 콘솔에 전송합니다.

Windows Server 2019에 대한 자세한 내용은 Microsoft.com에서 Windows Server 버전별 기능 비교를 참조하세요.

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에 대한 더 많은 주제