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 console do Amazon SageMaker AI em https://console.aws.amazon.com/sagemaker/.

   2. No painel de navegação à esquerda, escolha Configurações do administrador e selecione 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 for In Service, 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 aplicações.

   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 as aplicações 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 lista JSON de aplicações em execução e exclua-os. Se os usuários tentarem criar uma aplicação para o qual não têm permissões, pode haver espaços que não foram capturados no script a seguir. Será necessário excluir esses espaços manualmente.

   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 de 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 console do Amazon SageMaker AI em https://console.aws.amazon.com/sagemaker/.

2. No painel de navegação à esquerda, escolha Configurações do administrador e selecione Domínios.

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

4. Na página de Detalhes do domínio, abra 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 as aplicações padrão que são incluídos automaticamente no Studio.

   Para impedir que os usuários executem esses aplicações, escolha o perfil do AWS Identity and Access Management (IAM) que tem uma política do IAM que nega o acesso. Para obter informações sobre como criar uma política para limitar o acesso, consulte Etapa 1: atualizar as permissões de criação de aplicações.

8. Na seção Escolha o bucket padrão do S3 para anexar a política do CORS, você pode dar 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 o Studio Classic. Nesta etapa, você pode fazer o seguinte:

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

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

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

   Para continuar, marque a caixa de seleção ao lado de Você concorda em substituir alguma política de CORS existente nos buckets do 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.

Adicionar uma configuração CORS 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 Visualizar as propriedades de um bucket do Amazon S3.

   sagemaker-region-account-id

2. Adicione uma configuração CORS com o conteúdo a seguir ao bucket padrão do Amazon S3. Para obter instruções, consulte Configurar o compartilhamento de recursos de origem cruzada (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"
           ]
       }
   ]

Conceder permissões para a funcionalidade do Data Wrangler dentro do Canvas

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

   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à função do IAM do seu usuário.

Anexar políticas do IAM a um perfil de execução

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

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

   2. O ARN do perfil de execução está listado em Perfil de execução na página Detalhes do usuário do seu perfil de usuário. Observe o nome do perfil de execução no ARN.

   3. No console do IAM https://console.aws.amazon.com/iam/, escolha Roles.

   4. Procure sua função por nome no campo de pesquisa.

   5. Selecione a função.

2. Adicionar políticas ao perfil

   1. No console do IAM https://console.aws.amazon.com/iam/, escolha Roles.

   2. Procure sua função por 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 guia JSON, escolha Avançar, nomeie sua política e escolha Criar.