Desenvolver código usando o Posit Workbench (incluindo 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 necessárias:

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 um papel do IAM de Administrador do Cloud Workstations no projeto para criar configurações de estações de trabalho.

   Se você for um desenvolvedor e não tiver configurações de estações 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 um papel do IAM de administrador do Cloud Workstations no projeto para criar esses recursos por conta própria. Para verificar os papéis do IAM, acesse a página "IAM" no console do Google Cloud:

   Acessar o IAM

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

Para usar o Posit Workbench (incluindo RStudio Pro), você precisa 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 a mantenha por perto, porque você vai precisar dela em uma etapa subsequente. Se você precisar de uma chave de licença do Posit Workbench, entre em contato com o 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 de 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 arrow_drop_downde 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 você chegar à etapa Adicionar usuários, conceda aos desenvolvedores permissões de acesso do 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 esses usuários a ela, 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, navegue até a página Cloud Workstations > Workstations.

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

4. Clique na arrow_drop_downseta de expansão 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, é possível iniciá-la e iniciá-la 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 e clique em Iniciar. Isso inicia sua estação de trabalho e faz a correspondência dela com a configuração da estação de trabalho pai.
3. Se for solicitado que você inicie a estação de trabalho, clique em Iniciar para confirmar. O status muda para Starting, e o ícone de status refresh gira enquanto a operação de inicialização 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 no Posit Workbench

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

   

2. Clique em New Session.

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 compatíveis, como o Notebook do Jupyter, o JupyterLab e o VS Code, consulte a documentação do Posit (em inglês).

4. Clique em Iniciar sessão.

5. Espere 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 sua máquina local para sua estação de trabalho, clique em Fazer upload.

   

2. Selecione o Diretório de destino em que você quer armazenar os 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 o 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 e selecione o conjunto de dados a ser importado da sua estação de trabalho.

   O ambiente de desenvolvimento integrado do Posit Workbench depende de vários pacotes de R para diferentes recursos. Por exemplo, se você estiver fazendo upload de um arquivo do Excel, alguns 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 do contêiner, informe o 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.