Uso de una configuración de tiempo de ejecución

Además de las variables proporcionadas por el sistema, puede agregar claves de variables de entorno personalizadas a las sesiones de bloc de notas. Al crear una sesión de Notebook, agregue variables personalizadas como pares clave-valor en la sección Configuración de tiempo de ejecución.

Restricciones del par clave-valor

• Las claves y los valores son sensibles a mayúsculas/minúsculas.

• Las claves deben comenzar con una letra o un guion bajo y solo pueden contener caracteres alfanuméricos y guiones bajos.

• La longitud de la clave es de un mínimo de 2 y un máximo de 32 caracteres.

• La longitud del valor es de un mínimo de 1 y un máximo de 256 caracteres.

• Las claves no pueden comenzar con el espacio de nombres reservado del servicio oci_internal_.

• Las claves no pueden ser variables gestionadas por servicios.

Para una sesión de Notebook existente, desactive las sesiones de Notebook. A continuación, cuando active el portátil, agregue los pares clave-valor en la sección Configuración de tiempo de ejecución.

Puede utilizar los scripts de ciclo de vida de sesión de bloc de notas para ejecutar un script personalizado en diferentes estados de ciclo de vida de sesión de bloc de notas de la siguiente forma:

• Creación

• Activar

• Desactivar

• Suprimir

Para ejecutar un script de ciclo de vida de bloc de notas, transfiera una clave gestionada por servicio en la sección Configuración de tiempo de ejecución que indique el estado del ciclo de vida en el que se ejecutará el script. En el campo de valor correspondiente, especifique el URI del archivo de OCI Object Storage donde se ha cargado el script de ciclo de vida.

El estado del bloc de notas no cambia hasta que el script se haya completado para suprimir y desactivar los estados del ciclo de vida. Cree y active scripts de ciclo de vida que se ejecuten en paralelo con la sesión de bloc de notas para que no se produzcan retrasos de inicio.

Hemos proporcionado varios scripts de ciclo de vida de bloc de notas de ejemplo que se pueden cambiar para adaptarlos a varios casos de uso.

Se debe crear un grupo dinámico y una política de sesión de bloc de notas para utilizar una entidad de recurso para utilizar scripts de ciclo de vida de bloc de notas. Se deben otorgar permisos de lectura al grupo dinámico de bloc de notas para el cubo de Object Storage que contiene los scripts de ciclo de vida.

Las claves variables de entorno de script de ciclo de vida de sesión de bloc de notas son:

NB_ONCREATE_SCRIPT_URL
NB_ONACTIVATE_SCRIPT_URL
NB_ONDEACTIVATE_SCRIPT_URL
NB_ONDELETE_SCRIPT_URL

Estas claves deben tener agregada la siguiente política de IAM para permitir que Data Science lea objetos del cubo de scripts como en el siguiente ejemplo:

allow dynamic-group <notebook_dyn_group> to manage objects in tenancy
 where all {target.bucket.name='<scripts_bucket>',
            any {request.permission='OBJECT_INSPECT',
                 request.permission='OBJECT_READ'}}

Para las claves gestionadas por servicio correspondientes a las claves de script de ciclo de vida de bloc de notas anteriores, el valor debe ser un URI de archivo de OCI Object Storage en los scripts cargados. El formato de URI es https://objectstorage.region.oraclecloud.com/n/object-storage-namespace/b/bucket/o/filename. Puede encontrar el URI de archivo en la sección Detalles de objeto.

Las claves variables de entorno de script de salida de ciclo de vida de sesión de bloc de notas son:

NB_SCRIPT_OUTPUT_LOG_NAMESPACE
NB_SCRIPT_OUTPUT_LOG_BUCKET

Estas claves deben tener agregada la siguiente política de IAM para permitir a Data Science crear y cargar logs de salida en el cubo de logs, como en el siguiente ejemplo:

allow dynamic-group <notebook_dyn_group> to manage objects in tenancy
 where all {target.bucket.name='<logs_bucket>',
            any {request.permission='OBJECT_CREATE'}}

Los logs de script de creación y activación están disponibles dentro de la sesión de blocs de notas en la misma ruta que la configuración de tiempo de ejecución en el directorio /opt/log/odsc.log.

La carga de logs se produce con una operación de desactivación o supresión de sesión de bloc de notas, que le ofrece la opción de comprobar el estado del procesamiento del script porque pierde el acceso a la sesión de bloc de notas. Esto no se admite para crear y activar scripts.

Los repositorios de Git se pueden clonar dentro de sesiones de bloc de notas mediante una configuración de tiempo de ejecución. Solo se pueden clonar repositorios de Git públicos con este enfoque. Para clonar repositorios Git privados, utilice claves SSH para la autenticación.

Puede hacer que el servicio clone un repositorio de Git en un directorio local de una sesión de bloc de notas y, a continuación, utilizar Git.

Restricciones de Git

• El bloc de notas debe tener acceso a Internet para que el repositorio de Git se pueda clonar.

• Solo están soportados los repositorios de Git públicos.

• Se permite un máximo de tres direcciones URL de repositorios de Git.

• La longitud máxima de una URL es de 256 caracteres.

Directorios relacionados con Git en las sesiones del bloc de notas

• Busque los clones de los repositorios de Git en el directorio /home/datascience/repos de una sesión de bloc de notas.
• Para conocer el estado de clonación, como correcto, fallo o en curso, vaya a /opt/log/odsc.log.
• Para obtener logs detallados, vaya a /var/log/jupyterlab/runtime_config.log.

Acceda a los logs desde un terminal en una sesión de bloc de notas.

Para una sesión de Notebook existente, desactive las sesiones de Notebook. A continuación, cuando active el portátil, agregue la URL del repositorio de Git en la sección Configuración de tiempo de ejecución.

Si activa una sesión de Notebook con nuevas URL de repositorio de Git, también se clonarán todas las URL mostradas en la sección Configuración de tiempo de ejecución, incluidas las URL anteriores de sesiones de Notebook desactivadas, en el directorio /home/datascience/repos del Notebook.

Para eliminar un repositorio clonado de una sesión de Notebook, puede suprimirlo del directorio /home/datascience/repos de la sesión de Notebook.

Para sustituir un clon antiguo de un Notebook desactivado por uno nuevo, suprima la URL de repositorio de Git no deseada que aparece en la sección Configuración de tiempo de ejecución, agregue la nueva URL y, a continuación, active la sesión de Notebook.