Migrar a interface do usuário do Studio Classic para o Studio

1. Obtenha o ID de domínio do seu domínio existente.

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

   2. No painel de navegação esquerdo, expanda Configurações administrativas e escolha Domínios.

   3. Escolha o domínio existente.

   4. Na página Detalhes do Domínio, escolha a guia Configurações do Domínio.

   5. Copie o ID do domínio.

2. Adicione o ID de domínio do seu domínio existente.

   export REF_DOMAIN_ID="domain-id"
   export SM_REGION="region"

3. Use describe-domain para obter informações importantes sobre o domínio existente.

   export REF_EXECROLE=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.DefaultUserSettings.ExecutionRole')
   export REF_VPC=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.VpcId')
   export REF_SIDS=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.SubnetIds | join(",")')
   export REF_SGS=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.DefaultUserSettings.SecurityGroups | join(",")')
   export AUTHMODE=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.AuthMode')

4. Valide os parâmetros.

   echo "Execution Role: $REF_EXECROLE || VPCID: $REF_VPC || SubnetIDs: $REF_SIDS || Security GroupIDs: $REF_SGS || AuthMode: $AUTHMODE"

5. Crie um domínio de teste usando as configurações do domínio existente.

   IFS=',' read -r -a subnet_ids <<< "$REF_SIDS"
   IFS=',' read -r -a security_groups <<< "$REF_SGS"
   security_groups_json=$(printf '%s\n' "${security_groups[@]}" | jq -R . | jq -s .)
   
   aws sagemaker create-domain \
   --domain-name "TestV2Config" \
   --vpc-id $REF_VPC \
   --auth-mode $AUTHMODE \
   --subnet-ids "${subnet_ids[@]}" \
   --app-network-access-type VpcOnly \
   --default-user-settings "
   {
       \"ExecutionRole\": \"$REF_EXECROLE\",
       \"StudioWebPortal\": \"ENABLED\",
       \"DefaultLandingUri\": \"studio::\",
       \"SecurityGroups\": $security_groups_json
   }
   "

6. Depois que o domínio de teste estiver In Service pronto, use o ID do domínio de teste para criar um perfil de usuário. Esse perfil de usuário é usado para iniciar e testar aplicativos.

   aws sagemaker create-user-profile \
   --region="$SM_REGION" --domain-id=test-domain-id \
   --user-profile-name test-network-user

1. Adicione o ID do domínio de teste.

   export TEST_DOMAIN="test-domain-id"
   export SM_REGION="region"

2. Liste todos os aplicativos no domínio que estão em execução.

   active_apps_json=$(aws sagemaker list-apps --region=$SM_REGION --domain-id=$TEST_DOMAIN)
   echo $active_apps_json

3. Analise a JSON lista de aplicativos em execução e exclua-os. Se os usuários tentarem criar um aplicativo para o qual não têm permissões, pode haver espaços que não foram capturados no script a seguir. Você deve excluir manualmente esses espaços.

   echo "$active_apps_json" | jq -c '.Apps[]' | while read -r app;
   do
       if echo "$app" | jq -e '. | has("SpaceName")' > /dev/null;
       then
           app_type=$(echo "$app" | jq -r '.AppType')
           app_name=$(echo "$app" | jq -r '.AppName')
           domain_id=$(echo "$app" | jq -r '.DomainId')
           space_name=$(echo "$app" | jq -r '.SpaceName')
   
           echo "Deleting App - AppType: $app_type || AppName: $app_name || DomainId: $domain_id || SpaceName: $space_name"
           aws sagemaker delete-app --region=$SM_REGION --domain-id=$domain_id \
           --app-type $app_type --app-name $app_name --space-name $space_name
   
           echo "Deleting Space - AppType: $app_type || AppName: $app_name || DomainId: $domain_id || SpaceName: $space_name"
           aws sagemaker delete-space --region=$SM_REGION --domain-id=$domain_id \
           --space-name $space_name
       else
   
           app_type=$(echo "$app" | jq -r '.AppType')
           app_name=$(echo "$app" | jq -r '.AppName')
           domain_id=$(echo "$app" | jq -r '.DomainId')
           user_profile_name=$(echo "$app" | jq -r '.UserProfileName')
   
           echo "Deleting Studio Classic - AppType: $app_type || AppName: $app_name || DomainId: $domain_id || UserProfileName: $user_profile_name"
           aws sagemaker delete-app --region=$SM_REGION --domain-id=$domain_id \
           --app-type $app_type --app-name $app_name --user-profile-name $user_profile_name
   
       fi
   
   done

4. Exclua o perfil do usuário de teste.

   aws sagemaker delete-user-profile \
   --region=$SM_REGION --domain-id=$TEST_DOMAIN \
   --user-profile-name "test-network-user"

