创建工作站配置

了解如何开始使用 Cloud Workstations 创建工作站配置。

工作站配置用作模板，可为多位开发者创建一致的工作站，并指定机器类型、可用区、磁盘大小、工具和预安装库等配置设置。对工作站配置执行的任何操作（例如更改机器类型或容器映像）都会在工作站下次启动时反映在每个工作站上。

本部分介绍了创建工作站配置的步骤：

1. 配置基本信息
2. 定义机器设置
3. 自定义环境
4. 添加用户
5. 添加标签和标记

---

如需在 Google Cloud 控制台中直接遵循有关此任务的分步指导，请点击操作演示：

操作演示

---

准备工作

在开始使用 Cloud Workstations 之前，请确保您拥有所需权限，并完成这些必需的设置步骤。如果您已完成此设置，则可以跳过本部分。

登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请 创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. 启用 Cloud Workstations API（如果尚未启用）。

   启用 API 所需的角色

   如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

   启用 API

2. 确保您对项目拥有 Cloud Workstations Admin IAM 角色，以便创建工作站配置。 如需在 Google Cloud 控制台中查看您的 IAM 角色，请前往 IAM 页面：

   进入 IAM

3. Cloud Workstations 托管在从 Compute Engine 预配置的公共 Container-Optimized OS (COS) 映像启动的虚拟机上。如果强制执行 constraints/compute.trustedimageProjects 组织政策限制条件，您必须设置映像访问权限限制，以允许用户通过 projects/cos-cloud 或所有公共映像创建启动磁盘。
4. Cloud Workstations 使用 Private Service Connect 连接到 Google 管理的服务。如果您的组织强制执行 constraints/compute.restrictPrivateServiceConnectProducer 组织政策限制条件，则您必须将 Google 添加为允许的提供方 (under:organizations/433637338589)。
5. 如果您的组织中强制执行了 constraints/compute.disablePrivateServiceConnectCreationForConsumers 组织政策限制条件，则必须确保允许连接到 Google API (GOOGLE_APIS) 的 Private Service Connect 端点。 如果您配置了专用集群，则还必须允许连接到已发布服务 (SERVICE_PRODUCERS) 的端点。
6. 可选：启用容器文件系统 API 以加快工作站启动速度。

   启用容器文件系统 API

   如需了解详情，请参阅使用映像流式传输缩短工作站启动时间。

配置基本信息

如需配置工作站配置的基本信息，请按照以下步骤操作：

1. 在控制台中，进入 Cloud Workstations > 工作站配置。

   前往“工作站配置”

2. 在工作站配置页面中，点击 add_box创建。

   

3. 在名称字段中，输入 test-configuration 作为配置的名称。

4. 在区域字段中，选择要用于此配置的工作站集群所在的区域，或选择要在其中创建集群的区域。

5. 从集群列表中，选择您的工作站集群，然后点击继续。

   如果所选区域中没有可用的工作站集群，系统会自动创建集群以及您的配置。新集群是使用默认设置创建的，您可以通过点击自定义集群设置来调整这些设置。如需详细了解工作站集群设置，请参阅创建工作站集群。

6. 对于机器预设，选择其中一个预配置选项（例如中等），或选择自定义以自定义计算和存储设置。

7. 在快速启动工作站部分，选择已启用可加快工作站启动速度，选择已停用可降低费用。

   此值指定保持在预启动状态的虚拟机 (VM) 数量，这可以缩短工作站启动时间。不过，您的项目需要为这些虚拟机付费。

8. 在代码编辑器菜单中，选择 Cloud Workstations 基本编辑器（适用于 Cloud Workstations 的 Code OSS）。 如果您的组织更喜欢其他 IDE，您也可以从预配置的 IDE 列表中进行选择。如果您不想使用预配置的映像，可以在环境设置页面上选择自定义映像。

9. 点击继续进入机器配置页面。

定义机器设置

1. 如需使用预设以外的机器类型，请根据需要选择机器类型。例如，您可以选择 e2-standard-4（4 个 CPU，16 GB 内存）。

