Accedi ai bucket e ai file Cloud Storage in JupyterLab in un'istanza Agent Platform Workbench.

Questa pagina mostra come montare un bucket Cloud Storage nell'interfaccia JupyterLab dell'istanza di Gemini Enterprise Agent Platform Workbench in modo da poter sfogliare i file archiviati in Cloud Storage. Puoi anche aprire e modificare i file compatibili con JupyterLab, come i file di testo e i file di blocchi note (IPYNB).

Panoramica

Le istanze di Agent Platform Workbench includono un'integrazione di Cloud Storage che consente di montare un bucket Cloud Storage. Ciò significa che puoi sfogliare i contenuti del bucket e lavorare con i file compatibili dall'interfaccia JupyterLab.

Puoi accedere a qualsiasi bucket e file Cloud Storage a cui la tua istanza ha accesso all'interno dello stesso progetto dell'istanza di Agent Platform Workbench.

Nota: l'accesso dell'istanza di Agent Platform Workbench a Cloud Storage è determinato dal singolo utente o account di servizio utilizzato per concedere l'accesso all'istanza. Ad esempio, se hai concesso a un account di servizio specifico l'accesso alla tua istanza, devi concedere a questo account di servizio anche l'accesso ai bucket Cloud Storage che vuoi utilizzare in JupyterLab.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

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

Verify that billing is enabled for your Google Cloud project.

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

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

Verify that billing is enabled for your Google Cloud project.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per montare un bucket Cloud Storage su un'istanza di Agent Platform Workbench, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Notebooks Runner (roles/notebooks.runner) sul progetto
• Storage Object User (roles/storage.objectUser) sul account di servizio dell'istanza di Agent Platform Workbench

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Autorizzazione richiesta per l'attivazione del montaggio dell'archiviazione condivisa

Per attivare il montaggio dell'archiviazione condivisa nell'istanza di Agent Platform Workbench, chiedi all'amministratore di concedere al account di servizio dell'istanza di Agent Platform Workbench l'autorizzazione storage.buckets.list per il progetto.

L'autorizzazione storage.buckets.list è necessaria per visualizzare il pulsante Monta archiviazione condivisa nell'interfaccia JupyterLab dell'istanza di Agent Platform Workbench.

Crea un bucket e un'istanza di Agent Platform Workbench

Devi avere accesso ad almeno un bucket Cloud Storage nello stesso progetto dell'istanza di Agent Platform Workbench.

1. Se devi creare un bucket Cloud Storage, consulta Creare un bucket.
2. Se non l'hai ancora fatto, crea un'istanza di Agent Platform Workbench nello stesso progetto del bucket Cloud Storage.

Apri JupyterLab

1. Nella Google Cloud console, vai alla pagina Istanze.

   Vai a Istanze

2. Fai clic su Apri JupyterLab accanto al nome dell'istanza di Agent Platform Workbench.

   L'istanza di Agent Platform Workbench apre JupyterLab.

Monta il bucket Cloud Storage

Per montare e accedere a un bucket Cloud Storage:

1. In JupyterLab, assicurati che sia selezionata la scheda  File Browser.

2. Nella barra laterale sinistra, fai clic sul pulsante  Monta archiviazione condivisa. Se non vedi il pulsante, trascina il lato destro della barra laterale per espanderla finché non lo vedi.

   

3. Nel campo Nome bucket, inserisci il nome del bucket Cloud Storage che vuoi montare.

4. Fai clic su Monta.

5. Il bucket Cloud Storage viene visualizzato come cartella nella browser di file scheda della barra laterale sinistra. Fai doppio clic sulla cartella per aprirla e sfogliare i contenuti.

Risoluzione dei problemi

Per trovare metodi per diagnosticare e risolvere i problemi relativi al montaggio di un bucket Cloud Storage sull'istanza, consulta Risoluzione dei problemi di Agent Platform Workbench.

Passaggi successivi

• Scopri di più su Cloud Storage.

• Scopri come eseguire query sui dati in BigQuery da JupyterLab.