대기 중 상태로 멈춘 AppStream 2.0 Image Builder의 문제를 해결하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2020년 6월 30일

Amazon AppStream 2.0 Image Builder를 시작하려고 하면 상태가 대기 중으로 멈추고 실행 중으로 바뀌지 않습니다. 이 문제를 해결하려면 어떻게 해야 합니까? 

해결 방법

이미지 빌더와 플릿 인스턴스가 사용할 수 있게 되고 실행 중 상태로 바뀌는 데 최대 25분이 걸릴 수 있습니다. 25분이 지나도 이미지 빌더가 아직 대기 중 상태인 경우 다음에서 설명하는 일반적인 원인과 문제 해결 단계를 참조하십시오.

탄력적 네트워크 인터페이스가 삭제 또는 분리됨

네트워크 인터페이스가 없으면 이미지 빌더가 시작 워크플로를 완료하지 못해 대기 중 상태로 멈출 수 있습니다.

네트워크 인터페이스의 상태를 확인하려면 Amazon Elastic Compute Cloud(Amazon EC2) 콘솔을 연 다음 탐색 창에서 [네트워크 인터페이스]를 선택합니다. 또는 AWS 명령줄 인터페이스(CLI)에서 다음 명령을 입력해도 됩니다.

aws ec2 describe-network-interfaces --filters 'Name=description,Values="AppStream 2.0 - image-builder:*'

네트워크 인터페이스가 없거나 분리된 경우 마지막 작업 이미지 또는 AWS에서 제공한 기본 이미지에서 새 이미지 빌더를 시작합니다.

참고: AWS CloudTrail 로그에서 eventTime, userIdentity 등 네트워크 인터페이스 삭제 또는 분리와 관련한 이벤트 세부 정보가 있는지 확인할 수 있습니다.

디바이스 드라이버가 충돌하거나 잘못됨

이미지 빌더는 필요한 모든 드라이버가 사전 설치된 상태로 제공됩니다. 사용자가 충돌하거나 잘못된 드라이버를 설치할 경우 이미지 빌더가 대기 중 상태로 멈출 수 있습니다.

이미지 빌더에 연결할 수 없으므로 충돌하거나 잘못된 드라이버를 제거할 수 없습니다. 이 문제를 해결하려면 최근 사용자 지정 이미지 또는 Amazon에서 제공한 기본 이미지에서 새 이미지 빌더를 시작합니다.

네트워크 인터페이스 한도

Amazon Web Services(AWS) 계정이 해당 리전의 네트워크 인터페이스 한도에 도달했을 수 있습니다. 이 한도에 대한 자세한 내용은 한도 증대를 요청하는 방법은 Amazon VPC 할당량을 참조하십시오.

Sysprep 응답 파일 사용자 지정 문제

sysprep 무인 설치 응답 파일을 사용자 지정하지 않는 것이 좋습니다. 잘못 사용자 지정할 경우 이미지 빌더가 올바르게 부팅되지 않고 시작 화면에서 멈추도록 하여 Windows 시작 프로세스를 방해할 수 있습니다.

이 문제를 해결하려면 최근 사용자 지정 이미지 또는 Amazon에서 제공한 기본 이미지에서 새 이미지 빌더를 시작합니다.

IPv6가 비활성화됨

IPv6가 비활성화된 상태로 이미지를 생성하면 이미지 빌더가 대기 중 상태로 멈춥니다. 이 문제를 해결하려면 최근 사용자 지정 이미지 또는 Amazon에서 제공한 기본 이미지에서 새 이미지 빌더를 시작합니다.

기본 이미지 호환성

Graphics Design(AMD) 기본 이미지를 사용하여 새 Graphics Pro(NVIDIA) 이미지 빌더를 시작하거나 그 반대의 경우가 아닌지 확인합니다. 자세한 내용은 AppStream 2.0 기본 이미지 버전 기록을 참조하십시오.

포트 가용성

다음 포트를 사용하여 설치된 애플리케이션이 없는지 확인합니다.

  • 스트리밍 연결을 설정하기 위한 포트 8300의 인바운드 TCP
  • AppStream 2.0을 통한 스트리밍 인스턴스 관리를 위한 포트 8000 및 8443의 인바운드 TCP

자세한 내용은 관리 네트워크 인터페이스 IP 주소 범위 및 포트를 참조하십시오.

바이러스 백신 소프트웨어 예외

바이러스 백신 소프트웨어는 이미지 빌더에 필요한 파일과 포트를 차단할 수 있습니다. 다음 폴더 경로에 예외를 추가해보십시오.

  • %PROGRAMFILES%\Amazon\*
  • %PROGRAMFILES%\NICE\*
  • %PROGRAMFILES%\nodejs\*
  • %PROGRAMFILES%\Internet Explorer\*
  • C:\Windows\*

