Creación de un espacio compartido

importante

Las políticas de IAM personalizadas que permiten a Amazon SageMaker Studio o Amazon SageMaker Studio Classic crear SageMaker recursos de Amazon también deben conceder permisos para añadir etiquetas a esos recursos. El permiso para añadir etiquetas a los recursos es obligatorio porque Studio y Studio Classic etiquetan automáticamente todos los recursos que crean. Si una política de IAM permite a Studio y Studio Classic crear recursos, pero no permite el etiquetado, se pueden producir errores AccessDenied «» al intentar crear recursos. Para obtener más información, consulte Proporcione permisos para etiquetar SageMaker los recursos.

AWS Políticas gestionadas para Amazon SageMakerque otorgan permisos para crear SageMaker recursos ya incluyen permisos para añadir etiquetas al crear esos recursos.

En el siguiente tema se muestra cómo crear un espacio compartido en un SageMaker dominio de Amazon existente. Si has creado tu dominio sin soporte para espacios compartidos, debes añadir soporte para espacios compartidos a tu dominio existente antes de poder crear un espacio compartido.

Agrega soporte para espacios compartidos a un dominio existente

Puedes usar la SageMaker consola o la AWS CLI para añadir compatibilidad con espacios compartidos a un dominio existente. Si el dominio utiliza el acceso a la VPC only red, solo puede añadir soporte para espacios compartidos mediante el AWS CLI.

Consola

Realice el siguiente procedimiento para añadir la compatibilidad con los espacios compartidos de Studio Classic a un dominio existente desde la SageMaker consola.

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

2. En el panel de navegación izquierdo, seleccione Configuraciones de administración.

3. En Configuraciones de administración, selecciona dominios.

4. En la lista de dominios, selecciona el dominio para el que quieres abrir la página de configuración del dominio.

5. En la página de detalles del dominio, selecciona la pestaña de configuración del dominio.

6. Elija Edit.

7. Para la función de ejecución predeterminada de Space, defina una función de IAM que se utilice de forma predeterminada para todos los espacios compartidos creados en el dominio.

8. Elija Siguiente.

9. Elija Siguiente.

10. Elija Siguiente.

11. Elija Enviar.

AWS CLI

Studio Classic

Ejecute el siguiente comando desde la terminal de su máquina local para añadir la configuración de espacio compartido predeterminada a un dominio desde. AWS CLI Si va a añadir la configuración de espacio compartido predeterminada a un dominio de una Amazon VPC, también debe incluir una lista de grupos de seguridad. Los espacios compartidos de Studio Classic solo admiten el uso de JupyterLab 3 ARN de imagen. Para obtener más información, consulte JupyterLab Control de versiones.

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=system,SageMakerImageArn=sagemaker-image-arn}},SecurityGroups=[security-groups]"

Utilice el siguiente comando para comprobar que se ha actualizado la configuración predeterminada del espacio compartido.

aws --region region \
sagemaker describe-domain \
--domain-id domain-id

JupyterLab

Ejecute el siguiente comando desde la terminal de su máquina local para agregar la configuración de espacio compartido predeterminada a un dominio desde AWS CLI. Si va a añadir la configuración de espacio compartido predeterminada a un dominio de una Amazon VPC, también debe incluir una lista de grupos de seguridad. Los espacios compartidos de Studio Classic solo admiten el uso de JupyterLab 4 ARN de imagen. Para obtener más información, consulte JupyterLab Control de versiones.

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn", JupyterLabAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn, SecurityGroups=[security-groups]"

Utilice el siguiente comando para comprobar que se ha actualizado la configuración predeterminada del espacio compartido.

aws --region region \
sagemaker describe-domain \
--domain-id domain-id

Creación de un espacio compartido

En las siguientes secciones se muestra cómo crear un espacio compartido desde la SageMaker consola de Amazon, Amazon SageMaker Studio o la AWS CLI.

Crea desde Studio

Utilice los siguientes procedimientos para crear un espacio compartido en un dominio de Studio.

Studio Classic

1. Diríjase a Studio siguiendo los pasos que se indican a continuaciónLanza Amazon SageMaker Studio.

2. En la interfaz de usuario de Studio, busca el panel de aplicaciones en la parte izquierda.

3. En el panel de aplicaciones, selecciona Studio Classic.

4. Elija Crear un espacio de Studio Classic

5. En la ventana emergente, introduce un nombre para el espacio.

6. Selecciona Crear espacio.

JupyterLab

1. Ve a Studio siguiendo los pasos que se indicanLanza Amazon SageMaker Studio.

2. En la interfaz de usuario de Studio, busca el panel de aplicaciones en la parte izquierda.

3. En el panel de aplicaciones, selecciona JupyterLab.

4. Elija Crear JupyterLab espacio

5. En la ventana emergente, introduce un nombre para el espacio.

6. Selecciona Crear espacio.

Creación desde la consola

Complete el siguiente procedimiento para crear un espacio compartido en un dominio desde la SageMaker consola.

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

2. En el panel de navegación izquierdo, seleccione Configuraciones de administración.

3. En Configuraciones de administración, selecciona dominios.

4. En la lista de dominios, selecciona el dominio para el que quieres crear un espacio compartido.

5. En la página de detalles del dominio, selecciona la pestaña Administración del espacio.

6. Seleccione Crear.

7. Introduzca un nombre para el espacio compartido. Los nombres de los espacios compartidos de un dominio deben ser únicos. La función de ejecución del espacio compartido se establece en la función de ejecución de IAM del dominio.

Crear a partir de AWS CLI

En esta sección se muestra cómo crear un espacio compartido desde la AWS CLI.

No se puede establecer el rol de ejecución de un espacio compartido al crearlo o actualizarlo. Solo se DefaultDomainExecRole puede configurar al crear o actualizar el dominio. Los espacios compartidos solo admiten el uso de JupyterLab 3 ARN de imagen. Para obtener más información, consulte JupyterLab Control de versiones.

Para crear un espacio compartido desde AWS CLI, ejecute uno de los siguientes comandos desde la terminal de su máquina local.

Studio Classic

aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--space-settings '{
  "JupyterServerAppSettings": {
    "DefaultResourceSpec": {
      "SageMakerImageArn": "sagemaker-image-arn",
      "InstanceType": "system"
    }
  }
}'

JupyterLab

aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--ownership-settings "{"OwnerUserProfileName": "user-profile-name"}" \
--space-sharing-settings "{"SharingType": "Shared"}" \
--space-settings "{"AppType": "JupyterLab"}"