Desenvolver código com 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 as Cloud Workstations, certifique-se de que tem as
autorizações necessárias
e que conclui estes passos de configuração obrigatórios:
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 for um administrador, certifique-se de que tem a função de IAM
Administrador do Cloud Workstations
no projeto para poder criar configurações de
estações de trabalho.
Se for um programador e não tiver configurações de estações de trabalho disponíveis na Google Cloud consola, peça ao administrador do Cloud Workstations da sua organização para criar uma configuração de estação de trabalho para si ou certifique-se de que tem uma função de IAM de administrador do Cloud Workstations no projeto para poder criar estes recursos.
Para verificar as suas funções do IAM, aceda à página do IAM na consola: Google Cloud
Para usar o Posit Workbench (incluindo o RStudio Pro), tem de criar uma configuração da estação de trabalho
para os programadores na sua organização:
Encontre a chave da licença do Posit Workbench e mantenha-a por perto, porque
vai precisar dela num passo subsequente. Se precisar de uma chave de licença do Posit Workbench,
contacte o seu representante de Êxito dos clientes do Posit ou envie um email para
sales@posit.co.
O link Criar pode estar desativado se não existirem configurações no projeto ou se não tiver autorizações para as ver.
Peça ao administrador das estações de trabalho na nuvem da sua organização para criar uma configuração de estação de trabalho para si.
Introduza o Nome da estação de trabalho.
Siga as convenções de nomenclatura dos recursos do Compute Engine
e escolha um nome exclusivo no cluster da estação de trabalho.
Clique na seta de expansão arrow_drop_downno campo Configuração e selecione a configuração da estação de trabalho Posit Workbench (terceiros).
Clique em Criar
para criar a estação de trabalho.
Inicie a sua estação de trabalho
Agora que criou a estação de trabalho, pode iniciá-la e, em seguida, lançá-la
para começar o desenvolvimento:
Clique em Estações de trabalho.
Encontre a estação de trabalho que criou na lista de estações de trabalho disponíveis,
selecione a caixa de verificação junto à mesma e, de seguida, clique em Iniciar. Isto inicia a estação de trabalho e faz a correspondência com a configuração da estação de trabalho principal.
Se lhe for pedido que inicie a estação de trabalho, clique em Iniciar para confirmar.
O estado é alterado para A iniciar e o ícone de estado
atualizargira enquanto a operação de início
está em curso. O arranque da estação de trabalho pode demorar alguns minutos.
Quando a estação de trabalho estiver pronta, o estado muda para Em execução e o ícone de estado muda para uma marca de verificação check_circle.
Clique em Iniciar.
Inicie uma sessão do RStudio Pro do Posit Workbench
O exemplo seguinte mostra a página de boas-vindas do Posit Workbench.
A página pode ter um aspeto diferente, consoante a forma como a sua organização define a configuração da estação de trabalho:
Clique em Nova sessão.
Selecione RStudio Pro como IDE e deixe Cluster definido como Local.
Para mais informações sobre o Posit Workbench e os IDEs que
suporta, como o Jupyter Notebook, o JupyterLab e o VS Code, consulte a
documentação do Posit.
Clique em Iniciar sessão.
Aguarde pelo início da sessão e, em seguida, comece a programar!
Carregue ficheiros para a sua estação de trabalho
Para carregar ficheiros do seu computador local para a estação de trabalho, clique em Carregar.
Selecione o diretório de destino onde quer armazenar ficheiros na sua estação de trabalho.
Clique em Escolher ficheiro para selecionar o ficheiro a carregar.
Para iniciar o carregamento, clique em OK.
Para carregar vários ficheiros ou um diretório, crie um ficheiro ZIP. O ficheiro ZIP é expandido após o carregamento.
Importe ficheiros da sua estação de trabalho
Para importar ficheiros da sua estação de trabalho, clique em Importar conjunto de dados e selecione
o tipo de conjunto de dados.
Navegue até ao conjunto de dados e selecione-o para importar a partir da sua estação de trabalho.
O IDE do Posit Workbench tem dependências de vários pacotes R para
diferentes partes das funcionalidades. Por exemplo, se estiver a carregar um ficheiro do Excel, tem de instalar determinados pacotes. Se lhe for pedido que instale os pacotes necessários, clique em Sim.
Para iniciar a importação, clique em Importar.
Receba apoio técnico para problemas do Posit Workbench
Se encontrar problemas com o Posit Workbench ou com a imagem do contentor do Posit Workbench, comunique-os à Posit através do endereço 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-08-21 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."]]
