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

Saiba como começar a desenvolver códigos 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:

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

    Go to project selector

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

  3. Verify that billing is enabled for your Google Cloud project.

  4. Ative a API Cloud Workstations, se ainda não estiver ativada.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). 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 seguintes papéis do IAM:

  • Criar e gerenciar clusters e configurações de estação 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. Ela é concedida 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 papéis personalizados ou outros papéis predefinidos.

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 do Posit ou envie um e-mail para sales@posit.co.

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

    1. Quando chegar à 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 o 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. Digite RSW_LICENSE no campo Chave e cole a 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 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. No console do Google Cloud , navegue até a página Cloud Workstations > Estações de trabalho.

    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 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 de estações 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 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 preciso iniciar 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 RStudio Pro do Posit Workbench

  1. O exemplo a seguir mostra a página de recepção do Posit Workbench. Sua 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 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 o início da sessão e comece a programar.

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

  1. Para fazer upload de arquivos da máquina local para a 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 que 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 sua 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 que você quer importar da estação de trabalho e selecione-o.

    O ambiente de desenvolvimento integrado do Posit Workbench tem dependências de vários pacotes R para diferentes partes de recursos. Por exemplo, se você estiver fazendo 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ê tiver problemas com o Posit Workbench ou com a imagem de contêiner do Posit Workbench, informe-os ao Posit em support@posit.co.

A seguir