导入图片

您可以通过导入自定义镜像来创建 WorkSpaces 应用程序镜像 EC2 AMIs。下面将介绍操作方式：

使用任何首选方法（包括 Im EC2 age Builder）自定义您的 EC2 AMI。
将您的自定义 AMI 导入 WorkSpaces 应用程序以创建 WorkSpaces 应用程序映像
或者，也可以使用 Image Builder 进行其他图像自定义

通过 AMI 导入创建的图像为type = "custom"，而 WorkSpaces 应用程序提供的图像则为type = "native"。

您可以将 stream.* 实例类型用于映像。type = "native"要使用以下任一实例类型，您必须导入您的 AMI 并使用创建映像type = "custom"。

GeneralPurpose.*
MemoryOptimized.*
ComputeOptimized.*
加速。 *

图像导入的先决条件

所有这些先决条件对于成功执行工作流程都很重要。下面列出了支持的 AMI 配置和其他强制性要求。

必需的 AMI 属性

EBS

小于或等于 500GB 的大小
- 您可以导入容量小于 200 GB 的 AMI，但是，导入的映像将至少使用 200GB。
GP2
- 您可以导入具有 gp2 或 gp3 EBS 卷类型的 AMI，但是，导入的映像将使用 gp2。
每张图像一卷
/dev/sda1根设备名称

图像类型：机器
架构：x86_64
虚拟化类型：HVM
启动模式：UEFI
TPM Support：v2.0。这是必需的，请参阅-https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/amiwindows-tpm.html# 查找启用 TPM ami-windows-tpm-find 的 AMI。
ENA Support：没错
平台：Windows
平台详情：Windows

操作系统属性

Windows Server 2022/2025 全基版

不支持 Windows 服务器核心
不支持带有 SQL Server 的 Windows

座席

EC2 启动 V2 版本 >= 2.1.1
需要 SSM 代理

驱动程序

EC2 ENA 驱动程序版本 >= 2.9.0
EC2 NVMe 驱动程序版本 >= 1.6.0

图书馆 Support

.NET 框架 4.8 或更高版本
- 默认安装在 Windows Server 2022/2025 中
PowerShell 5.1 或更高版本
- 默认安装在 Windows Server 2022/2025 中

Windows 功能：不得安装远程桌面服务许可和远程桌面服务会话主机
端口：端口 8000、8300 和 8443 必须处于解锁状态且未被占用
启动模式：UEFI

如果你想将图像用于图形实例，例如加速.g4dn、accelated.g5、Accelated.G6 或加速.g6e，则需要在你的 AMI 上安装适当的 GRID 驱动程序。欲了解更多详情，请参阅 https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html。如果驱动程序设置不正确，则可以进行流式传输，但是，显卡可能不可用。

重要

AMI 的 “所有者账户 ID” 必须是您的AWS账户 ID。您无法导入公有 EC2 AMI。

在导入图像之前，请执行任何 Windows 更新并禁用 Windows 自动更新。

目前 EC2 AMIs 不支持加密导入

IAM 角色要求

重要

“创建具有以下权限的 IAM 角色以用于图像导入：


{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}

为此 IAM 角色添加以下信任关系


{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}

导入图像

在 https://console.aws.amazon.com/appst WorkSpaces ream2 上打开应用程序控制台。
在左侧导航窗格中，选择 “图像”，然后选择 “图像注册表”。
选择 “导入图像”。
AMI ID-输入要导入到 WorkSpaces 应用程序的 AMI ID。您也可以使用此字段搜索您的 AMI。
图像名称-为因导入操作而创建的图像输入唯一名称。
显示名称（可选）-输入要为图像显示的。
描述（可选）-输入图像的描述。
IAM 角色-选择您为映像导入创建的 IAM 角色。有关更多详细信息，请参阅IAM 角色要求。
管理 WorkSpaces 应用程序代理-如果您想始终使用最新的 WorkSpaces 应用程序代理版本，请选择此选项，您的流式处理实例将自动使用新代理版本发布AWS时提供的最新功能、性能改进和安全更新进行更新。
运行时验证（可选）：选择此选项，服务将使用正在导入的图像预配置实例并运行流式测试。
- 注意
  这些流式传输测试将在后台执行，您无法通过 WorkSpaces 应用程序客户端连接到此实例。
- 我们建议您使用此选项来更确信您的图像适用于 WorkSpaces 应用程序。
- 您将按该实例的小时价格计费。
- 如果您在进行可能不会影响流式传输测试的细微更改后重新导入 AMI，并且如果上次通过运行时验证，则您导入了此 AMI，则可以避免运行时验证。
- 选择实例类型（可选）：为运行流式测试选择正确的实例系列、类型和大小。建议您使用计划用于创建队列的相同实例。
应用程序目录和启动性能清单（可选）：提供详细信息，以便为最终用户创建应用程序目录并提高应用程序的启动性能。
- 应用程序目录：要创建应用程序目录，请指定有关安装您的映像的应用程序的详细信息。对于您计划流式传输的每个应用程序，可以指定名称、显示名称、要启动的可执行文件和要显示的图标。
- 启动性能：向应用程序优化清单中添加文件可缩短应用程序在新队列实例上首次启动所需的时间。优化清单是每个应用程序的行分隔文本文件。
要了解更多信息，请参阅应用程序详情。
标签（可选）-选择 “添加标签”，然后键入标签的键和值。要添加更多标签，请重复此步骤。有关更多信息，请参阅标记您的 Amazon WorkSpaces 应用程序资源。
导入图像-查看您输入的所有信息，然后选择导入图像。服务将运行兼容性检查，以确保 AMI 与 WorkSpaces 应用程序兼容。
- 如果静态检查失败，您将立即收到错误消息。
- 如果静态检查通过，则您的导入请求将被提交，根据您选择的选项，创建新的 WorkSpaces 应用程序映像可能需要 30-60 分钟 type = "custom"

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

在映像生成器上使用托管映像更新为随附许可证的应用程序启用更新功能

应用程序详情