Creación de configuraciones del ciclo de vida

En este tema se incluyen instrucciones para crear y asociar una configuración de ciclo de vida a JupyterLab. Utilice el AWS Command Line Interface (AWS CLI) o el AWS Management Console para automatizar la personalización de su JupyterLab entorno.

Las configuraciones del ciclo de vida son scripts de shell activados por eventos JupyterLab del ciclo de vida, como iniciar un nuevo JupyterLab bloc de notas. Para obtener más información acerca de las configuraciones del ciclo de vida, consulte Configuraciones del ciclo de vida con JupyterLab.

Cree una configuración de ciclo de vida (AWS CLI)

Aprenda a crear una configuración de ciclo de vida con AWS Command Line Interface (AWS CLI) para automatizar la personalización de su entorno de Studio.

Requisitos previos

Antes de comenzar, complete los siguientes requisitos previos:

• AWS CLI Actualízala siguiendo los pasos que se indican en Instalación de la AWS CLI versión actual.

• En el equipo local, ejecute aws configure y proporcione sus credenciales de AWS . Para obtener información sobre AWS las credenciales, consulte Descripción y obtención de AWS las credenciales.

• Incorporado al SageMaker dominio de Amazon. Para obtener información conceptual, consulte Descripción general SageMaker del dominio de Amazon. Para obtener una guía de inicio rápido, consulteUsa la configuración rápida para Amazon SageMaker.

Paso 1: Crear una configuración del ciclo de vida

En el siguiente procedimiento se muestra cómo crear un script de configuración del ciclo de vida que presente el mensaje Hello World.

nota

Cada script puede tener hasta 16 384 caracteres.

1. Desde su máquina local, cree un archivo denominado my-script.sh con el siguiente contenido:

   #!/bin/bash
   set -eux
   echo 'Hello World!'

2. Utilice lo siguiente para convertir el my-script.sh archivo al formato base64. Este requisito evita errores debidos a la codificación del espaciado y los saltos de línea.

   LCC_CONTENT=`openssl base64 -A -in my-script.sh`

3. Cree una configuración del ciclo de vida para usar en Studio. El siguiente comando crea una configuración del ciclo de vida que se ejecuta al lanzar una JupyterLab aplicación asociada:

   aws sagemaker create-studio-lifecycle-config \
   --region region \
   --studio-lifecycle-config-name my-jl-lcc \
   --studio-lifecycle-config-content $LCC_CONTENT \
   --studio-lifecycle-config-app-type JupyterLab 

   Anote la configuración ARN del ciclo de vida recién creada que se devuelve. Esto ARN es necesario para adjuntar la configuración del ciclo de vida a la aplicación.

Paso 2: Adjunta la configuración del ciclo de vida a tu SageMaker dominio (dominio) y perfil de usuario de Amazon

Para adjuntar la configuración del ciclo de vida, debes actualizar la UserSettings de tu dominio o perfil de usuario. Todos los usuarios heredan los scripts de configuración del ciclo de vida que estén asociados a nivel de dominio. Sin embargo, los scripts que están asociados en el nivel de perfil de usuario están dirigidos a un usuario específico.

Puede crear un nuevo perfil de usuario, dominio o espacio con una configuración de ciclo de vida adjunta mediante los siguientes comandos:

• create-user-profile

• create-domain

• create-space

El siguiente comando crea un perfil de usuario con una configuración de ciclo de vida. Agregue la configuración del ciclo ARN de vida del paso anterior a la JupyterLabAppSettings del usuario. Puede añadir varias configuraciones de ciclo de vida al mismo tiempo pasando una lista de ellas. Cuando un usuario inicia una JupyterLab aplicación con el AWS CLI, puede especificar una configuración de ciclo de vida en lugar de utilizar la configuración predeterminada. La configuración del ciclo de vida que pase el usuario debe pertenecer a la lista de configuraciones del ciclo de vida incluida en la JupyterLabAppSettings.

# Create a new UserProfile
aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"JupyterLabAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'

Cree una configuración de ciclo de vida (consola)

Aprenda a crear una configuración de ciclo de vida mediante la AWS Management Console para automatizar la personalización de su entorno de Studio.

Paso 1: Crear una configuración del ciclo de vida

Utilice el siguiente procedimiento para crear un script de configuración del ciclo de vida que se imprimaHello World.

Para crear una configuración del ciclo de vida, realice el siguiente procedimiento:

1. Abre la SageMaker consola de Amazon en https://console.aws.amazon.com/sagemaker/.

2. En el panel de navegación izquierdo, seleccione Configuraciones de administración.

3. En Configuraciones de administración, seleccione Configuraciones de ciclo de vida.

4. Selecciona la JupyterLabpestaña.

5. Seleccione Crear configuración.

6. En Nombre, especifique el nombre de la configuración del ciclo de vida.

7. En el cuadro de texto de la sección Secuencias de comandos, especifique la siguiente configuración del ciclo de vida:

   
   #!/bin/bash
   set -eux
   echo 'Hello World!'                    
                   

8. Seleccione Crear configuración.

Paso 2: Adjunta la configuración del ciclo de vida a tu SageMaker dominio (dominio) y perfil de usuario de Amazon

Todos los usuarios heredan los scripts de configuración del ciclo de vida asociados en el nivel de dominio. Sin embargo, los scripts que están asociados en el nivel de perfil de usuario están dirigidos a un usuario específico.

Puedes adjuntar varias configuraciones de ciclo de vida a un dominio o perfil de usuario para JupyterLab.

Utilice el siguiente procedimiento para adjuntar una configuración de ciclo de vida a un dominio.

Para adjuntar una configuración de ciclo de vida a un dominio

1. Abre la SageMaker consola de Amazon en https://console.aws.amazon.com/sagemaker/.

2. En el panel de navegación izquierdo, seleccione Configuraciones de administración.

3. En Configuraciones de administración, selecciona dominios.

4. En la lista de dominios, selecciona el dominio al que deseas adjuntar la configuración del ciclo de vida.

5. En Detalles del dominio, elija la pestaña Entorno.

6. En Configuraciones de ciclo de vida para aplicaciones de Studio personales, elija Asociar.

7. En Fuente, seleccione Configuración existente.

8. En Configuraciones del ciclo de vida de Studio, seleccione la configuración del ciclo de vida que ha creado en el paso anterior.

9. Seleccione Asociar al dominio.

Utilice el siguiente procedimiento para adjuntar una configuración de ciclo de vida a un perfil de usuario.

Para adjuntar una configuración de ciclo de vida a un perfil de usuario

1. Abre la SageMaker consola de Amazon en https://console.aws.amazon.com/sagemaker/.

2. En el panel de navegación izquierdo, seleccione Configuraciones de administración.

3. En Configuraciones de administración, selecciona dominios.

4. En la lista de dominios, seleccione el dominio que contiene el perfil de usuario al que desea adjuntar la configuración del ciclo de vida.

5. En Perfiles de usuario, seleccione el perfil de usuario.

6. En la página Detalles del usuario, elija Editar.

7. En el menú de navegación izquierdo, seleccione Configuración de Studio.

8. En Configuraciones del ciclo de vida asociadas al usuario, seleccione Asociar.

9. En Fuente, seleccione Configuración existente.

10. En Configuraciones del ciclo de vida de Studio, seleccione la configuración del ciclo de vida que ha creado en el paso anterior.

11. Seleccione Adjuntar a perfil de usuario.