如何排查卡在待处理状态的 AppStream 2.0 映像生成器问题?

上次更新日期:2022 年 8 月 3 日

当我尝试启动 Amazon AppStream 2.0 映像生成器时,状态停留在“待处理”状态,且不能更改为“正在运行”。如何修复此问题?

解决方法

注意:如果您在运行 AWS 命令行界面(AWS CLI)命令时收到错误,请确保您使用的是最新版本的 AWS CLI

映像生成器和实例集实例最多需要 25 分钟才能可用并变成“正在运行”状态。如果您的映像生成器在 25 分钟后仍处于“待处理”状态,请参阅以下常见原因和问题排查步骤。

弹性网络接口被删除或分离

缺少网络接口可能会使映像生成器无法完成启动工作流,从而使状态卡在待处理状态。

要验证您的网络接口的状态,请打开 Amazon Elastic Compute Cloud (Amazon EC2) 控制台,然后选择 Network Interfaces (网络接口)。或者,要使用 AWS CLI,请输入以下命令:

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

如果网络接口缺少或分离,请从上一个工作映像启动一个新的映像生成器。或者,使用 AWS 提供的基础映像。

注意:您可以检查 AWS CloudTrail 日志中是否有与网络接口删除或分离相关的事件详细信息,包括 eventTime 和 userIdentity。

使用 AppX 软件包的应用程序

使用 AppX 软件包的应用程序(比如 Adobe Creative Cloud)可能会导致 sysprep 失败,映像生成器卡在待处理状态。

在完成映像创建过程的最后一步之前,以管理员身份在 PowerShell 中运行以下命令。

要获取设备上 AppX 软件包的列表,请输入以下命令:

Get-AppxPackage | select Name, PackageFullName

要删除特定的 AppX 软件包,请输入以下命令。将 AppXpackageName 替换为您要删除的软件包,如上一个命令的输出中所列:

Get-AppxPackage -AllUsers -Name AppXpackageName | Remove-AppxPackage -AllUsers

注意:映像生成器必须运行 Server 2019。-AllUsers 参数是在版本 1709 中添加的。映像生成器中的 Server 2016 在版本 1607 上运行,并返回带有 -AllUsers 参数的错误。

有关更多信息,请参阅 Microsoft 网站上的 Get-AppxPackage

设备驱动程序冲突或不正确

映像生成器预安装了所有必要的驱动程序。如果用户安装冲突或不正确的驱动程序,映像生成器可能会停留在“待处理”状态。

由于映像生成器无法到达,无法卸载冲突或不正确的驱动程序。要修复这一问题,请从最近的自定义映像中或者使用 Amazon 提供的其中一个基础映像启动新的映像生成器

网络接口限制

您的 AWS 账户可能已达到该区域的网络接口限制。有关限制和如何请求增加数量的更多信息,请参阅 Amazon VPC 限额

Sysprep 答案文件自定义问题

最佳实践是不自定义 sysprep Unattend 答案文件。不正确的自定义可能会阻止映像生成器正确启动并卡在欢迎屏幕上,从而干扰 Windows 启动过程。

要修复这一问题,请从最近的自定义映像中或者使用 Amazon 提供的其中一个基础映像启动新的映像生成器

IPv6 已关闭

如果您在关闭 IPv6 的情况下创建映像,映像生成器将停留在“待处理”状态。要修复这一问题,请从最近的自定义映像中或者使用 Amazon 提供的其中一个基础映像启动新的映像生成器

端口可用性

确认没有使用以下端口安装任何应用程序:

  • 端口 8300 上的入站 TCP,用于建立流式处理连接。
  • 端口 8000 和 8443 上的入站 TCP,用于通过 AppStream 2.0 管理流式处理实例。

有关更多信息,请参阅管理网络接口 IP 地址范围和端口

要允许访问 Amazon EC2 元数据服务,所有流实例都要求端口 80 (HTTP) 对 IP 地址 169.254.169.254 开放。如果配置了代理,该代理必须排除 169.254.169.254。有关详细信息,请参阅客户网络接口端口

杀毒软件异常

杀毒软件可以阻止映像生成器需要的文件和端口。考虑在以下文件夹路径中添加异常情况:

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

这些文件夹路径与以下服务相对应:

  • AWSLiteAgent
  • AmazonSSMAgent
  • Ec2Config
  • PhotonAgent
  • PhotonAgentWebServer(侦听端口 8443)
  • DcvServer(侦听端口 8300)
  • QWAVE

AWS CLI 凭证作为系统环境变量

将 AWS CLI 凭证设置为系统环境变量可以防止 AppStream 2.0 创建映像。有关更改您的队列实例间的系统环境变量的说明,请参阅更改系统环境变量

默认语言被更改为不受支持的语言

您可以为您的 AppStream 2.0 流式处理会话配置默认的区域设置,包括显示语言。如果您将默认语言更改为不支持的语言,映像生成器将卡在“待处理”状态。要查看 AppStream 2.0 目前支持的语言,请参阅指定默认显示语言

已删除或重命名本地管理员账户

AppStream 2.0 不支持重命名或删除本地管理员账户。如果重命名或删除此账户,映像创建将会失败。

对于加入域的映像生成器,如果组策略已停用、删除或重命名本地管理员账户,则可以更新组策略对象 (GPO)。

如果 GPO 未更新本地管理员账户,则从最近的自定义映像启动新的映像生成器。或者,使用 Amazon 提供的基础映像。

通知代码(加入域的映像生成器)

要查看通知,请打开 AppStream 2.0 控制台,然后从导航窗格中选择 Images (映像)。从 Image Builder (映像生成器) 选项卡中,选择您的映像生成器,然后选择 Notifications (通知) 选项卡。有关更多信息,请参阅通知代码问题排查

  • 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 控制台在您的映像生成器中添加目录配置对象之前,确认防火墙和网络配置正确。然后执行以下步骤。

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。这表示您可以达到所需的端口来加入域。有关详细信息,请参阅 Microsoft 网站上的 Test-NetConnection

3.    从相同的 PowerShell 窗口中,运行 Resolve-DnsName 命令以确认您可以查找域名:

Resolve-DnsName -Name yourdomain.exampleco.com

或者,下载并运行 Microsoft PortQryUI 工具以验证所有需要的端口。

新的计算机对象未创建(加入域的映像生成器)

在 Active Directory 中,验证是否已在正确的组织单位(OU)中创建了新的计算机对象。

如果有新对象,则映像生成器实例很快将可用。

如果计算机对象未创建,则映像生成器将停留在“待处理”状态。要排查此问题,请先确认已授予所有必需的服务账户权限。然后,验证 AppStream 2.0 Directory Config 对象中的以下目录配置详细信息正确:

  • 目录名称(目录的完全限定域名)
  • 服务账户用户名和密码
  • 组织单位(OU)识别名