第 1 阶段：将用户界面从 Studio Classic 迁移到

1. 获取现有域名的域名 ID。

   1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

   2. 在左侧导航窗格中，展开 “管理员配置”，然后选择 “域”。

   3. 选择现有域。

   4. 在域详细信息页面上，选择域设置选项卡。

   5. 复制域名。

2. 添加现有域名的域名 ID。

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

3. 用于describe-domain获取有关现有域名的重要信息。

   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. 验证参数。

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

5. 使用现有域中的配置创建测试域。

   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. 测试域名完成后In Service，使用测试域的 ID 创建用户个人资料。此用户配置文件用于启动和测试应用程序。

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

1. 添加测试域名的 ID。

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

2. 列出域中所有处于运行状态的应用程序。

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

3. 解析正在运行的应用程序的 JSON 列表并将其删除。如果用户尝试创建他们没有权限的应用程序，则可能存在未在以下脚本中捕获的空格。您必须手动删除这些空间。

   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. 删除测试用户个人资料。

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

5. 删除测试域。

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

1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

2. 从左侧导航窗格中展开 “管理员配置”，然后选择 “域”。

3. 选择要启用 Studio 作为其默认体验的现有域名。

4. 在域名详细信息页面上，展开启用新 Studio。

5. （可选）要查看有关启用 Studio 作为默认体验所涉及的步骤的详细信息，请选择查看详细信息。该页面显示以下内容。

   • 在 SageMaker Studio 概述部分，您可以查看 Studio 基于 Web 的界面中包含或可用的应用程序。

   • 在 “启用流程” 部分，您可以查看启用 Studio 的工作流任务的描述。

     注意

     您将需要手动迁移数据。有关迁移数据的说明，请参阅第 3 阶段：（可选）将数据从 Studio 经典版迁移到 Studio。

   • 在 “恢复为 Studio 经典版” 体验部分，您可以查看在启用 Studio 作为默认体验后如何恢复到 Studio Classic。

6. 要开始启用 Studio 作为默认体验的过程，请选择启用新 Studio。

7. 在 “指定和配置角色” 部分，您可以查看 Studio 中自动包含的默认应用程序。

   要防止用户运行这些应用程序，请选择具有拒绝访问的 IAM 策略的 Amazon Identity and Access Management (IAM) 角色。有关如何创建限制访问权限的策略的信息，请参阅步骤 1：更新应用程序创建权限。

8. 在选择默认 S3 存储桶以附加 CORS 策略部分，您可以授予 Studio 对 Amazon S3 存储桶的访问权限。在本例中，默认 Amazon S3 存储桶是 Studio Classic 的默认 Amazon S3 存储桶。在此步骤中，您可以执行以下操作：

   • 验证要将 CORS 策略附加到的域的默认 Amazon S3 存储桶。如果您的域名没有默认 Amazon S3 存储桶，请 SageMaker 创建一个附有正确跨域资源共享策略的 Amazon S3 存储桶。

   • 您可以附加 10 个额外的 Amazon S3 存储桶，以便将 CORS 策略附加到该存储桶。

     如果您希望包含 10 个以上的存储桶，则可以手动添加它们。有关手动将 CORS 策略附加到 Amazon S3 存储桶的更多信息，请参阅。（可选）更新您的 CORS 策略以访问 Amazon S3 存储桶

   要继续，请选中 “您是否同意覆盖所选 Amazon S3 存储桶上的任何现有 CORS 策略？” 旁边的复选框 。

9. 迁移数据部分包含有关 Studio Classic 和 Studio 的不同数据存储卷的信息。您的数据不会通过此过程自动迁移。有关迁移数据、生命周期配置和 JupyterLab 扩展插件的说明，请参阅第 3 阶段：（可选）将数据从 Studio 经典版迁移到 Studio。

10. 完成页面上的任务并验证配置后，选择启用新 Studio。

向 Amazon S3 存储桶添加 CORS 配置

