Creación de una sesión de Notebook

Cree una sesión de bloc de notas de Data Science para acceder a una interfaz JupyterLab que utilice una configuración de red, almacenamiento y recursos informáticos personalizable.

Antes de empezar

Para utilizar una configuración de tiempo de ejecución, identifique las variables de entorno personalizadas y cualquier URL de repositorio de Git que desee utilizar.

Nota

La configuración de red de una sesión de bloc de notas no se puede cambiar cuando se vuelve a activar la sesión de bloc de notas. Si se configuró una sesión de bloc de notas para utilizar una red por defecto, no puede desactivar la sesión de bloc de notas y, a continuación, seleccionar la red personalizada cuando la reactive.

Configuración de redes para utilizar funciones gestionadas por Oracle

Para utilizar cualquiera de las funciones gestionadas por Oracle dentro del bloc de notas, los scripts del ciclo de vida del bloc de notas, las acciones rápidas de IA, el explorador del entorno y los blocs de notas de ejemplo, la subred del bloc de notas debe tener permisos para acceder a OCI Object Storage.

Si selecciona la red por defecto para el bloc de notas, la subred del bloc de notas tiene acceso a Object Storage. Si selecciona Redes personalizadas, debe configurar el acceso al almacenamiento de objetos con el gateway de servicios o el gateway de NAT. Puede configurar el gateway de servicios para acceder a todos los servicios o al almacenamiento de objetos específico de la región. Para obtener más información, consulte Creación de un gateway de servicio y Visión general de los gateways de servicio en la documentación de redes. O bien, puede configurar el gateway de Nat para permitir el acceso público a Internet. Para obtener más información, consulte Gateway de NAT en la documentación de redes.

Si utiliza el gateway de Internet, no podrá conectarse a la red pública de Internet con el bloc de notas. Esto se debe a que el gateway de Internet espera que los recursos que hay detrás sean una subred pública con IP públicas que los blocs de notas de Data Science no utilizan. El bloc de notas tampoco funcionará con la conexión a las funciones gestionadas por Oracle.

Configuración de montajes de almacenamiento

Para utilizar montajes de almacenamiento, debe tener un cubo de Object Storage o un destino de montaje y una ruta de exportación del servicio OCI File Storage (FSS).

Para utilizar FSS, primero debe crear el sistema de archivos y el punto de montaje. Utilice la opción de red personalizada y asegúrese de que el destino de montaje y el bloc de notas estén configurados con la misma subred. Configure las reglas de la lista de seguridad para la subred con los puertos y protocolos específicos.

Asegúrese de que los límites de servicio estén asignados al recuento del sistema de archivos y al recuento de destino de montaje.

Debe configurar políticas para utilizar Object Storage o File Storage Service (FSS) para montajes de almacenamiento en el bloc de notas.

Uso de OCI File Storage

Configurar montajes de almacenamiento al utilizar OCI File Storage.

Configuración de montajes de almacenamiento

  1. Navegue hasta el compartimento que desee.
  2. Cree un sistema de archivos en el servicio OCI File Storage junto con una exportación.
  3. Seleccione un destino de montaje existente o cree uno nuevo.
    Tiene un sistema de archivos y se han creado el destino de exportación y montaje.
  4. Configurar redes personalizadas.
    Puede crear una nueva subred o utilizar una existente. Asegúrese de que el destino de montaje y el bloc de notas estén configurados con la misma subred.
  5. Configure las reglas de lista de seguridad de la subred que se utiliza como se especifica en Configuración de reglas de seguridad de VCN para File Storage.
    Nota

    Antes de montar un sistema de archivos, debe configurar reglas de seguridad en la subred de la VCN para permitir el tráfico de red hacia y desde el destino de montaje. Puede configurar reglas de seguridad en listas de seguridad de subred, grupos de seguridad de red o mediante una combinación de ambos. Para obtener más información, consulte Configuración de reglas de seguridad de VCN para File Storage.
    • Entrada con estado para los puertos TCP 111, 2048, 2049 y 2050 y los puertos UDP 111 y 2048.
    • Salida con estado para los puertos de origen TCP 111, 2048, 2049 y 2050 y el puerto de origen UDP 111.

Uso de OCI Object Storage

Configurar montajes de almacenamiento al utilizar OCI Object Storage.

Los montajes de almacenamiento para Object Storage utilizan la autorización basada en principales de recurso para comunicarse entre el bloc de notas y el cubo necesario.

Para utilizar la opción de red por defecto para un bloc de notas, la salida gestionada funciona sin necesidad de configurar ninguna regla de red adicional.

Para utilizar la opción de red personalizada para un bloc de notas, se necesita una configuración de red más.