2. 在您选择的区域内选择两个可用区。Cloud Workstations 会在这些可用区中创建虚拟机资源并存储数据。

   可用区的选择还会影响可用的计算资源类型。例如，如果您选择 N1 机器类型并希望使用 GPU，请务必选择两个可用区，其中所选 GPU 类型在按区域和可用区划分的 GPU 可用性表中列为可用。

3. 对于启用快速启动工作站，请根据您预期的开发者数量、用例和预算选择池大小。默认快速启动池大小为 1。

4. 在节省费用部分中，设置自动休眠前的等待时间。将 Auto-sleep（自动休眠）字段设置为 After 2 hours of inactivity (default)（在处于非活跃状态 2 小时后 [默认]），以自动关闭处于非活跃状态超过 2 小时的工作站。

5. 可选：在高级选项部分中，点击 expand_more 展开更多。

   1. 如需添加网络标记，请在网络标记字段中输入文本。

      网络标记是应用于底层 Compute Engine 虚拟机的元数据，可让您将防火墙规则和路由应用于特定虚拟机实例。在 Cloud Workstations 中，您可以使用网络标记将防火墙规则或路由应用于工作站配置下的所有工作站。

   2. 如需关闭公共 IP 地址，请选中停用公共 IP 地址复选框。

      如果您停用公共 IP 地址，则必须在自己的网络上设置专用 Google 访问通道或 Cloud NAT。如果您使用专用 Google 访问通道，并且将 private.googleapis.com 或 restricted.googleapis.com 用于 Artifact Registry，请确保为网域 *.pkg.dev 设置 DNS 记录。

   3. 如需开启嵌套虚拟化，请选中启用嵌套虚拟化复选框。利用嵌套虚拟化，您可以在工作站内运行虚拟机实例。

      在启用嵌套虚拟化之前，请考虑以下重要注意事项。

      Cloud Workstations 实例也受 与 Compute Engine 实例相同的限制：

      • 组织政策：如果组织政策中强制执行停用虚拟机嵌套虚拟化限制条件，则项目、文件夹或组织可能无法创建嵌套虚拟机。如需了解详情，请参阅 Compute Engine 部分中的检查是否允许嵌套虚拟化。

      • 性能：对于受 CPU 限制的工作负载，嵌套虚拟机的性能可能会下降 10% 或更多；对于受输入或输出限制的工作负载，性能下降幅度可能超过 10%。

      • 机器类型：只能在指定 N1 或 N2 机器系列中的机器类型的工作站配置上启用嵌套虚拟化。

   4. 如需在此虚拟机上处理数据时对数据进行加密，请选中机密虚拟机服务复选框。如需了解详情，请参阅创建机密虚拟机实例。

   5. 如需设置安全强化型虚拟机设置，请选中相应的功能复选框。安全强化型虚拟机功能包括受信任的 UEFI 固件，并提供用于启动、vTPM 和完整性监控的选项。

   6. 默认情况下，Cloud Workstations 会使用Google-owned and Google-managed encryption key对使用此工作站配置创建的资源进行加密。如需改用客户管理的加密密钥，请选择使用客户管理的加密密钥 (CMEK)。

6. 点击继续，进入环境设置页面。

自定义环境

通过以下步骤配置工作站容器映像和永久性存储，自定义 Cloud Workstations 环境：

1. 配置容器映像，方法是选择使用预配置的基础映像之一，或提供对您创建的自定义容器映像的引用。

   1. 如需使用预配置的基础映像，请执行以下操作：

      1. 将容器类型保留为 Code editors on base images（基础映像上的代码编辑器）。

      2. 在代码编辑器菜单中，选择 Cloud Workstations 基本编辑器（适用于 Cloud Workstations 的 Code OSS）。 如果您的组织更喜欢其他 IDE，您也可以从预配置的 IDE 列表中进行选择。

      3. 可选：在服务账号菜单中，从服务账号列表中进行选择。

   2. 可选：如需使用您自己的自定义容器映像，而不是预配置的基础映像，请执行以下操作：

      1. 选择自定义容器映像。

      2. 指定容器映像网址。

      3. 点击服务账号菜单，然后选择要在工作站配置下创建的虚拟机实例上使用的服务账号。此服务账号必须具有拉取自定义容器映像的权限（或者映像必须可公开访问）。如需了解详情，请参阅自定义开发环境中对 serviceAccount 的说明。

