Desenvolver código com o Posit Workbench (incluindo o RStudio Pro)

Aviso: um fornecedor de terceiros mantém a imagem do contentor indicada nesta secção. Google Cloud não cria, mantém nem suporta oficialmente esta imagem. Avalie cuidadosamente qualquer solução antes de a implementar no seu ambiente de produção.

Saiba como começar a desenvolver código com o Posit Workbench e o RStudio Pro com as estações de trabalho na nuvem. Este guia explica como configurar o ambiente, criar uma estação de trabalho e iniciar uma sessão do RStudio Pro.

Antes de começar

Este guia aborda os passos para os administradores configurarem as Cloud Workstations e para os programadores usarem as estações de trabalho.

Para configurar as estações de trabalho na nuvem, conclua os seguintes passos:

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.

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

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

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

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

Verify that billing is enabled for your Google Cloud project.

1. Enable the Cloud Workstations API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

Funções necessárias

Para receber as autorizações de que precisa para gerir e usar estações de trabalho, peça ao seu administrador que lhe conceda as seguintes funções de IAM:

• Criar e gerir clusters e configurações de estações de trabalho: Administrador das estações de trabalho na nuvem (roles/workstations.admin) no projeto
• Crie estações de trabalho através de uma configuração: Criador de estações de trabalho na nuvem (roles/workstations.workstationCreator) no projeto ou na configuração da estação de trabalho
• Usar uma estação de trabalho: Utilizador de estações de trabalho na nuvem (roles/workstations.user) na estação de trabalho. Esta opção é concedida automaticamente nas estações de trabalho que criar.

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para uma vista geral detalhada de todas as funções do Cloud Workstations, consulte o artigo Controlo de acesso com a IAM.

Crie a configuração da estação de trabalho

Para usar o Posit Workbench (incluindo o RStudio Pro), tem de criar uma configuração de estação de trabalho para os programadores na sua organização:

1. 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 [e-mail].

2. Siga as instruções para criar uma configuração de estação de trabalho.

   1. Quando chegar ao passo de Personalização do ambiente, selecione Editores de código em imagens base.

   2. No menu Editores de código, selecione 'Posit Workbench (incluindo RStudio Pro) fornecido por terceiros'.

   3. Clique na seta de expansão arrow_drop_down na secção Opções avançadas do contentor.

      1. Aceda à secção Variáveis de ambiente e, de seguida, clique em Adicionar variável.

      2. Introduza RSW_LICENSE no campo Chave e cole a chave de licença do Posit Workbench no campo Valor.

         

      3. Clique em Continuar.

   4. Quando chegar ao passo Adicionar utilizadores, conceda aos seus programadores autorizações de acesso ao IAM do Cloud Workstations para a configuração da estação de trabalho.

   5. Para criar a configuração da estação de trabalho e adicionar estes utilizadores à mesma, clique em Criar.

      Se também optou por criar um novo cluster, a criação do cluster pode demorar até 20 minutos.

   Os programadores da sua equipa já devem conseguir criar estações de trabalho com o Posit Workbench.

Configure a sua estação de trabalho

Para criar uma estação de trabalho, siga estes passos:

1. Na Google Cloud consola, navegue para a página Cloud Workstations > Estações de trabalho.

   Aceda a Estações de trabalho

2. Clique em add_boxCriar.

   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.

3. 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.

4. 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).

5. 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:

1. Clique em Estações de trabalho.
2. 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 sua estação de trabalho e faz a correspondência com a configuração da estação de trabalho principal.
3. Se lhe for pedido que inicie a estação de trabalho, clique em Iniciar para confirmar. O estado muda 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.
4. 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.
5. Clique em Iniciar.

Inicie uma sessão do RStudio Pro do Posit Workbench

1. 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:

   

2. Clique em Nova sessão.

3. 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.

4. Clique em Iniciar sessão.

5. Aguarde pelo início da sessão e, em seguida, comece a programar!

   

Carregue ficheiros para a sua estação de trabalho

1. Para carregar ficheiros do seu computador local para a estação de trabalho, clique em Carregar.

   

2. Selecione o diretório de destino onde quer armazenar ficheiros na sua estação de trabalho.

3. Clique em Escolher ficheiro para selecionar o ficheiro a carregar.

4. 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

1. Para importar ficheiros da sua estação de trabalho, clique em Importar conjunto de dados e selecione o tipo de conjunto de dados.

   

2. 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.

3. 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 [e-mail].

O que se segue?

• Saiba como personalizar imagens de contentores de acordo com as necessidades da sua organização.

• Consulte o centro de documentação da Posit Software para saber mais sobre o Posit Workbench.