你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
为 Dev Box 团队自定义项配置映像
使用自定义文件，可以简化团队创建开发箱的过程。 使用开发箱自定义项，你可以通过创建“映像定义”文件创建共享团队自定义项。 从这个映像定义创建可重用映像，可以优化自定义，并节省开发箱的创建时间。 本文介绍如何配置池以使用映像定义，并为开发团队生成可重用映像。
若要为 Microsoft Dev Box 团队自定义项配置映像，请启用项目级目录，并为相应项目配置目录同步设置。 然后，将包含定义文件的目录附加到项目，配置开发箱池以使用映像定义，并验证自定义是否适用于新的开发箱。 当自定义正确应用后，你可以选择生成一个可重用的映像，从而加速创建新开发箱。
重要
Dev Box 团队自定义项目前以预览版提供。 有关预览版状态的详细信息，请参阅 Microsoft Azure 预览版的补充使用条款。 该文档定义了适用于 beta 版、预览版或未正式发布版 Azure 功能的法律术语。
先决条件
如果要完成本文中的步骤，需要：
- 具有现有开发箱定义和网络连接的开发人员中心。 如果没有开发人员中心，请按照快速入门：配置 Microsoft Dev Box 中的步骤进行创建。
- 要用于创建开发箱的团队自定义文件。 如果没有自定义文件，请参阅为开发箱编写自定义文件。
配置自定义所需的权限
若要执行所需的操作来为开发箱创建和应用自定义项，需要拥有以下权限：
| 操作 | 权限/角色 |
|---|---|
| 为开发人员中心启用项目级目录。 | 对订阅拥有写入访问权限的平台工程师。 |
| 为项目启用目录同步设置。 | 对订阅拥有写入访问权限的平台工程师。 |
| 将目录附加到项目中。 | 项目的项目管理员或参与者权限。 |
| 创建自定义文件。 | 未指定任何内容。 任何人都可以创建自定义文件。 |
| 在开发箱创建过程中，使用开发人员门户上传和应用 YAML 文件。 | Dev Box 用户。 |
| 将任务添加到目录。 | 添加到托管目录的存储库的权限。 |
若要管理开发箱池，需要以下权限：
| 操作 | 权限 |
|---|---|
| 创建、删除或更新开发箱池。 | - 对 Azure 订阅或特定资源组的所有者或参与者权限。 - 项目的 DevCenter 项目管理员权限。 |
启用项目级目录
若要将目录附加到项目，必须启用项目级目录。 有关详细信息，请参阅配置项目级目录。
为项目配置目录同步设置
将项目配置为从目录中同步映像定义。 通过此设置，可以使用目录中的映像定义来创建开发箱池。
登录到 Azure 门户。
在搜索框中输入“项目”。 在结果列表中，选择“项目”。
打开要为其配置目录同步设置的 Dev Box 项目。
选择 Catalogs。
选择“同步设置”。
在“同步设置”窗格中，选择“映像定义”，然后选择“保存”。
附加包含定义文件的目录
必须先将包含定义文件的目录附加到开发人员中心或项目，然后才能使用自定义文件作为映像定义。 目录可以来自 GitHub 或 Azure Repos。
“映像定义”窗格列出了项目可以访问的映像定义。
有关附加目录的详细信息，请参阅在 GitHub 或 Azure Repos 中添加和配置目录。
将开发箱池配置为使用映像定义
通过将开发箱池配置为使用自定义文件 (imagedefinition.yaml)，使自定义可供开发团队使用。 将自定义文件存储在链接到开发人员中心或项目中目录的存储库中。 将此文件指定为池的映像定义，自定义将应用于新的开发箱。
下面的步骤展示了如何创建开发箱池并指定映像定义：
登录到 Azure 门户。
在搜索框中输入“项目”。 在结果列表中，选择“项目”。
打开要与新开发箱池关联的 Dev Box 项目。
选择“开发箱池”，然后选择“创建”。
在“创建开发箱池”页上，输入以下值：
设置 值 名称 输入池的名称。 开发人员在创建开发箱时，池名称对它们可见且可选。 名称在项目中必须唯一。 定义 该框列出了可访问目录中的映像定义以及开发箱定义。 选择映像定义文件。 网络连接 选择“部署到 Microsoft 托管的网络”，或使用现有网络连接。 启用单一登录 选择“是”，为此池中的开发箱启用单一登录。 必须为组织配置单一登录。 有关详细信息，请参阅为开发箱启用单一登录。 Dev Box 创建者特权 选择“本地管理员”或“标准用户”。 启用自动停止 默认值为“是”。 选择“否”可禁用自动停止计划。 可以在创建池后配置自动停止计划。 停止时间 选择关闭池中所有开发箱的时间。 时区 选择停止时间的时区。 许可 选中此复选框即表示确认组织具有要应用于此池中的开发箱的 Azure 混合权益许可证。 
选择“创建”。
验证新的开发箱池是否显示在列表中。 可能需要刷新屏幕。
使用开发人员门户创建开发箱
若要验证是否应用了映像定义文件中的自定义，请在 Microsoft Dev Box 开发人员门户中创建一个开发箱。 请按照快速入门：使用 Microsoft Dev Box 开发人员门户创建并连接到开发箱中的步骤操作。 然后连接到新创建的开发箱，并验证自定义项是否按预期工作。
可以对自定义文件进行调整，并创建新的开发箱来测试更改。 如果自定义正确无误，则可以生成可重用映像。
生成可重用映像
若要优化自定义项并为团队创建可重用映像，可以使用以下步骤基于自定义文件生成映像。 此映像适用于从池创建的所有开发箱。 DevCenter 服务在后台创建 Dev Box 来创建映像，并将映像导出到 DevCenter 服务管理的资源组中的 Azure Compute Gallery。 若要生成映像，你需要为 DevCenter 服务分配发布映像所需的角色。 转到 Azure 门户，然后选择“资源组”。 使用名称“DevCenter(你的项目名称)(一个随机 ID)”搜索托管资源组。 在该资源组下，导航到“访问控制”，并为 Windows 365 应用程序提供“存储帐户参与者”、“存储 Blob 数据参与者”和“读取者”角色。
在“映像定义”窗格上，选择要生成的映像。
选择“生成”。
在“状态”列中跟踪生成进度。
重要
将映像定义优化到映像中时，会创建一个开发箱来运行自定义文件并生成映像。 在此过程中，此开发箱会连接到 Microsoft 管理的虚拟网络。 需要访问本地资源的任务可能会失败。
生成过程成功完成后，开发箱池会自动将映像用于新的开发箱。 你无需执行任何额外配置，即可将映像分配到池。 现在可以从池创建开发箱，自定义将应用于每个开发箱。