Migración de la interfaz de usuario de Studio Classic a Studio

1. Obtenga el ID de dominio de su dominio actual.

   1. Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.

   2. En el panel de navegación izquierdo, expanda Configuraciones de administración y elija Dominios.

   3. Elija el dominio existente.

   4. En la página Detalles del dominio, elija la pestaña Configuración del dominio.

   5. Copie el ID de dominio.

2. Agregue el ID de dominio de su dominio existente.

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

3. Use describe-domain para obtener información importante sobre el dominio 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 los parámetros.

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

5. Cree un dominio de prueba con las configuraciones del dominio 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. Una vez que el dominio de prueba se encuentre en el estado In Service, utilice el ID del dominio de prueba para crear un perfil de usuario. Este perfil de usuario se utiliza para inicializar y probar aplicaciones.

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

1. Agregue el ID del dominio de prueba.

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

2. Enumere todas las aplicaciones del dominio que se encuentren en estado de ejecución.

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

3. Analice la lista de JSON de aplicaciones en ejecución y elimínelas. Si los usuarios han intentado crear una aplicación para la que no tienen permisos, es posible que haya espacios que no se capturen en el siguiente script. Debe eliminar esos espacios 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. Elimine el perfil de usuario de prueba.

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

5. Elimine el dominio de prueba.

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

1. Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.

2. En el panel de navegación izquierdo, expanda Configuraciones de administración y elija Dominios.

3. Elija el dominio existente para el cual desee habilitar Studio como experiencia predeterminada.

4. En la página Detalles del dominio, expanda Activar el nuevo Studio.

5. (Opcional) Para ver información sobre los pasos necesarios para habilitar Studio como experiencia predeterminada, seleccione Ver detalles. En la página se muestra lo siguiente:

   • En la sección Descripción general de SageMaker Studio, puede ver las aplicaciones que están incluidas o disponibles en la interfaz web de Studio.

   • En la sección Proceso de habilitación, se muestran las descripciones de las tareas del flujo de trabajo de habilitación de Studio.

     nota

     Tendrá que migrar los datos manualmente. Para obtener instrucciones sobre la migración de los datos, consulte (Opcional) Migración de datos de Studio Classic a Studio.

   • En la sección Revertir a la experiencia de Studio Classic, se indica cómo revertir a Studio Classic después de haber habilitado Studio como experiencia predeterminada.

6. Para iniciar el proceso de habilitación de Studio como experiencia predeterminada, seleccione Activar el nuevo Studio.

7. En la sección Especificar y configurar el rol, se muestran las aplicaciones predeterminadas que se incluyen automáticamente en Studio.

   Para evitar que los usuarios ejecuten estas aplicaciones, elija el rol de AWS Identity and Access Management (IAM) cuya política de IAM deniegue el acceso. Para obtener información sobre cómo crear una política que limite el acceso, consulte Paso 1: actualización de permisos de creación de aplicaciones.

8. En la sección Elegir el bucket de S3 predeterminado para asociar la política de CORS, puede conceder a Studio acceso a los buckets de Amazon S3. El bucket de Amazon S3 predeterminado, en este caso, es el bucket de Amazon S3 predeterminado de Studio Classic. En este paso, puede hacer lo siguiente:

   • Comprobar el bucket de Amazon S3 predeterminado del dominio al que desea asociar la política de CORS. Si el dominio no tiene un bucket de Amazon S3 predeterminado, SageMaker AI crea un bucket de Amazon S3 con la política de CORS correcta asociada.

   • Puede incluir 10 buckets de Amazon S3 adicionales a los que asociar la política de CORS.

     Si desea incluir más de 10 buckets, puede agregarlos manualmente. Para obtener más información sobre cómo asociar manualmente la política de CORS a sus buckets de Amazon S3, consulte (Opcional) Actualización de la política de CORS para obtener acceso a los buckets de Amazon S3.

   Para continuar, seleccione la casilla de verificación situada junto a ¿Acepta anular todas las políticas de CORS existentes en los buckets de Amazon S3 elegidos?

9. La sección Migrar datos contiene información sobre los distintos volúmenes de almacenamiento de datos de Studio Classic y Studio. Los datos no se migrarán automáticamente mediante este proceso. Para obtener instrucciones sobre la migración de datos, las configuraciones de ciclo de vida y las extensiones de JupyterLab, consulte (Opcional) Migración de datos de Studio Classic a Studio.

10. Cuando haya completado las tareas de la página y haya comprobado la configuración, seleccione Activar el nuevo Studio.

Adición de una configuración de CORS a un bucket de S3

1. Compruebe que haya un bucket de Amazon S3 en la misma Región de AWS que el dominio existente con el siguiente nombre. Para obtener instrucciones, consulte Visualización de las propiedades para un bucket de S3.

   sagemaker-region-account-id

2. Agregue una configuración de CORS con el siguiente contenido al bucket de Amazon S3 predeterminado. Para obtener instrucciones, consulte Configuración del uso compartido de recursos entre orígenes (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"
           ]
       }
   ]

Concesión de permisos para la funcionalidad de Data Wrangler en Canvas

1. Asocie la política administrada de AWS AmazonSageMakerFullAccess al rol de IAM de su usuario. Para obtener más información sobre cómo asociar políticas de IAM a un rol, consulte Adición de permisos de identidad de IAM (consola) en la AWSGuía del usuario de IAM.

   Si esta política de permisos es demasiado permisiva para su caso de uso, puede crear políticas específicas que incluyan al menos los siguientes permisos:

   {
       "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. Asocie la política administrada de AWS AmazonSageMakerCanvasDataPrepFullAccess al rol de IAM de su usuario.

Para asociar políticas de IAM a un rol de ejecución

1. Búsqueda del rol de ejecución asociado a su perfil de usuario de SageMaker AI

   1. En la consola de SageMaker AI https://console.aws.amazon.com/sagemaker/, vaya a Dominios y, a continuación, elija su dominio de SageMaker AI.

   2. El ARN del rol de ejecución aparece en la sección Rol de ejecución de la página Detalles del usuario de su perfil de usuario. Anote el nombre del rol de ejecución que figura en el ARN.

   3. En la consola de IAM https://console.aws.amazon.com/iam/, elija Roles.

   4. Busque su rol por nombre en el campo de búsqueda.

   5. Seleccione el rol.

2. Agregue políticas al rol.

   1. En la consola de IAM https://console.aws.amazon.com/iam/, elija Roles.

   2. Busque su rol por nombre en el campo de búsqueda.

   3. Seleccione el rol.

   4. En la pestaña Permisos, vaya al menú desplegable Agregar permisos.

   5. • Para políticas administradas: seleccione Asociar políticas y busque el nombre de la política de administración que desea asociar.

        Seleccione la política y, a continuación, seleccione Agregar permisos.

      • Para las políticas en línea: seleccione Crear política insertada, pegue la política en la pestaña JSON, seleccione Siguiente, asigne un nombre a la política y seleccione Crear.