Criar e associar uma configuração de ciclo de vida

Este tópico inclui instruções para criar e associar uma configuração de ciclo de vida com. JupyterLab Você usa o AWS Command Line Interface (AWS CLI) ou o AWS Management Console para automatizar a personalização do seu JupyterLab ambiente.

As configurações do ciclo de vida são scripts de shell acionados por eventos JupyterLab do ciclo de vida, como iniciar um novo notebook. JupyterLab Para obter mais informações sobre a configuração do ciclo de vida, consulte Usando configurações de ciclo de vida com JupyterLab.

Crie uma configuração de ciclo de vida ()AWS CLI

Saiba como criar uma configuração de ciclo de vida usando o AWS Command Line Interface (AWS CLI) para automatizar a personalização do seu ambiente Studio.

Pré-requisitos

Antes de começar, conclua os pré-requisitos a seguir:

• Atualize o AWS CLI seguindo as etapas em Instalando a AWS CLI versão atual.

• Em sua máquina local, execute aws configure e forneça suas credenciais da AWS . Para obter informações sobre AWS credenciais, consulte Entendendo e obtendo suas AWS credenciais.

• Faça a integração com o SageMaker domínio da Amazon. Para obter informações conceituais, consulte Visão geral SageMaker do domínio da Amazon. Para obter um guia de início rápido, consulteConfiguração rápida para a Amazon SageMaker.

Etapa 1: Criar uma configuração de ciclo de vida

O procedimento a seguir mostra como criar um script de configuração do ciclo de vida que imprime Hello World.

nota

Cada script pode ter até 16.384 caracteres.

1. Na sua máquina local, crie um arquivo chamado my-script.sh com o seguinte conteúdo:

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

2. Use o seguinte para converter seu my-script.sh arquivo no formato base64. Esse requisito evita erros que ocorram devido à codificação de espaçamento e quebra de linha.

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

3. Crie uma configuração de ciclo de vida para uso com o Studio. O comando a seguir cria uma configuração de ciclo de vida que é executada quando você inicia um aplicativo associadoJupyterLab:

   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 o ARN da configuração de ciclo de vida recém-criada que é retornada. Esse ARN é obrigatório para anexar a configuração do ciclo de vida ao seu aplicativo.

Etapa 2: anexar a configuração do ciclo de vida ao seu SageMaker domínio (domínio) e perfil de usuário da Amazon

Para anexar a configuração do ciclo de vida, você deve atualizar o do UserSettings seu domínio ou perfil de usuário. Os scripts de configuração do ciclo de vida associados no nível do domínio são herdados por todos os usuários. No entanto, os scripts associados no nível do perfil do usuário têm como escopo um usuário específico.

Você pode criar um novo perfil de usuário, domínio ou espaço com uma configuração de ciclo de vida anexada usando os seguintes comandos:

• create-user-profile

• create-domain

• create-space

O comando a seguir cria um perfil de usuário com uma configuração de ciclo de vida. Adicione o ARN da configuração do ciclo de vida da etapa anterior ao do usuário. JupyterLabAppSettings Você pode adicionar várias configurações de ciclo de vida ao mesmo tempo passando uma lista delas. Quando um usuário inicia um JupyterLab aplicativo com o AWS CLI, ele pode especificar uma configuração de ciclo de vida em vez de usar a configuração padrão. A configuração do ciclo de vida que o usuário passa deve pertencer à lista de configurações do ciclo de vida em 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]
  }
}'

Criar uma configuração de ciclo de vida (console)

Aprenda a criar uma configuração de ciclo de vida usando o AWS Management Console para automatizar a personalização do seu ambiente Studio.

Etapa 1: Criar uma configuração de ciclo de vida

Use o procedimento a seguir para criar um script de configuração do ciclo de vida que seja impresso. Hello World

Para criar uma configuração de ciclo de vida

1. Abra o SageMaker console da Amazon em https://console.aws.amazon.com/sagemaker/.

2. No painel de navegação à esquerda, escolha Configurações do administrador.

3. Em Configurações administrativas, escolha Configurações do ciclo de vida.

4. Escolha a guia JupyterLab.

5. Escolha Criar configuração.

6. Em Nome, especifique o nome da configuração do ciclo de vida.

7. Para a caixa de texto em Scripts, especifique a seguinte configuração de ciclo de vida:

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

8. Escolha Criar configuração.

Etapa 2: anexar a configuração do ciclo de vida ao seu SageMaker domínio (domínio) e perfil de usuário da Amazon

Os scripts de configuração do ciclo de vida associados no nível do domínio são herdados por todos os usuários. No entanto, os scripts associados no nível do perfil do usuário têm como escopo um usuário específico.

Você pode anexar várias configurações de ciclo de vida a um domínio ou perfil de usuário para. JupyterLab

Use o procedimento a seguir para anexar uma configuração de ciclo de vida a um domínio.

Para anexar uma configuração de ciclo de vida a um domínio

1. Abra o SageMaker console da Amazon em https://console.aws.amazon.com/sagemaker/.

2. No painel de navegação à esquerda, escolha Configurações do administrador.

3. Em Configurações do administrador, escolha domínios.

4. Na lista de domínios, selecione o domínio ao qual anexar a configuração do ciclo de vida.

5. Em Detalhes do domínio, escolha a guia de Ambiente.

6. Em Configurações de duração para aplicativos pessoais do Studio, escolha Anexar.

7. Em Origem, escolha Configuração existente.

8. Em Configurações do ciclo de vida do Studio, selecione a configuração do ciclo de vida que você criou na etapa anterior.

9. Selecione Anexar a domínio.

Use o procedimento a seguir para anexar uma configuração de ciclo de vida a um perfil de usuário.

Para anexar uma configuração de ciclo de vida a um perfil de usuário

1. Abra o SageMaker console da Amazon em https://console.aws.amazon.com/sagemaker/.

2. No painel de navegação à esquerda, escolha Configurações do administrador.

3. Em Configurações do administrador, escolha domínios.

4. Na lista de domínios, selecione o domínio que contém o perfil de usuário ao qual anexar a configuração do ciclo de vida.

5. Em Perfis de usuário, selecione o perfil do usuário.

6. Na página Detalhes do usuário, escolha Editar.

7. No painel de navegação à esquerda, escolha Configurações do Studio.

8. Em Configurações de ciclo de vida anexadas ao usuário, escolha Anexar.

9. Em Origem, escolha Configuração existente.

10. Em Configurações do ciclo de vida do Studio, selecione a configuração do ciclo de vida que você criou na etapa anterior.

11. Escolha Anexar ao perfil do usuário.