Configuración de montajes de almacenamiento

  1. En la elección de la VCN, cree el gateway de servicio.
  2. Para la subred privada necesaria, agregue Service Gateway a las configuraciones de la tabla de rutas.
  3. Cambie las reglas de salida de la lista de seguridad de la subred necesaria para permitir el tráfico a todos los servicios de la red regional de Oracle.

Uso de la consola, la CLI o el API

  • Le recomendamos que revise Mantenimiento de datos y archivos en el volumen de bloques de sesión de bloc de nota para ayudar a decidir el tamaño del volumen de bloques.

    1. En la página de lista Proyectos, seleccione el proyecto en el que desea crear la sesión de bloc de notas. Si necesita ayuda para buscar la página de lista o el proyecto, consulte Lista de proyectos.
    2. En la página de detalles del proyecto, seleccione Sesiones de bloc de notas.
    3. Seleccione Create bloc de notas session.
      Se abrirá la página Create bloc de notas session.

    1. Información básica

    Si lo desea, cambie la información de identificación.

    • Compartimento: seleccione el compartimento en el que desea crear la sesión de bloc de notas.
    • Nombre (Opcional): Introduzca un nombre único para la sesión de bloc de nota (límite de 255 caracteres). Si no se proporciona un nombre, se genera automáticamente un nombre. Por ejemplo, datasciencenotebooksession20200108222435.
    • Etiquetas (opcional): agregue etiquetas a la sesión de bloc de notas. Si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.

    2. Configuración

    Especifique la unidad de computación y la configuración de red.

    • Unidad (opcional): cambie la unidad de computación seleccionando Cambiar unidad. A continuación, siga estos pasos en el panel Seleccionar unidad de computación.
      • Seleccione un tipo de instancia.
      • Seleccione una serie de formas.
      • Seleccione una de las unidades de Compute soportadas en la serie. Seleccione la unidad que más se adapte a cómo desea utilizar el recurso.
      • Amplíe la unidad seleccionada para configurar las OCPU y la memoria.
        • Número de OCPU
        • Cantidad de memoria (GB): para cada OCPU, seleccione hasta 64 GB de memoria y un máximo total de 512 GB. La cantidad mínima de memoria permitida es de 1 GB o un valor que coincida con el número de OCPU, cualquiera que sea mayor.
        • Activar unidad ampliable: seleccione si utiliza máquinas virtuales ampliables y, a continuación, para Utilización de base por OCPU, seleccione el porcentaje de OCPU que normalmente desea utilizar. Los valores soportados son 12,5% y 50%. (Para despliegues de modelos, solo se admite el valor del 50 %).
      • Seleccione Seleccionar unidad.
    • Tamaño de almacenamiento de bloques: introduzca el tamaño de almacenamiento de bloques que desea utilizar, entre 50 GB y 10, 240 GB (10 TB). Puede cambiar el valor en incrementos de 1 GB. El valor por defecto es 100 GB.
    • Tipo de red: seleccione la opción correspondiente.
      • Red por defecto: la carga de trabajo se asocia mediante una VNIC secundaria a una VCN y una subred preconfiguradas gestionadas por el servicio. Esta subred proporcionada permite la salida a la red pública de Internet a través de un gateway de NAT y el acceso a otros servicios de Oracle Cloud a través de un gateway de servicio.

        Si solo necesita acceder a los servicios públicos de Internet y OCI, recomendamos utilizar esta opción. No es necesario que cree recursos de red ni escriba políticas para los permisos de red.

      • Red personalizada: seleccione la VCN y su subred (del compartimento indicado) que desea utilizar para el recurso (trabajo o sesión del bloc de nota).

        Para obtener acceso de salida a la red pública de Internet, utilice una subred privada con una ruta a un gateway de NAT.

        Si no ve la VCN o la subred que desea utilizar, seleccione un compartimento diferente.

        Importante

        Para utilizar un montaje de almacenamiento de archivos, debe seleccionar una red personalizada. La VCN y la subred deben ser las mismas que las utilizadas para la creación del destino de montaje.
      Nota

      La configuración de red de una sesión de bloc de notas no se puede cambiar cuando se vuelve a activar la sesión de bloc de notas. Si se configuró una sesión de bloc de notas para utilizar una red por defecto, no puede desactivar la sesión de bloc de notas y, a continuación, seleccionar la red personalizada cuando la reactive.
    • Tipo de punto final: seleccione la opción correspondiente.
      • Punto final público: acceso a datos en una instancia gestionada desde fuera de una VCN.
      • Punto final privado: seleccione la VCN, la subred y el punto final privado (del compartimento indicado) que desea utilizar para la sesión de bloc de notas.

    3. Configuración adicional

    También puede agregar montajes de almacenamiento, configuración de tiempo de ejecución y etiquetas.

    Nota

    Para los montajes de almacenamiento, asegúrese de tener la autorización para utilizar montajes de almacenamiento.
    • Montajes de almacenamiento de archivos (opcional): seleccione Agregar montaje de almacenamiento de archivos e introduzca la siguiente información.
      • Compartimento: seleccione el compartimento que contiene el destino que desea montar.
      • Destino de montaje: destino de montaje que desea utilizar.
      • Ruta de exportación: ruta de exportación que desea utilizar.
      • Ruta de destino y directorio: introduzca la ruta que se utilizará para montar el almacenamiento.

        La ruta debe empezar por un carácter alfanumérico. El directorio de destino debe ser único en todos los montajes de almacenamiento proporcionados. Los caracteres permitidos son alfanuméricos, guiones ( - ) y guiones bajos ( _ ).

        Puede especificar la ruta de acceso completa, como /opc/storage-directory. Si sólo se especifica un directorio, como /storage-directory, se monta en el directorio /mnt por defecto. No puede especificar directorios específicos del sistema operativo, como /bin o /etc.

    • Montajes de almacenamiento de objetos (opcional): seleccione Agregar montaje de almacenamiento de objetos e introduzca la siguiente información.
      • Compartimento: seleccione el compartimento que contiene el cubo que desea montar.
      • Bloque: seleccione el bloque que desea utilizar.
      • Prefijo de nombre de objeto (opcional): prefijo de nombre de objeto. El prefijo debe empezar por un carácter alfanumérico. Los caracteres permitidos son alfanuméricos, barra ( / ), guion ( - ) y guion bajo ( _ ).
      • Ruta de destino y directorio: introduzca la ruta que se utilizará para montar el almacenamiento.

        La ruta debe empezar por un carácter alfanumérico. El directorio de destino debe ser único en todos los montajes de almacenamiento proporcionados. Los caracteres permitidos son alfanuméricos, guiones ( - ) y guiones bajos ( _ ).

        Puede especificar la ruta completa, como /opc/storage-directory. Si sólo se especifica un directorio, como /storage-directory, se monta en el directorio /mnt por defecto. No puede especificar directorios específicos del sistema operativo, como /bin o /etc.

      Nota

      Si utiliza redes personalizadas:
      1. Cree el gateway del servicio en la VCN.
      2. Para las configuraciones de tabla de rutas en la subred privada, agregue el gateway de servicio.
      3. Cambie las reglas de salida de la lista de seguridad de la subred necesaria para permitir el tráfico a todos los servicios de la red.
    • Configuración de tiempo de ejecución (opcional): defina las variables de entorno personalizadas (pares clave-valor) y la configuración de Git.
      • Pares de clave-valor: seleccione Agregar par de clave-valor e introduzca una clave y un valor. Se pueden agregar hasta 30 pares de valores clave. Para asignar un nombre a las claves, consulte key value pair limits.
      • Configuración de Git: seleccione Agregar Valor de Git e introduzca una URL de repositorio de Git pública. Se pueden agregar hasta 3 repositorios de Git. Revise las restricciones del repositorio de Git para conocer el número y el tamaño de las URL.
        Consejo

        Puede utilizar el ejemplo del repositorio de ADS para crear rápidamente un repositorio de Git para un bloc de notas que puede utilizar cuando lo abra en JupyterLab. Consulte https://github.com/oracle/accelerated-data-science.git.
    • Etiquetas (opcional): agregue etiquetas a la sesión de bloc de notas. Si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.

    4. Revisar y Crear

    Revise la configuración y, a continuación, seleccione Crear.

    Se abre la página de sesiones de bloc de notas. Cuando se crea correctamente la sesión de bloc de notas, el estado pasa a Activo y puede abrir la sesión de bloc de notas, La acción de creación de sesión de bloc de notas es asíncrona e inicia una solicitud de trabajo. Puede utilizar la solicitud de trabajo para realizar un seguimiento del estado de una operación.

    Para obtener información general sobre la utilización de solicitudes de trabajo en OCI, consulte Solicitudes de trabajo.

  • Utilice los comandos oci data-science Notebook-session create y los parámetros necesarios para crear una sesión de bloc de notas en un compartimento:

    oci data-science notebook-session create --compartment-id <compartment-id>, -c [<name>], -c [<project-id>]  ... [OPTIONS]

    Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de la CLI.

  • Ejecute la operación CreateNotebookSession para crear una sesión de bloc de notas.