위의 폴더 경로는 다음 서비스에 해당합니다.

  • AWSLiteAgent
  • AmazonSSMAgent
  • Ec2Config
  • PhotonAgent
  • PhotonAgentWebServer(포트 8443에서 수신)
  • DcvServer(포트 8300에서 수신)
  • QWAVE

시스템 환경 변수로서의 AWS 명령줄 인터페이스(AWS CLI) 자격 증명

AWS CLI 자격 증명을 시스템 환경 변수로 설정하면 AppStream 2.0이 이미지를 생성하지 못할 수 있습니다. 플릿 인스턴스 전체에서 시스템 환경 변수를 변경하는 방법에 대한 지침은 시스템 환경 변수 변경을 참조하십시오.

기본 언어가 지원되지 않는 언어로 변경됨

표시 언어를 비롯하여 AppStream 2.0 스트리밍 세션의 기본 리전 설정을 구성할 수 있습니다. 기본 언어를 지원되지 않는 언어로 변경하면 이미지 빌더가 대기 상태로 멈춥니다. AppStream 2.0에서 현재 지원하는 언어를 보려면 기본 표시 언어 지정을 참조하십시오.

알림 코드(도메인에 조인된 이미지 빌더)

알림을 보려면 AppStream 2.0 콘솔을 열고 탐색 창에서 [이미지]를 선택합니다. [이미지 빌더] 탭에서 이미지 빌더를 선택한 다음 [알림] 탭을 선택합니다. 자세한 내용은 알림 코드 문제 해결을 참조하십시오.

  • DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN
    이미지 빌더 인스턴스가 Active Directory 도메인에 접속할 수 없습니다. 이로 인해 이미지 빌더가 시작 워크플로를 완료하지 못합니다. 네트워크 연결을 보장하려면 VPC, 서브넷 및 보안 그룹 설정을 확인합니다. VPC의 [DHCP 옵션 세트] 섹션에서 VPC DNS 서버가 올바르게 구성되어 있는지 확인합니다. 도메인 이름 서버는 일반적으로 도메인을 제어하는 도메인 컨트롤러 또는 DNS 서버의 IP 주소로 설정됩니다. 자세한 내용은 DHCP 옵션 세트를 참조하십시오.
  • DOMAIN_JOIN_ERROR_FILE_NOT_FOUND
    OU(조직 단위) 고유 이름이 잘못되었습니다. AppStream 2.0 컴퓨터 객체는 조직 단위에 배치해야 하며 고유 이름은 OU=로 시작해야 합니다. 자세한 내용은 조직 단위 고유 이름 찾기를 참조하십시오.

방화벽 및 네트워크 구성(도메인에 조인된 이미지 빌더)

AppStream 2.0 콘솔을 사용하여 이미지 빌더에 Directory Config 객체를 추가하기 전에 방화벽 및 네트워크 구성이 올바른지 확인합니다. 다음 단계를 따르십시오.

1.    이미지 빌더에서 PowerShell 창을 열고 다음 명령을 실행합니다.

Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 389 -InformationLevel "Detailed"
Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 88 -InformationLevel "Detailed"
Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 53 -InformationLevel "Detailed"

2.    각 명령의 출력에서 TcpTestSucceeded가 True인지 확인합니다. 이는 도메인에 조인하는 데 필요한 포트에 연결할 수 있음을 나타냅니다. 자세한 내용은 Test-NetConnection을 참조하십시오.

3.    동일한 PowerShell 창에서 Resolve-DnsName 명령을 실행하여 도메인 이름이 조회되는지 확인합니다.

Resolve-DnsName -Name yourdomain.exampleco.com

또는 Microsoft PortQryUI 도구를 다운로드하고 실행하여 필요한 모든 포트를 검증합니다.

새 컴퓨터 객체가 생성되지 않음(도메인에 조인된 이미지 빌더)

Active Directory에서 새 컴퓨터 객체가 올바른 OU(조직 단위)에 생성되었는지 확인합니다.

새 객체가 있는 경우 이미지 빌더 인스턴스를 곧 사용할 수 있습니다.

컴퓨터 객체가 생성되지 않으면 이미지 빌더가 대기 중 상태로 멈춥니다. 이 문제를 해결하려면 먼저 필요한 서비스 계정 권한이 모두 부여되었는지 확인합니다. 그런 다음 AppStream 2.0 Directory Config 객체의 다음 디렉터리 구성 세부 정보가 올바른지 확인합니다.

  • 디렉터리 이름(디렉터리의 정규화된 도메인 이름)
  • 서비스 계정 사용자 이름 및 암호
  • OU(조직 단위) 고유 이름

이 문서가 도움이 되었습니까?

AWS에서 개선해야 할 부분이 있습니까?


도움이 필요하십니까?