Acessar buckets e arquivos do Cloud Storage no JupyterLab em uma instância do Workbench do Agent Platform.

Nesta página, mostramos como montar um bucket do Cloud Storage na interface do JupyterLab da instância do Gemini Enterprise Agent Platform Workbench para procurar arquivos armazenados no Cloud Storage. Também é possível abrir e editar arquivos compatíveis com o JupyterLab, como arquivos de texto e de notebook (IPYNB).

Visão geral

As instâncias do Agent Platform Workbench incluem uma integração com o Cloud Storage que permite montar um bucket do Cloud Storage. Isso significa que é possível navegar pelo conteúdo do bucket e trabalhar com arquivos compatíveis na interface JupyterLab.

É possível acessar qualquer bucket e arquivos do Cloud Storage aos quais sua instância tem acesso no mesmo projeto que a instância do Agent Platform Workbench.

Antes de começar

  1. Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

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

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

  4. Enable the Notebooks 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

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

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

  7. Enable the Notebooks 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

    8.

Funções exigidas

Para receber as permissões necessárias para montar um bucket do Cloud Storage em uma instância do Agent Platform Workbench, peça ao administrador para conceder a você os seguintes papéis do IAM:

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.

Permissão necessária para ativar a montagem do armazenamento compartilhado

Para ativar a montagem do armazenamento compartilhado na instância do Agent Platform Workbench, peça ao administrador para conceder à conta de serviço da instância do Agent Platform Workbench a permissão storage.buckets.list no projeto.

A permissão storage.buckets.list é necessária para que o botão Montar armazenamento compartilhado apareça na interface do JupyterLab da sua instância do Agent Platform Workbench.

Criar um bucket e uma instância do Agent Platform Workbench

Você precisa ter acesso a pelo menos um bucket do Cloud Storage no mesmo projeto da instância do Agent Platform Workbench.
  1. Se você precisar criar um bucket do Cloud Storage, consulte Criar um bucket.
  2. Crie uma instância do Agent Platform Workbench no mesmo projeto do seu bucket do Cloud Storage, caso ainda não tenha feito isso.

Abrir JupyterLab

  1. No Google Cloud console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  2. Ao lado do nome da instância do Agent Platform Workbench, clique Abrir JupyterLab.

    Sua instância do Agent Platform Workbench abre o JupyterLab.

Montar o bucket do Cloud Storage

Para ativar e acessar um bucket do Cloud Storage, faça o seguinte:

  1. No JupyterLab, verifique se a  Navegador de arquivos guia está selecionada.

  2. Na barra lateral esquerda, clique no botão  Montar armazenamento compartilhado. Se o botão não aparecer, arraste o lado direito da barra lateral para expandi-la até encontrar o botão.

    O botão "Ativar armazenamento compartilhado" no canto superior direito da barra lateral esquerda

  3. No campo Nome do bucket, insira o nome do bucket do Cloud Storage que você quer ativar.

  4. Clique em Mount.

  5. Seu bucket do Cloud Storage aparece como uma pasta na Navegador de arquivos guia da barra lateral esquerda. Clique duas vezes na pasta para abri-la e navegar pelo conteúdo.

Resolver problemas

Para encontrar métodos para diagnosticar e resolver problemas com a montagem de um bucket do Cloud Storage na instância, consulte Solução de problemas do Agent Platform Workbench.

A seguir