2. 在存储设置部分中，选择初始主目录和磁盘属性的偏好设置：

   1. 如需创建空的主目录，请选择创建空白永久性磁盘。如需将磁盘快照用于主目录，请选择通过来源磁盘快照创建永久性磁盘。

   2. 将永久性目录的磁盘类型设置为平衡，其性能高于 SSD，但比 SSD 更经济。

   3. 设置永久性目录的磁盘大小。默认值为 200 GB，但有效值为 10、50、100、200、500 或 1000 GB。 选择最符合您团队需求的磁盘大小。

   4. 将回收政策设置为删除或保留。默认值为删除。此政策决定了在工作站删除后，系统会对永久性磁盘执行什么操作。

      注意：

      • 创建工作站后，您无法修改磁盘类型。
      • 选择保留后，管理员可以在工作站删除后审核工作站主磁盘的内容，但管理员负责手动删除磁盘。
      • 如果您选择保留选项，然后删除工作站，则永久性磁盘不会被删除。但是，如果您重新创建工作站，则新磁盘将挂接到工作站，该工作站不包含已删除工作站中的数据。

        如需访问磁盘上的数据，您可以按照以下步骤操作：

        1. 创建新的 Compute Engine 实例。
        2. 将永久性磁盘添加到实例。
        3. 在虚拟机上装载磁盘。

您还可以按照以下可选步骤进一步自定义：

1. 可选：添加就绪性检查。

   如果需要，请指定就绪情况检查，以验证工作站在启动与此工作站配置关联的工作站时是否接受特定路径和端口上的请求。

2. 可选：展开高级容器选项。

   如果需要，请为所使用的容器映像指定其他参数。 例如，指定工作目录替换、用户替换、命令替换、要传递给 entrypoint 命令的参数以及环境变量。

3. 点击继续，进入用户和权限页面。

添加用户

如需允许多用户创建工作站，请将用户添加到工作站配置中：

1. 在用户和权限页面中，点击用户字段，然后输入要授予访问权限的一个或多个用户或 Google 群组的电子邮件地址。此操作会为这些用户设置 Cloud Workstations Creator IAM 政策。

2. 可选：如需添加 Cloud Workstations 政策管理员访问权限，请展开高级 IAM 选项。

   如需向工作站创建者授予 roles/workstations.policyAdmin 角色，请选中向工作站创建者授予 Policy Admin 角色复选框。这样，工作站创建者就可以更新工作站的 IAM 政策，以授予对工作站及其各个端口的访问权限。

   如需详细了解 Cloud Workstations 端口共享，请参阅授予对各个 Cloud Workstations 端口的访问权限页面。

   注意：默认情况下，无论向工作站创建者授予 Policy Admin 角色设置如何，工作站的创建者都会获得其创建的工作站的 roles/workstations.user 角色。

1. 点击继续，进入标签和标记页面。

添加标签和标记

1. 在标签和标记页面中，配置标签和标记：

   1. 可选：添加标签，以将键值对标签应用于底层 Compute Engine 资源。

2. 如需创建工作站配置，请点击创建。

   如果您选择创建新集群，则创建过程最多可能需要 20 分钟。

您刚刚创建了您的第一个工作站配置并向其中添加了用户。

如需根据此配置创建和启动工作站，请点击下一步。

清理

如果您为了解 Cloud Workstations 而创建了一个新工作站配置，但现在不再需要该配置，则可以从 Google Cloud 控制台中将其删除：

1. 在 Google Cloud 控制台中，前往 Cloud Workstations > 工作站配置。
2. 选中要删除的工作站配置旁边的复选框。
3. 点击 more_vert更多选项菜单，然后选择删除以删除所选工作站配置。

如需详细了解如何删除工作站、工作站集群和 Google Cloud 项目，请参阅删除资源。

后续步骤

• 使用新创建的工作站配置创建工作站。

• 使用 Cloud Workstations 基本编辑器。

• 通过 API 自定义工作站配置。

• 创建自定义容器映像，以扩展 Cloud Workstations 提供的预配置基础映像。