Desenvolver código usando o Posit Workbench (incluindo o RStudio Pro)
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Antes de começar
Antes de começar a usar o Cloud Workstations, verifique se você tem as permissões necessárias e conclua estas etapas de configuração obrigatórias:
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.
Se você for administrador, verifique se tem o papel do IAM Administrador do Cloud Workstations no projeto para criar configurações de estação de trabalho.
Se você for um desenvolvedor e não tiver configurações de estação de trabalho
disponíveis no
consoleGoogle Cloud , peça ao administrador do Cloud Workstations da sua organização para
criar uma configuração de estação de trabalho para você ou verifique se você tem uma função do IAM de
administrador do Cloud Workstations no projeto para
poder criar esses recursos por conta própria.
Para verificar seus papéis do IAM, acesse a página do IAM no console do Google Cloud :
Para usar o Posit Workbench (incluindo o RStudio Pro), crie uma configuração de estação de trabalho
para os desenvolvedores da sua organização:
Encontre sua chave de licença do Posit Workbench e deixe-a por perto, porque você vai precisar dela em uma etapa posterior. Se você precisar de uma chave de licença do Posit Workbench,
entre em contato com seu representante de sucesso do cliente da Posit ou envie um e-mail para
sales@posit.co.
O link Criar poderá ser desativado se não houver
configurações no projeto ou se você não tiver permissões para visualizá-las.
Peça ao administrador do Cloud Workstations da organização para criar
uma configuração de estação de trabalho para você.
Insira o Nome da estação de trabalho.
Siga as convenções de nomenclatura de recursos do Compute Engine e escolha um nome exclusivo no cluster de estações de trabalho.
Clique na seta arrow_drop_downde expansão no campo Configuração e selecione a configuração da estação de trabalho Posit Workbench (terceiro).
Clique em Criar
para criar sua estação de trabalho.
Lançar sua estação de trabalho
Agora que você criou a estação de trabalho, inicie-a para começar o desenvolvimento:
Clique em Estações de trabalho.
Encontre a estação de trabalho que você criou na lista de estações disponíveis,
marque a caixa de seleção ao lado dela e clique em Iniciar. Isso inicia sua
estação de trabalho e faz a correspondência com a configuração da estação de trabalho principal.
Se for solicitado a iniciar a estação de trabalho, clique em Iniciar para confirmar.
O status muda para Iniciando, e o ícone de status
gira enquanto a operação
de início está em andamento. Pode levar alguns minutos para iniciar sua estação de trabalho.
Quando a estação de trabalho estiver pronta, o status mudará para Em execução e o
ícone de status mudará para uma
marca de seleção check_circle.
Clique em Iniciar.
Iniciar uma sessão do Posit Workbench RStudio Pro
O exemplo a seguir mostra a página de boas-vindas do Posit Workbench.
A aparência da página pode variar dependendo de como sua organização define a configuração da estação de trabalho:
Clique em Nova sessão.
Selecione RStudio Pro como o ambiente de desenvolvimento integrado e deixe Cluster definido como Local.
Para mais informações sobre o Posit Workbench e os IDEs compatíveis, como Jupyter Notebook, JupyterLab e VS Code, consulte a documentação do Posit.
Clique em Iniciar sessão.
Aguarde o início da sessão e comece a programar.
Fazer upload de arquivos para sua estação de trabalho
Para fazer upload de arquivos da máquina local para a estação de trabalho, clique em Fazer upload.
Selecione o Diretório de destino onde você quer armazenar os arquivos na sua estação de trabalho.
Clique em Escolher arquivo para selecionar o arquivo que você quer enviar.
Para iniciar o upload, clique em OK.
Para fazer upload de vários arquivos ou um diretório, crie um arquivo ZIP. O arquivo ZIP é expandido após o envio.
Importar arquivos da sua estação de trabalho
Para importar arquivos da sua estação de trabalho, clique em Importar conjunto de dados e selecione o tipo de conjunto de dados.
Navegue até o conjunto de dados na sua estação de trabalho e selecione-o para importar.
O ambiente de desenvolvimento integrado do Posit Workbench tem dependências em vários pacotes R para
diferentes partes de recursos. Por exemplo, se você estiver enviando um arquivo do Excel, será necessário instalar determinados pacotes. Se for solicitado que você instale os pacotes
necessários, clique em Sim.
Para iniciar a importação, clique em Importar.
Receber suporte para problemas do Posit Workbench
Se você encontrar problemas com o Posit Workbench ou com a imagem do contêiner dele, informe a Posit em support@posit.co.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-09 UTC."],[],[],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."]]
