Accede a los buckets y archivos de Cloud Storage en JupyterLab

En esta página, se muestra cómo activar un bucket de Cloud Storage en la interfaz de JupyterLab de tu instancia de Agent Platform Workbench de Gemini Enterprise para que puedas explorar archivos almacenados en Cloud Storage. También puedes abrir y editar archivos que sean compatibles con JupyterLab, como archivos de texto y archivos de notebook (IPYNB).

Descripción general

Las instancias de Agent Platform Workbench incluyen una integración de Cloud Storage que te permite activar un bucket de Cloud Storage. Esto significa que puedes explorar el contenido del bucket y trabajar con archivos compatibles desde la interfaz de JupyterLab.

Puedes acceder a cualquiera de los buckets y archivos de Cloud Storage a los que tiene acceso tu instancia dentro del mismo proyecto que tu instancia de Agent Platform Workbench.

Antes de comenzar

  1. Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  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.

Roles obligatorios

Para obtener los permisos que necesitas para activar un bucket de Cloud Storage en una instancia de Agent Platform Workbench, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Permiso necesario para habilitar la activación de almacenamiento compartido

Para habilitar la activación de almacenamiento compartido en la instancia de Agent Platform Workbench, pídele a tu administrador que le otorgue a la cuenta de servicio de la instancia de Agent Platform Workbench el permiso storage.buckets.list en el proyecto.

El permiso storage.buckets.list es obligatorio para que el botón Activar almacenamiento compartido aparezca en la interfaz de JupyterLab de tu instancia de Agent Platform Workbench.

Crea un bucket y una instancia de Agent Platform Workbench

Debes tener acceso al menos a un bucket de Cloud Storage en el mismo proyecto que tu instancia de Agent Platform Workbench.
  1. Si necesitas crear un bucket de Cloud Storage, consulta Crea un bucket.
  2. Si aún no lo hiciste, crea una instancia de Agent Platform Workbench en el mismo proyecto que tu bucket de Cloud Storage.

Abre JupyterLab

  1. En la Google Cloud consola de, ve a la página Instancias.

    Ir a Instancias

  2. Junto al nombre de la instancia de Agent Platform Workbench, haz clic en Abrir JupyterLab.

    Tu instancia de Agent Platform Workbench abre JupyterLab.

Activa el bucket de Cloud Storage

Para activar un bucket de Cloud Storage y acceder a él, haz lo siguiente:

  1. En JupyterLab, asegúrate de que la  pestaña Navegador de archivos esté seleccionada.

  2. En la barra lateral izquierda, haz clic en el botón  Activar almacenamiento compartido. Si no ves el botón, arrastra el lado derecho de la barra lateral para expandirla hasta que veas el botón.

    El botón Activar almacenamiento compartido en la esquina superior derecha de la barra lateral izquierda

  3. En el campo Nombre del bucket, ingresa el nombre del bucket de Cloud Storage que deseas activar.

  4. Haz clic en Montar.

  5. Tu bucket de Cloud Storage aparece como una carpeta en la pestaña Navegador de archivos de la barra lateral izquierda. Haz doble clic en la carpeta para abrirla y explorar el contenido.

Solucionar problemas

Para encontrar métodos para diagnosticar y resolver problemas con la activación de un bucket de Cloud Storage en tu instancia, consulta Solución de problemas de Agent Platform Workbench.

¿Qué sigue?