Documentación de Oracle Cloud Infrastructure

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 reactiva la sesión de bloc de notas. Si se ha configurado 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 una red personalizada al volver a activarla.

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 reglas de 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 el almacenamiento de objetos 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.

Creación de un bloc de notas

Los pasos para crear un Notebook.

  • Le recomendamos que revise Misión de datos y archivos en un volumen en bloque de sesión de bloc de notas para ayudar a decidir el tamaño de volumen en bloque.

    1. En la página de detalles del proyecto, seleccione Crear sesión de bloc de notas. Si necesita ayuda para buscar la lista de proyectos, consulte Listado de proyectos.
    2. (Opcional) Introduzca un nombre único para la sesión de bloc de notas (límite de 255 caracteres). Si no proporciona un nombre, se genera automáticamente un nombre. Por ejemplo, datasciencenotebooksession20200108222435.
    3. (Opcional) Introduzca una descripción.
    4. (Opcional) Cambie la unidad de computación seleccionando Cambiar unidad. A continuación, siga estos pasos en el panel Seleccionar cálculo.
      1. Seleccione un tipo de instancia.
      2. Seleccione una serie de formas.
      3. Seleccione una de las unidades de computación admitidas en la serie.
      4. Seleccione la unidad que mejor se adapte a cómo desea utilizar el recurso.

        Para cada OCPU, seleccione hasta 64 GB de memoria y un total máximo 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.

      5. Si utiliza máquinas virtuales ampliables, conmute Burstable.
        En Utilización de base por OCPU, seleccione el porcentaje de OCPU que normalmente desea utilizar. Los valores soportados son 12,5% y 50%.
      6. Seleccione Seleccionar unidad.
    5. 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.
    6. Seleccione una de las siguientes opciones para configurar el tipo de red:

      • 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 la subred que desea utilizar para el recurso (trabajo o sesión de libro de notas).

        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 Cambiar compartimento y, a continuación, seleccione el compartimento que contiene la VCN o la subred.

        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 reactiva la sesión de bloc de notas. Si se ha configurado 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 una red personalizada al volver a activarla.

    7. Seleccione una de las siguientes opciones para configurar el tipo de punto final:

      • 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 que desea utilizar para la sesión de bloc de notas.

        Seleccione Cambiar compartimento para seleccionar el compartimento que contiene la VCN, la subred o el punto final privado.

    8. (Opcional) Para utilizar montajes de almacenamiento, seleccione +Add storage mount.
      Asegúrese de tener la autorización para utilizar montajes de almacenamiento.
      1. Seleccione un tipo de montaje de almacenamiento, OCI Object Storage o OCI File Storage.
      2. Seleccione un compartimento que contenga el recurso de almacenamiento que desea montar.
      3. Seleccione una de las siguientes opciones:
        Object Storage
        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.

        Cubo que desea utilizar.

        Puede agregar un prefijo de nombre de objeto. El prefijo debe empezar por un carácter alfanumérico. Los caracteres permitidos son los alfanuméricos, la barra ( / ), el guion ( - ) y el guion bajo ( _ ).

        File Storage

        El destino de montaje y la ruta de exportación que desea utilizar. Debe haber creado el sistema de archivos. Especifique un destino de montaje existente o cree uno nuevo.

        Debe utilizar una red personalizada para utilizar el almacenamiento de archivos.

        Siga las reglas de la lista de seguridad de la subred.
        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 111, 2048, 2049 y 2050 de TCP, y los puertos 111 y 2048 de UDP.
        • Salida con estado para los puertos de origen TCP 111, 2048, 2049 y 2050, y puerto de origen UDP 111.
      4. Introduzca la ruta en la que se montará el almacenamiento.

        El almacenamiento se monta en la ruta de montaje especificada. La ruta debe comenzar con un carácter alfanumérico. El directorio de destino debe ser único en 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.

      5. Seleccione Enviar.

        Repita estos pasos para agregar hasta dos montajes de almacenamiento para sesiones de bloc de notas.

    9. (Opcional) Amplíe la sección Configuración de tiempo de ejecución para definir variables de entorno personalizadas y valores de Git, de la siguiente manera:

      • Pares clave-valor: seleccione el separador e introduzca las variables de entorno por clave y valor. Para asignar un nombre a las claves, consulte key value pair Restrictions.

      • Configuración de Git: seleccione el separador e introduzca hasta tres URL de repositorio de Git público. Revise las restricciones del repositorio de Git para ver 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 al abrirlo en JupyterLab. Consulte https://github.com/oracle/accelerated-data-science.git.

    10. (Opcional) En la sección Etiquetas, agregue una o más etiquetas a resourceType. 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 la 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.
    11. (Opcional) Para ver los detalles de la sesión de bloc de notas inmediatamente después de su creación, seleccione Ver página de detalles al hacer clic en Crear.
    12. Haga clic en Crear.
    Se abre la página de sesiones de bloc de notas. Cuando la sesión de Notebook se crea correctamente, el estado cambia a Active y puede abrir la sesión de Notebook. 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 el uso de solicitudes de trabajo en OCI, consulte la sección sobre solicitudes de trabajo y la API de 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 los indicadores y las opciones de variables 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.