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

**Cuidado** :um provedor terceirizado mantém a imagem do contêiner listada nesta seção. Google Cloud O Google Cloud não cria, mantém nem oferece suporte oficial a essa imagem. Avalie cuidadosamente qualquer solução antes de implantá-la no ambiente de produção.

Aprenda a começar a desenvolver código usando o Posit Workbench e o RStudio Pro com o Cloud Workstations. Este guia mostra como configurar seu ambiente, criar uma estação de trabalho e iniciar uma sessão do RStudio Pro.

Antes de começar

Este guia aborda as etapas para os administradores configurarem o Cloud Workstations e para os desenvolvedores usarem as estações de trabalho.

Para configurar o Cloud Workstations, siga estas etapas:

Faça login na sua Google Cloud conta do. Se você não conhece o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em cenários reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

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. Ative a API Cloud Workstations.

   Funções necessárias para ativar APIs

   Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

   Ativar a API

Funções exigidas

Para receber as permissões necessárias para gerenciar e usar estações de trabalho, peça ao administrador para conceder a você os papéis do IAM a seguir:

• Criar e gerenciar clusters e configurações de estações de trabalho: administrador do Cloud Workstations (roles/workstations.admin) no projeto
• Criar estações de trabalho usando uma configuração: criador do Cloud Workstations (roles/workstations.workstationCreator) no projeto ou na configuração da estação de trabalho
• Usar uma estação de trabalho: usuário do Cloud Workstations (roles/workstations.user) na estação de trabalho. Isso é concedido automaticamente nas estações de trabalho que você cria.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Para uma visão geral detalhada de todos os papéis do Cloud Workstations, consulte Controle de acesso com o IAM.

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

Para usar o Posit Workbench (incluindo o RStudio Pro), é necessário criar uma configuração de estação de trabalho para os desenvolvedores da sua organização:

1. Encontre a chave de licença do Posit Workbench e mantenha-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 o representante de sucesso do cliente da Posit ou envie um e-mail para [e-mail].

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

   1. Quando chegar à etapa de personalização do ambiente, selecione Editores de código em imagens de base.

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

   3. Clique na arrow_drop_downseta de expansão na seção Opções avançadas de contêiner.

      1. Acesse a seção Variáveis de ambiente e clique em Adicionar variável.

      2. Insira 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 à etapa "Adicionar usuários", conceda aos desenvolvedores permissões de acesso do IAM do Cloud Workstations à configuração da estação de trabalho.

   5. Para criar a configuração da estação de trabalho e adicionar esses usuários, clique em Criar.

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

   Os desenvolvedores da sua equipe agora podem criar estações de trabalho com o Posit Workbench.

Configurar a estação de trabalho

Para criar uma estação de trabalho, siga estas etapas.

1. Noconsole, acesse a página Cloud Workstations > Workstations . Google Cloud

   Acessar Workstations

2. Clique em add_boxCriar.

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

3. 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 da estação de trabalho.

4. Clique na seta de expansão arrow_drop_down no campo Configuração e selecione a configuração da estação de trabalho Posit Workbench (terceiros).

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

1. Clique em Workstations.
2. Encontre a estação de trabalho que você criou na lista de estações de trabalho 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.
3. Se for solicitado que você inicie a estação de trabalho, clique em Iniciar para confirmar. O status muda para Iniciando e o ícone de status atualizagira enquanto a operação de início está em andamento. Pode levar alguns minutos para iniciar sua estação de trabalho.
4. 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.
5. Clique em Iniciar.

Iniciar uma sessão do RStudio Pro do Posit Workbench

1. O exemplo a seguir mostra a página de boas-vindas do Posit Workbench. A página pode ser diferente, dependendo de como sua organização define a configuração da estação de trabalho:

   

2. Clique em Nova sessão.

3. 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 ambientes de desenvolvimento integrado que ele oferece suporte, como Jupyter Notebook, JupyterLab e VS Code, consulte a documentação do Posit.

4. Clique em Iniciar sessão.

5. Aguarde a sessão ser iniciada e comece a programar.

   

Fazer upload de arquivos para a estação de trabalho

1. Para fazer upload de arquivos do seu computador local para a estação de trabalho, clique em Fazer upload.

   

2. Selecione o diretório de destino em que você quer armazenar arquivos na estação de trabalho.

3. Clique em Escolher arquivo para selecionar o arquivo a ser enviado.

4. Para iniciar o upload, clique em OK.

Para fazer upload de vários arquivos ou de um diretório, crie um arquivo ZIP. O arquivo ZIP é expandido após o upload.

Importar arquivos da estação de trabalho

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

   

2. Navegue até o conjunto de dados e selecione-o para importar da estação de trabalho.

   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 fazendo upload de um arquivo do Excel, determinados pacotes precisarão ser instalados. Se for solicitado que você instale os pacotes necessários, clique em Sim.

3. 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 de contêiner do Posit Workbench, informe-os à Posit em [e-mail].

A seguir

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

• Consulte a central de documentação do Posit Software para saber mais sobre o Posit Workbench.