Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
如果您是开发者，并且在 Google Cloud 控制台中没有可用的工作站配置，请让贵组织的 Cloud Workstations Admin 为您创建工作站配置，或者确保您拥有项目的 Cloud Workstations Admin IAM 角色，以便您自行创建这些资源。
如需查看您的 IAM 角色，请前往 Google Cloud 控制台中的 IAM 页面：
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-09-04。"],[],[],null,["# Develop code using Posit Workbench (including RStudio Pro)\n\n| **Caution:** A third-party provider maintains the container image listed in this section. Google Cloud does not build, maintain, or officially support this image. Carefully evaluate any solution before deploying it in your production environment.\n\nBefore you begin\n----------------\n\nBefore you begin using Cloud Workstations, be sure that you have the\n[required permissions](/workstations/docs/access-control#enable_required_roles)\nand that you complete these required setup steps:\n\nSign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n\nIn the Google Cloud console, on the project selector page,\nselect or create a Google Cloud project.\n| **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.\n\n[Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n\n\n[Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n\nEnable the Cloud Workstations API.\n\n\n[Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=workstations.googleapis.com) \nIn the Google Cloud console, on the project selector page,\nselect or create a Google Cloud project.\n| **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.\n\n[Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n\n\n[Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n\nEnable the Cloud Workstations API.\n\n\n[Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=workstations.googleapis.com)\n1.\n\n\n Enable the Cloud Workstations API.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=workstations.googleapis.com)\n2.\n If you are an administrator, make sure that you have a\n [Cloud Workstations Admin](/workstations/docs/access-control#workstations-admin)\n IAM role on the project so that you can create workstation\n configurations.\n\n\n If you are a developer and you don't have workstation configurations\n available in the\n [Google Cloud console](https://console.cloud.google.com/workstations/), ask your organization's Cloud Workstations Admin to\n create a workstation configuration for you, or make sure that you have a\n Cloud Workstations Admin IAM role on the project so\n that you can create these resources yourself.\n To check your IAM roles, go to the IAM\n page in the Google Cloud console:\n\n\n [Go to IAM](https://console.cloud.google.com/iam-admin/iam)\n\nCreate the workstation configuration\n------------------------------------\n\nTo use Posit Workbench (including RStudio Pro) the you must create a workstation configuration\nfor the developers in your organization:\n\n1. Find your Posit Workbench license key and keep it nearby because you\n need it in a subsequent step. If you need a Posit Workbench license key,\n contact your Posit Customer Success representative or email\n [sales@posit.co](mailto:sales@posit.co).\n\n2. Follow the instructions to\n [create a workstation configuration](/workstations/docs/create-configuration).\n\n 1. When you get to the\n [Environment customization](/workstations/docs/create-configuration#customize_the_environment)\n step, select **Code editors on base images**.\n\n 2. From the **Code editors** menu, select\n '**Posit Workbench (including RStudio Pro)** Third-party provided'.\n\n 3. Click the arrow_drop_downexpander\n arrow in the **Advanced container options** section.\n\n 1. Go to the **Environment variables** section, and then click\n **Add variable**.\n\n 2. Enter `RSW_LICENSE` in the **Key** field and paste your\n Posit Workbench license key into the **Value** field.\n\n 3. Click **Continue**.\n\n 4. When you get to the\n [Add users](/workstations/docs/create-configuration#add_users)\n step, give your developers\n [Cloud Workstations IAM access permissions](/workstations/docs/access-control)\n to the workstation configuration.\n\n 5. To create your workstation configuration and add these users to it,\n click **Create**.\n\n If you also elected to create a new cluster, cluster creation can take up\n to 20 minutes.\n\n Developers in your team should now be able to create workstations with\n Posit Workbench.\n\nSet up your workstation\n-----------------------\n\nTo create a workstation, follow these steps:\n\n1. In the Google Cloud console, navigate to the\n **Cloud Workstations** \\\u003e **Workstations**\n page.\n\n\n [Go to **Workstations**](https://console.cloud.google.com/workstations/list)\n\n \u003cbr /\u003e\n\n2. Click add_box**Create**.\n\n The **Create** link might be disabled if there aren't any\n configurations in the project or if you don't have permissions to view them.\n Ask your organization's Cloud Workstations Admin to create\n a workstation configuration for you.\n3. Enter your workstation **Name**.\n\n Follow the Compute Engine resource\n [naming conventions](/compute/docs/naming-resources)\n and choose a name that is unique within the workstation cluster.\n\n4. Click the arrow_drop_downexpander\n arrow in the **Configuration** field and select the\n **Posit Workbench (Third-party)** workstation configuration.\n\n5. Click **Create**\n to create your workstation.\n\nLaunch your workstation\n-----------------------\n\nNow that you have created your workstation, you can start it and then launch it\nto begin development:\n\n1. Click **Workstations**.\n2. Find the workstation that you created in the list of available workstations, select the checkbox beside it, and then click **Start**. This starts your workstation, and matches it to the parent workstation configuration.\n3. If prompted to start your workstation, click **Start** to confirm. The status changes to **Starting** and the status icon refreshspins while the start operation is in progress. It might take a few minutes to start your workstation.\n4. When your workstation is ready, the status changes to **Running** and the status icon changes to a check_circle checkmark.\n5. Click **Launch**.\n\nLaunch a Posit Workbench RStudio Pro session\n--------------------------------------------\n\n1. The following example shows the welcome page for the Posit Workbench.\n Your page might look different, depending on how your organization defines\n your workstation configuration:\n\n2. Click **New Session**.\n\n3. Select **RStudio Pro** as the IDE and leave **Cluster** set to **Local**.\n\n For more information about Posit Workbench and the IDEs that it\n supports, such as Jupyter Notebook, JupyterLab, and VS Code, see the\n [Posit documentation](https://docs.posit.co/ide/server-pro/user/).\n4. Click **Start Session**.\n\n5. Wait for the session to start up and then begin coding!\n\nUpload files to your workstation\n--------------------------------\n\n1. To upload files from your local machine to your workstation, click **Upload**.\n\n2. Select the **Target directory** where you want to store files on your\n workstation.\n\n3. Click **Choose File** to select the file to upload.\n\n4. To begin the upload, click **OK**.\n\nTo upload multiple files or a directory, create a ZIP file. The ZIP\nfile is expanded after upload.\n\nImport files from your workstation\n----------------------------------\n\n1. To import files from your workstation, click **Import dataset** and select\n the type of dataset.\n\n2. Navigate to and select the dataset to import from your workstation.\n\n The Posit Workbench IDE has dependencies on various R packages for\n different pieces of features. For example, if you are uploading an Excel\n file, certain packages need to be installed. If prompted to install required\n packages, click **Yes**.\n3. To begin the import, click **Import**.\n\nGet support for Posit Workbench issues\n--------------------------------------\n\nIf you encounter issues with Posit Workbench or with the Posit Workbench\ncontainer image, report them to Posit at [support@posit.co](mailto:support@posit.co).\n\nWhat's next\n-----------\n\n- Learn how to\n [customize container images](/workstations/docs/customize-container-images)\n to your organization's needs.\n\n- Refer to the Posit Software\n [documentation hub](https://docs.posit.co/)\n to learn more about Posit Workbench."]]
