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

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:

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

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Cloud Workstations API.

   Enable the API

7. Se você for um administrador, verifique se tem o papel do IAM de Administrador de estações de trabalho do Cloud no projeto para criar configurações de estações de trabalho.

   Se você for um desenvolvedor e não tiver configurações de estação de trabalho disponíveis no console do Google 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 de administrador do IAM do Cloud Workstations no projeto para 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:

   Acessar o IAM

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

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:

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 seu representante de sucesso do cliente do Posit ou envie um e-mail para [e-mail].

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

   1. Na etapa 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 seta de expansão arrow_drop_down 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 sua chave de licença do Posit Workbench no campo Valor.

         

      3. Clique em Continuar.

   4. Na etapa Adicionar usuários, conceda aos desenvolvedores permissões de acesso do IAM para estações de trabalho do Cloud na 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. No console do Google Cloud, acesse a página Cloud Workstations > Workstations.

   Acessar Estações de trabalho

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 sua 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 do recurso 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 (de 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 iniciar o desenvolvimento:

1. Clique em Estações de trabalho.
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 gira 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 Posit Workbench RStudio Pro

1. O exemplo a seguir mostra a página de boas-vindas do Posit Workbench. A página pode ter uma aparência diferente, dependendo de como a 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 integrados (IDEs, na sigla em inglês) compatíveis, como o Jupyter Notebook, o JupyterLab e o VS Code, consulte a documentação do Posit.

4. Clique em Iniciar sessão.

5. Aguarde a sessão começar e comece a programar.

   

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

1. Para fazer upload de arquivos da máquina local para a estação de trabalho, clique em 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 sua 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 a ser importado e selecione-o na estação de trabalho.

   O ambiente de desenvolvimento integrado do Posit Workbench tem dependências de vários pacotes R para diferentes partes dos recursos. Por exemplo, se você estiver fazendo o upload de um arquivo do Excel, alguns pacotes precisam 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 do contêiner do Posit Workbench, informe o problema ao Posit em [e-mail].

A seguir

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

• Saiba mais sobre o Posit Workbench na documentação do Posit Workbench.