Criação de configuração do ciclo de vida - Amazon SageMaker
Criar uma configuração de ciclo de vida (AWS CLI)Criar uma configuração de ciclo de vida (console)

Criação de configuração do ciclo de vida

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

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

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

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

Pré-requisitos

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

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. De sua máquina local, crie um arquivo denominado my-script.sh com o seguinte conteúdo:

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

  2. Use o seguinte para converter seu arquivo my-script.sh 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 uma aplicação associada JupyterLab.

    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 é necessário para anexar a configuração do ciclo de vida à sua aplicação.

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

Para anexar a configuração do ciclo de vida, é necessário atualizar as UserSettings do 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:

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 às JupyterLabAppSettings do usuário. É possível adicionar várias configurações de ciclo de vida ao mesmo tempo usando uma lista de configurações de ciclo de vida. Quando um usuário inicia uma aplicação do JupyterLab com a AWS CLI, ele pode passar uma configuração de ciclo de vida para usar em vez da padrão. A configuração de ciclo de vida que o usuário passa deve pertencer à lista de configurações de 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)

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

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.

Para criar uma configuração de ciclo de vida

  1. Abra o console do Amazon SageMaker 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 de ciclo de vida.

  4. Escolha a guia JupyterLab.

  5. Escolha Criar configuração.

  6. Para 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: Anexe a configuração do ciclo de vida ao seu domínio (domínio) e perfil de usuário do Amazon SageMaker

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.

É possível anexar várias configurações de ciclo de vida a um domínio ou perfil de usuário do 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 console do Amazon SageMaker 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 aplicações pessoais do Studio, escolha Anexar.

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

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

  9. Selecione Anexar a domínio.

Use o seguinte procedimento para anexar uma configuração de ciclo de vida para um perfil de usuário:

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

  1. Abra o console do Amazon SageMaker 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 do usuário para 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 de ciclo de vida do Studio, selecione a configuração de ciclo de vida que você criou na etapa anterior.

  11. Escolha Anexar ao perfil do usuário.