Oracle AI Data Platform Workbench (Unofficial)

[!WARNING] Proyecto comunitario e independiente. No es una extensión oficial de Oracle, no está afiliada, patrocinada ni respaldada por Oracle, y no sustituye el soporte oficial de Oracle.

Una extensión de VS Code para explorar, editar y ejecutar notebooks remotos de Oracle AI Data Platform Workbench (AIDP). Usa firma OCI para administrar el workspace y Browser Login de AIDP para conectar el kernel Jupyter.

Qué ofrece

• Navegación de workspaces, carpetas, notebooks y archivos desde la barra lateral.
• Acciones nativas New File... y New Folder... para crear notebooks .ipynb, archivos .py, .sql, .txt o carpetas; el menú contextual también permite cargar, renombrar y eliminar contenido con confirmación obligatoria.
• Carga de archivos al workspace desde el menú o arrastrándolos sobre una carpeta de AIDP.
• Edición de notebooks y archivos de texto en los editores nativos de VS Code, con guardado remoto y control de concurrencia por ETag.
• Ejecución de celdas Python, SQL y Scala mediante el canal Jupyter autenticado de AIDP, sin depender del encabezado Location.
• Panel Clusters agrupado por workspace: muestra únicamente compute de usuario y permite iniciar o detener el cluster elegido.
• Desconexión explícita de AIDP, con confirmación y sin borrar el archivo ni la clave privada de OCI.

Inicio rápido

1. Instala la extensión Jupyter si VS Code lo solicita.
2. Ejecuta Configure.
3. Completa el formulario que se abre dentro de VS Code: endpoint REST, OCID, archivo OCI config, perfil y URL de AIDP Workbench.
4. Selecciona Validate and connect. El asistente valida el acceso OCI, abre el Browser Login oficial y comprueba el endpoint Jupyter en ese orden. La configuración solo se guarda cuando todos los pasos terminan correctamente.
5. Abre un notebook desde Oracle AI Data Platform Workbench (Unofficial), selecciona un cluster y ejecuta la celda.

El Browser Login forma parte del asistente de configuración y es un requisito para ejecutar notebooks. No es necesario repetirlo mientras el token guardado en VS Code SecretStorage continúe vigente y corresponda a la misma URL de AIDP Workbench.

Si el navegador predeterminado no se abre automáticamente, el paso Browser Login muestra Open Browser Login para reintentarlo y Copy Login URL para pegar la dirección manualmente en cualquier navegador.

Ejemplo: región Chicago

El endpoint REST y la URL de navegador son valores distintos. El primero se usa para las APIs; la segunda debe copiarse completa, incluido &domain=Default (o el dominio de identidad correspondiente), porque conserva el alias, tenant y dominio necesarios para iniciar sesión y descubrir el endpoint WebSocket.

Workspaces y clusters

El panel Workspaces muestra carpetas, notebooks y archivos. Usa New File... o New Folder... en la barra del panel o en el menú contextual; allí también encontrarás Upload Files..., Rename y Delete. Los archivos nuevos se abren automáticamente y Ctrl+S guarda sus cambios en AIDP. Puedes arrastrar archivos desde el explorador del sistema o desde VS Code sobre un workspace o carpeta de destino. Las eliminaciones siempre requieren confirmación.

Renombrar y eliminar están disponibles con clic derecho sobre cualquier archivo, notebook o carpeta. La eliminación siempre muestra una confirmación; al eliminar una carpeta, AIDP puede eliminar también su contenido.

El panel Clusters, debajo, muestra los clusters USER del workspace y su estado.

• Start solo aparece para un cluster detenido. La extensión solicita confirmación porque iniciarlo consume recursos OCI.
• Stop solo aparece para un cluster activo. La extensión solicita confirmación porque puede interrumpir ejecuciones.
• La extensión no crea, redimensiona ni configura clusters.

En el primer Run del notebook, selecciona un cluster. Si seleccionas uno detenido, se inicia y VS Code espera a que esté activo antes de abrir la sesión de kernel. Las siguientes ejecuciones reutilizan la sesión local o una sesión remota activa del mismo notebook; el selector vuelve a aparecer únicamente cuando no existe una sesión reutilizable.

AIDP usa un kernel de sesión de tipo notebook; el lenguaje de cada celda se determina como Python, SQL o Scala a partir de sus metadatos y del lenguaje mostrado por VS Code. La URL del canal se construye con el webSocketEndpoint verificado del alias y con la ruta de gateway de notebooks 20240831/dataLakes usada por AIDP Workbench, por lo que no depende de un encabezado Location en la respuesta de creación de sesión.

La extensión envía el código de cada celda sin transformarlo. AIDP Workbench guarda las celdas SQL y Scala con %sql o %scala como primera línea; esos prefijos deben permanecer en el notebook para que el kernel multilenguaje las interprete correctamente.

Stop Execution envía una interrupción al kernel y cancela de inmediato la espera local, incluso si la extensión todavía estaba seleccionando o iniciando el cluster, conectando el WebSocket o esperando la respuesta de la celda.

Solución de problemas

• Punchout Access Error: vuelve a copiar la URL completa de AIDP Workbench. Si contiene tenant=..., también debe incluir &domain=...; para el dominio predeterminado, usa &domain=Default.
• El navegador no se abre: usa Open Browser Login para reintentar o Copy Login URL para abrir la dirección manualmente. El asistente mantiene ambas acciones visibles mientras espera el callback.
• Vuelve a pedir login o cluster: completa Validate and connect una vez con la misma URL de Workbench. El token queda en SecretStorage y las sesiones activas del notebook se descubren antes de solicitar otro cluster.

Seguridad y desconexión

Las operaciones de workspace y compute se firman con la API key definida en aidpNotebooks.ociConfigPath. La extensión nunca copia claves privadas, perfiles ni notebooks a una carpeta de sincronización local.

Para ejecutar notebooks, AIDP abre el login en el navegador y devuelve a VS Code un token SOUP vinculado a una clave RSA efímera. El token y las claves del login se guardan únicamente en SecretStorage; la extensión no lee cookies, no automatiza el navegador y no escribe credenciales en el repositorio ni en la configuración visible.

AIDP: Sign Out Browser cierra las sesiones activas y elimina el token de SecretStorage. AIDP: Disconnect pide confirmación, hace lo mismo y además elimina de la configuración de VS Code el endpoint, URL de navegador y OCID guardados. El archivo de configuración OCI y su clave privada permanecen intactos.

Alcance del MVP

Incluye gestión de contenido dentro de workspaces existentes, edición remota, Browser Login para sesiones de notebook y control manual de inicio/detención de compute existente. No incluye creación o configuración de workspaces/clusters, jobs/workflows, sincronización local ni reutilización de cookies.

Contribuir

Los reportes de errores, propuestas y pull requests son bienvenidos. Consulta CONTRIBUTING.md antes de enviar cambios y evita incluir configuraciones OCI, claves, tokens o datos de clientes.

Este proyecto se distribuye bajo la licencia MIT.