Crie uma configuração de ciclo de vida a partir do console SageMaker - Amazon SageMaker

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Crie uma configuração de ciclo de vida a partir do console SageMaker

Importante

IAMPolíticas personalizadas que permitem que o Amazon SageMaker Studio ou o Amazon SageMaker Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma IAM política permitir que o Studio e o Studio Classic criem recursos, mas não permita a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte Forneça permissões para marcar recursos SageMaker.

AWS Políticas gerenciadas para a Amazon SageMakerque dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.

Importante

Em 30 de novembro de 2023, a experiência anterior do Amazon SageMaker Studio agora se chama Amazon SageMaker Studio Classic. A seção a seguir é específica para usar o aplicativo Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte SageMaker Estúdio Amazon.

O tópico a seguir mostra como criar uma configuração de ciclo de vida a partir do SageMaker console da Amazon para automatizar a personalização do seu ambiente Studio Classic.

Pré-requisitos

Antes que você possa começar este tutorial, conclua os seguintes pré-requisitos:

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

Você pode criar uma configuração de ciclo de vida inserindo um script no console da Amazon SageMaker.

nota

Cada script pode ter até 16.384 caracteres.

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

  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 Studio.

  5. Escolha Criar configuração.

  6. Em Selecionar tipo de configuração, selecione o tipo de aplicativo ao qual a configuração do ciclo de vida deve ser anexada. Para obter mais informações sobre como selecionar a qual aplicativo anexar a configuração do ciclo de vida, consulte Defina as configurações padrão do ciclo de vida.

  7. Escolha Próximo.

  8. Na seção chamada Ajustes de configuração, insira um nome para sua configuração de ciclo de vida.

  9. Na seção Scripts, insira o conteúdo a seguir.

    #!/bin/bash set -eux echo 'Hello World!'
  10. (Opcional) Crie uma tag para sua configuração de ciclo de vida.

  11. Escolha Enviar.

Etapa 2: Anexar a configuração do ciclo de vida a um 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 anexar várias configurações de ciclo de vida a um domínio ou perfil de usuário para ambos JupyterServer e aplicativos. KernelGateway

nota

Para anexar uma configuração de ciclo de vida a um espaço compartilhado, você deve usar o AWS CLI. Para obter mais informações, consulte Crie uma configuração de ciclo de vida do AWS CLI.

As seções a seguir mostram como anexar uma configuração de ciclo de vida para seu domínio ou perfil de usuário.

Anexar a um domínio

Veja a seguir como anexar uma configuração de ciclo de vida ao seu domínio existente a partir do SageMaker console.

  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.

Anexar ao seu perfil de usuário

Veja a seguir como anexar uma configuração de ciclo de vida ao seu perfil de usuário existente.

  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.

Etapa 3: Iniciar um aplicativo com configuração de ciclo de vida

Depois de anexar uma configuração de ciclo de vida a um domínio ou perfil de usuário, você pode iniciar um aplicativo com essa configuração de ciclo de vida anexada. A escolha da configuração de ciclo de vida com a qual iniciar depende do tipo de aplicativo.

  • JupyterServer: ao iniciar um JupyterServer aplicativo a partir do console, SageMaker sempre usa a configuração padrão do ciclo de vida. Você não pode usar uma configuração de ciclo de vida diferente ao iniciar a partir do console. Para obter informações sobre como alterar a configuração padrão do ciclo de vida após iniciar um JupyterServer aplicativo, consulte. Defina as configurações padrão do ciclo de vida

    Para selecionar uma configuração de ciclo de vida anexada diferente, você deve iniciar com o AWS CLI. Para obter mais informações sobre como iniciar um JupyterServer aplicativo com uma configuração de ciclo de vida anexada a partir do AWS CLI, consulte. Crie uma configuração de ciclo de vida do AWS CLI

  • KernelGateway: você pode selecionar qualquer uma das configurações de ciclo de vida anexadas ao iniciar um KernelGateway aplicativo usando o Studio Classic Launcher.

O procedimento a seguir descreve como iniciar um KernelGateway aplicativo com uma configuração de ciclo de vida anexada a SageMaker partir do console.

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

  2. Inicie o Studio Classic. Para obter mais informações, consulte Inicie o Amazon SageMaker Studio Classic.

  3. Na interface do Studio Classic, abra o Studio Classic Launcher. Para obter mais informações, consulte Use o Amazon SageMaker Studio Classic Launcher.

  4. No Studio Classic Launcher, navegue até a seção Notebooks e recursos computacionais.

  5. Clique no botão Criar ambiente.

  6. Na caixa de diálogo Alterar ambiente, use as listas suspensas para selecionar sua imagem, kernel, tipo de instância e um script de inicialização. Se não houver uma configuração padrão do ciclo de vida, o valor padrão do script de inicialização será No script. Caso contrário, o valor do script de inicialização é sua configuração de ciclo de vida padrão. Depois de selecionar uma configuração de ciclo de vida, será possível visualizar o script inteiro.

  7. Clique em Selecionar.

  8. De volta ao Inicializador, clique em Criar caderno para iniciar um novo kernel de caderno com a configuração de imagem e ciclo de vida selecionada.

Etapa 4: visualizar logs de uma configuração de ciclo de vida

Você pode visualizar os registros da configuração do ciclo de vida depois que ela for anexada a um domínio ou perfil de usuário.

  1. Primeiro, forneça acesso CloudWatch à sua função AWS Identity and Access Management (IAM). Adicione permissões de leitura para o grupo de log e fluxos de log a seguir.

    • Grupo de logs:/aws/sagemaker/studio

    • Fluxo de logs:domain/user-profile/app-type/app-name/LifecycleConfigOnStart

    Para obter informações sobre como adicionar permissões, consulte Habilitar o registro em determinados AWS serviços.

  2. No Studio Classic, navegue até o ícone Running Terminals and Kernels ( Black square icon representing a placeholder or empty image. ) para monitorar sua configuração do ciclo de vida.

  3. Selecione uma aplicação na lista de aplicativos em execução. Aplicativos com configurações de ciclo de vida anexadas têm um ícone indicador anexado Code brackets symbol representing programming or markup languages. .

  4. Selecione o ícone indicador do seu aplicativo. Isso abre um novo painel que lista a configuração do ciclo de vida.

  5. No novo painel, selecione View logs. Isso abre uma nova guia que exibe os registros.