使用 Posit Workbench（包括 RStudio Pro）开发代码

注意 ：本部分列出的容器映像由第三方提供商维护。Google Cloud 不负责此映像的构建和维护，也不提供官方支持。 Google Cloud 在生产环境中部署任何解决方案之前，都要仔细评估。

了解如何使用 Cloud Workstations 通过 Posit Workbench 和 RStudio Pro 开始开发代码。本指南将引导您完成配置环境、创建工作站和启动 RStudio Pro 会话的过程。

准备工作

本指南介绍了管理员设置 Cloud Workstations 的步骤，以及开发者 使用工作站的步骤。

如需设置 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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

1. 启用 Cloud Workstations API。

   启用 API 所需的角色

   如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

   启用 API

所需角色

如需获得管理和使用工作站所需的权限，请让您的管理员为您授予以下 IAM 角色：

• 创建和管理工作站集群和配置：Cloud Workstations Admin (roles/workstations.admin) 在项目上
• 使用配置创建工作站：Cloud Workstations Creator (roles/workstations.workstationCreator) 在项目或工作站配置上
• 使用工作站： Cloud Workstations User (roles/workstations.user) 工作站的。系统会自动针对您创建的工作站授予此角色。

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。

如需详细了解所有 Cloud Workstations 角色，请参阅 使用 IAM 进行访问权限控制。

创建工作站配置

如需使用 Posit Workbench（包括 RStudio Pro），您必须为组织中的开发者创建工作站配置：

1. 找到您的 Posit Workbench 许可密钥，并将其放在手边，因为您在后续步骤中需要用到它。如果您需要 Posit Workbench 许可密钥， 请与您的 Posit 客户成功代表联系，或发送电子邮件至 [e-mail]。

2. 按照说明 创建工作站配置。

   1. 当您进入 “环境自定义” 步骤时，请选择基础映像上的代码编辑器。

   2. 在 Code editors （代码编辑器）菜单中，选择“Posit Workbench（包括 RStudio Pro） 第三方提供”。

   3. 点击 arrow_drop_down 展开 箭头，在 Advanced container options 部分。

      1. 前往 Environment variables （环境变量）部分，然后点击添加变量 。

      2. 在 Key （键）字段中输入 RSW_LICENSE，然后将您的 Posit Workbench 许可密钥粘贴到 Value （值）字段中。

         

      3. 点击继续 。

   4. 当您进入“添加用户”步骤时，请为您的开发者授予对工作站配置的Cloud Workstations IAM 访问权限。

   5. 如需创建工作站配置并这些用户添加到该配置，请点击创建 。

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

   您的团队中的开发者现在应该能够使用 Posit Workbench 创建工作站。

设置工作站

如需创建工作站，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，进入 Cloud Workstations > 工作站 页面。

   进入工作站

2. 点击 add_box创建。

   如果项目中没有任何配置，或者您无权查看配置，则创建 链接可能被停用。 请让贵组织的 Cloud Workstations Admin 为您创建工作站配置。

3. 输入工作站的名称 。

   请遵循 Compute Engine 资源 命名惯例 并选择在工作站集群中唯一的名称。

4. 点击 arrow_drop_down 展开 箭头，然后选择 Posit Workbench（第三方） 工作站配置。

5. 点击创建 以创建工作站。

发布工作站

现在您已经创建了工作站，接下来可以启动工作站，然后发布工作站以开始开发：

1. 点击工作站 。
2. 在可用工作站列表中找到您创建的工作站，选中其旁边的复选框，然后点击启动 。这会启动您的工作站，并将其与父工作站配置匹配。
3. 如果系统提示您启动工作站，请点击启动 以确认。 状态变为正在启动 ，并且在启动操作正在进行时，状态图标 refresh会旋转。启动工作站可能需要几分钟时间。
4. 工作站准备就绪后，状态将变为正在运行，并且状态图标会变为 check_circle 对勾标记。
5. 点击启动 。

启动 Posit Workbench RStudio Pro 会话

1. 以下示例展示了 Posit Workbench 的欢迎页面。 您的页面可能看起来有所不同，具体取决于您的组织如何定义工作站配置：

   

2. 点击 New Session （新会话）。

3. 选择 RStudio Pro 作为 IDE，并将 Cluster （集群）设置为 Local （本地）。

   

   如需详细了解 Posit Workbench 及其支持的 IDE（例如 Jupyter Notebook、JupyterLab 和 VS Code），请参阅 Posit 文档。

4. 点击 Start Session （开始会话）。

5. 等待会话启动，然后开始编码！

   

将文件上传到工作站

1. 如需将文件从本地机器上传到工作站，请点击上传 。

   

2. 选择要在工作站上存储文件的目标目录 。

3. 点击 Choose File （选择文件）以选择要上传的文件。

4. 如需开始上传，请点击 OK 。

如需上传多个文件或目录，请创建 ZIP 文件。ZIP 文件会在上传后展开。

从工作站导入文件

1. 如需从工作站导入文件，请点击 Import dataset （导入数据集），然后选择数据集的类型。

   

2. 导航到并选择要从工作站导入的数据集。

   Posit Workbench IDE 依赖于各种 R 软件包来实现不同的功能。例如，如果您要上传 Excel 文件，则需要安装某些软件包。如果系统提示您安装必需的软件包，请点击是 。

3. 如需开始导入，请点击导入 。

获取 Posit Workbench 问题支持

如果您在使用 Posit Workbench 或 Posit Workbench 容器映像时遇到问题，请通过 [e-mail] 向 Posit 报告。

后续步骤

• 了解如何 根据组织的需求自定义容器映像 。

• 如需详细了解 Posit Workbench，请参阅 Posit 软件 文档中心 。