5. Exclua o domínio de teste.

   aws sagemaker delete-domain \
   --region=$SM_REGION --domain-id=$TEST_DOMAIN

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

2. No painel de navegação esquerdo, expanda Configurações administrativas e escolha Domínios.

3. Escolha o domínio existente para o qual você deseja habilitar o Studio como a experiência padrão.

4. Na página de detalhes do domínio, expanda Ativar o novo Studio.

5. (Opcional) Para ver os detalhes sobre as etapas envolvidas na ativação do Studio como sua experiência padrão, escolha Exibir detalhes. A página mostra o seguinte.

   • Na seção Visão geral do SageMaker Studio, você pode ver os aplicativos incluídos ou disponíveis na interface web do Studio.

   • Na seção Processo de capacitação, você pode ver as descrições das tarefas do fluxo de trabalho para habilitar o Studio.

     nota

     Você precisará migrar seus dados manualmente. Para obter instruções sobre como migrar seus dados, consulte(Opcional) Migrar dados do Studio Classic para o Studio.

   • Na seção Reverter para a experiência do Studio Classic, você pode ver como voltar para o Studio Classic depois de ativar o Studio como sua experiência padrão.

6. Para iniciar o processo de habilitar o Studio como sua experiência padrão, escolha Habilitar o novo Studio.

7. Na seção Especificar e configurar a função, você pode visualizar os aplicativos padrão que são incluídos automaticamente no Studio.

   Para impedir que os usuários executem esses aplicativos, escolha a função AWS Identity and Access Management (IAM) que tenha uma IAM política que negue o acesso. Para obter informações sobre como criar uma política para limitar o acesso, consulteEtapa 1: atualizar as permissões de criação do aplicativo.

8. Na seção Escolha o bucket padrão do S3 para anexar a CORS política, você pode conceder ao Studio acesso aos buckets do Amazon S3. O bucket padrão do Amazon S3, nesse caso, é o bucket padrão do Amazon S3 para seu Studio Classic. Nesta etapa, você pode fazer o seguinte:

   • Verifique o bucket Amazon S3 padrão do domínio ao qual anexar a CORS política. Se o seu domínio não tiver um bucket padrão do Amazon S3, SageMaker crie um bucket do Amazon S3 com a política correta anexadaCORS.

   • Você pode incluir 10 buckets adicionais do Amazon S3 aos quais anexar a CORS política.

     Se quiser incluir mais de 10 compartimentos, você pode adicioná-los manualmente. Para obter mais informações sobre como anexar manualmente a CORS política aos seus buckets do Amazon S3, consulte. (Opcional) Atualize sua CORS política para acessar os buckets do Amazon S3

   Para continuar, marque a caixa de seleção ao lado de Você concorda em substituir alguma CORS política existente nos buckets Amazon S3 escolhidos? .

9. A seção Migrar dados contém informações sobre os diferentes volumes de armazenamento de dados do Studio Classic e do Studio. Seus dados não serão migrados automaticamente por meio desse processo. Para obter instruções sobre como migrar seus dados, configurações de ciclo de vida e JupyterLab extensões, consulte. (Opcional) Migrar dados do Studio Classic para o Studio

10. Depois de concluir as tarefas na página e verificar sua configuração, escolha Habilitar o novo Studio.

Para adicionar uma CORS configuração a um bucket do Amazon S3

1. Verifique se há um bucket do Amazon S3 no mesmo domínio existente com o Região da AWS seguinte nome. Para obter instruções, consulte Visualização das propriedades de um bucket do Amazon S3.

   sagemaker-region-account-id

2. Adicione uma CORS configuração com o seguinte conteúdo ao bucket padrão do Amazon S3. Para obter instruções, consulte Como configurar o compartilhamento de recursos entre origens () CORS.

   [
       {
           "AllowedHeaders": [
               "*"
           ],
           "AllowedMethods": [
               "POST",
               "PUT",
               "GET",
               "HEAD",
               "DELETE"
           ],
           "AllowedOrigins": [
               "https://*.sagemaker.aws"
           ],
           "ExposeHeaders": [
               "ETag",
               "x-amz-delete-marker",
               "x-amz-id-2",
               "x-amz-request-id",
               "x-amz-server-side-encryption",
               "x-amz-version-id"
           ]
       }
   ]

Para conceder permissões para a funcionalidade do Data Wrangler dentro do Canvas