1. 验证是否存在与现有域名相同 Amazon Web Services 区域 的 Amazon S3 存储桶，名称如下。有关说明，请参阅查看 Amazon S3 存储桶的属性。

   sagemaker-region-account-id

2. 将包含以下内容的 CORS 配置添加到默认 Amazon S3 存储桶。有关说明，请参阅配置跨域资源共享 (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"
           ]
       }
   ]

在 Canvas 中授予 Data Wrangler 功能的权限

1. 将 Amazon 托管策略附加AmazonSageMakerFullAccess到用户的 IAM 角色。有关向您展示如何将 IAM 策略附加到角色的过程，请参阅 IAM 用户指南中的添加 I Amazon AM 身份权限（控制台）。

   如果此权限策略对您的用例来说过于宽松，则可以创建至少包含以下权限的范围缩小策略：

   {
       "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. 将 Amazon 托管策略附加AmazonSageMakerCanvasDataPrepFullAccess到用户的 IAM 角色。

将 IAM 策略附加到执行角色

1. 查找附加到您的 SageMaker 用户个人资料的执行角色

   1. 在 SageMaker 控制台中https://console.amazonaws.cn/sagemaker/，导航到域名，然后选择您的 SageMaker域名。

   2. 执行角色 ARN 列在您的用户个人资料的 “用户详情” 页面的 “执行角色” 下。记下 ARN 中的执行角色名称。

   3. 在 IAM 控制台 https://console.aws.amazon.com/iam/ 中，选择角色。

   4. 在搜索栏中按姓名搜索您的角色。

   5. 选择角色。

2. 向角色添加策略

   1. 在 IAM 控制台 https://console.aws.amazon.com/iam/ 中，选择角色。

   2. 在搜索栏中按姓名搜索您的角色。

   3. 选择角色。

   4. 在 “权限” 选项卡中，导航到下拉菜单添加权限。

   5. • 对于托管策略：选择附加策略，搜索要附加的管理策略的名称。

        选择策略，然后选择添加权限。

      • 对于内联策略：选择创建内联策略，将您的策略粘贴到 JSON 选项卡中，选择下一步，命名您的策略，然后选择创建。

1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

2. 从左侧导航窗格中展开 “管理员配置”，然后选择 “域”。

3. 选择要还原的现有域。

4. 选择域名设置选项卡。

5. 在域名详情页面上，导航至恢复到 Studio Classic 体验部分。

6. 在恢复到 Studio 经典版体验部分中，选择恢复到 Studio Classic 流程。这将带您进入将域名恢复为 Studio Classic 页面。

7. 在 “将域恢复为 Studio Classic” 页面上，完成以下任务并选中相应的复选框。在将现有域名的默认体验恢复为 Studio Classic 之前，请完成以下任务：

   1. 步骤 1-备份您的数据包含有关 Studio Classic 和 Studio 不同数据存储卷的信息。您的数据不会通过此过程自动迁移。有关迁移数据、生命周期配置和 JupyterLab扩展插件的说明，请参阅第 3 阶段：（可选）将数据从 Studio 经典版迁移到 Studio。

   2. Studio 中的全部删除 JupyterLab 和代码编辑器应用程序会提醒您删除 Studio 应用程序，以免产生额外费用。这不是必需的步骤，因为在将现有域还原为 Studio Classic 后，您可以删除应用程序和空间。我们建议您删除未使用的应用程序和空间，以免产生额外费用。

      有关如何从域中删除应用程序和空间的说明，请参阅删除或停止运行您的 Studio 的实例、应用程序和空间。

   3. 第 3 步——确认您要将此域名恢复为 Studio Classic 要求您确认是否打算将现有域名的默认体验恢复为 Studio Classic。

   4. “提供反馈” 允许您就将现有域名恢复为 Studio Classic 的原因留下反馈的选项。

8. 完成所有步骤并填写复选框后，“将域名恢复为 Studio Classic” 按钮变为可用。

9. 完成页面上的任务并验证所做的更改后，选择将域名恢复为 Studio Classic 以还原现有域名。