1. Anexe a política AWS gerenciada AmazonSageMakerFullAccessà IAM função do seu usuário. Para ver um procedimento que mostra como anexar IAM políticas a uma função, consulte Adicionar permissões de IAM identidade (console) no Guia do AWS IAM usuário.

   Se essa política de permissões for muito permissiva para seu caso de uso, você poderá criar políticas com escopo reduzido que incluam pelo menos as seguintes permissões:

   {
       "Sid": "AllowStudioActions",
       "Effect": "Allow",
       "Action": [
           "sagemaker:CreatePresignedDomainUrl",
           "sagemaker:DescribeDomain",
           "sagemaker:ListDomains",
           "sagemaker:DescribeUserProfile",
           "sagemaker:ListUserProfiles",
           "sagemaker:DescribeSpace",
           "sagemaker:ListSpaces",
           "sagemaker:DescribeApp",
           "sagemaker:ListApps"
       ],
       "Resource": "*"
   },
   {
       "Sid": "AllowAppActionsForUserProfile",
       "Effect": "Allow",
       "Action": [
           "sagemaker:CreateApp",
           "sagemaker:DeleteApp"
       ],
       "Resource": "arn:aws:sagemaker:region:account-id:app/domain-id/user-profile-name/canvas/*",
       "Condition": {
           "Null": {
               "sagemaker:OwnerUserProfileArn": "true"
           }
       }
   }

2. Anexe a política AWS gerenciada AmazonSageMakerCanvasDataPrepFullAccessà IAM função do seu usuário.

Para anexar IAM políticas a uma função de execução

1. Encontre a função de execução anexada ao seu perfil de SageMaker usuário

   1. No SageMaker consolehttps://console.aws.amazon.com/sagemaker/, navegue até Domínios e escolha seu SageMaker domínio.

   2. A função de execução ARN está listada em Função de execução na página Detalhes do usuário do seu perfil de usuário. Anote o nome da função de execução noARN.

   3. No IAM console https://console.aws.amazon.com/iam/, escolha Funções.

   4. Pesquise sua função pelo nome no campo de pesquisa.

   5. Selecione a função.

2. Adicionar políticas à função

   1. No IAM console https://console.aws.amazon.com/iam/, escolha Funções.

   2. Pesquise sua função pelo nome no campo de pesquisa.

   3. Selecione a função.

   4. Na guia Permissões, navegue até o menu suspenso Adicionar permissões.

   5. • Para políticas gerenciadas: selecione Anexar políticas, pesquise o nome da política de gerenciamento que você deseja anexar.

        Selecione a política e escolha Adicionar permissões.

      • Para políticas em linha: selecione Criar política em linha, cole sua política na JSON guia, escolha Avançar, nomeie sua política e escolha Criar.

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

2. No painel de navegação esquerdo, expanda Configurações administrativas e escolha Domínios.

3. Escolha o domínio existente a ser revertido.

4. Escolha a guia Configurações do domínio.

5. Na página de detalhes do domínio, navegue até a seção Reverter para a experiência do Studio Classic.

6. Na seção Reverter para a experiência do Studio Classic, escolha o processo Reverter para o Studio Classic. Isso levará você à página Reverter domínio para o Studio Classic.

7. Na página Reverter domínio para Studio Classic, conclua as tarefas a seguir e selecione as caixas correspondentes. Execute as seguintes tarefas antes de reverter a experiência padrão do domínio existente para o Studio Classic:

   1. Etapa 1 - O backup de seus dados contém informações sobre os diferentes volumes de armazenamento de dados do Studio Classic e do Studio. Seus dados não serão migrados automaticamente por meio desse processo. Para obter instruções sobre como migrar seus dados, configurações de ciclo de vida e JupyterLab extensões, consulte. (Opcional) Migrar dados do Studio Classic para o Studio

   2. Exclua todos os aplicativos do Code Editor do Studio JupyterLab e o lembrará de excluir seus aplicativos do Studio para evitar custos adicionais. Essa não é uma etapa obrigatória porque você pode excluir seus aplicativos e espaços depois de reverter o domínio existente para o Studio Classic. Recomendamos que você exclua seus aplicativos e espaços não utilizados para evitar custos adicionais com eles.

      Para obter instruções sobre como excluir aplicativos e espaços do seu domínio, consulteExclua ou interrompa a execução de instâncias, aplicativos e espaços no Studio.

   3. Etapa 3 - Confirme que você deseja reverter esse domínio para o Studio Classic e solicita que você confirme sua intenção de reverter a experiência padrão do domínio existente para o Studio Classic.

   4. Fornecer feedback oferece a opção de deixar comentários sobre o motivo pelo qual você está revertendo o domínio existente para o Studio Classic.

8. Depois que todas as etapas forem concluídas e as caixas de seleção estiverem preenchidas, o botão Reverter domínio para o Studio Classic ficará disponível.

9. Depois de concluir as tarefas na página e verificar suas alterações, escolha Reverter domínio para Studio Classic para reverter o domínio existente.