Asociación de una versión de la imagen a un dominio mediante la consola Adjunta una versión de imagen existente a tu dominio mediante el AWS CLI

Adjunta una SageMaker imagen personalizada

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 necesario 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 de tipo AccessDenied «» al intentar crear recursos. Para obtener más información, consulte Proporcione permisos para etiquetar los recursos de SageMaker IA.

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

Esta guía muestra cómo adjuntar una imagen de RStudio personalizada a tu dominio de Amazon SageMaker AI mediante la consola SageMaker AI o el AWS Command Line Interface (AWS CLI).

Para usar una SageMaker imagen personalizada, debes adjuntar una imagen de RStudio personalizada a tu dominio. Cuando se asocia una versión de la imagen, aparece en RStudio Launcher y está disponible en la lista desplegable Seleccionar imagen. Utilice el menú desplegable para cambiar la imagen utilizada por RStudio.

Hay un límite en el número de versiones de la imagen que se pueden asociar. Una vez alcanzado el límite, debe eliminar una versión para asociar otra versión de la imagen.

Temas

Asociación de una versión de la imagen a un dominio mediante la consola
Adjunta una versión de imagen existente a tu dominio mediante el AWS CLI

Asociación de una versión de la imagen a un dominio mediante la consola

Puedes adjuntar una versión de SageMaker imagen personalizada a tu dominio mediante el panel de control de la consola SageMaker AI. También puedes crear una SageMaker imagen personalizada y una versión de imagen y, a continuación, adjuntar esa versión a tu dominio.

Para asociar una imagen existente

Abre la consola Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, elija Dominios.
Seleccione el dominio que desee.
Seleccione Entorno.
En Imágenes de Custom SageMaker Studio Classic adjuntas al dominio, selecciona Adjuntar imagen.
Para Fuente de imagen, elija Imagen existente o Nueva imagen.

Si seleccionas Imagen existente, elige una imagen de la tienda de SageMaker imágenes de Amazon.

Si selecciona Nueva imagen, proporcione la ruta de registro de Amazon ECR para la imagen de Docker. La ruta debe estar en la misma Región de AWS que el dominio. El repositorio de Amazon ECR debe estar en la misma cuenta que su dominio, o bien deben estar habilitados los permisos multicuenta para la SageMaker IA.
Elija en la lista una imagen existente.
Elija una versión de la imagen en la lista.
Elija Siguiente.
Introduzca valores para Nombre de la imagen, Nombre para mostrar de la imagen y descripción.
Elija el rol de IAM. Para obtener más información, consulte Crear una imagen personalizada de RStudio.
(Opcional) Agregue etiquetas para la imagen.
(Opcional) Elija Añadir nueva etiqueta y, a continuación, agregue una etiqueta de configuración.
En Tipo de imagen, seleccione Imagen de RStudio.
Elija Enviar.

Espere a que la versión de la imagen se asocie al dominio. Cuando se asocie la versión, aparecerá en la lista Imágenes personalizadas y se resaltará brevemente.

Adjunta una versión de imagen existente a tu dominio mediante el AWS CLI

Hay dos métodos para asociar la versión de la imagen al dominio mediante la AWS CLI. En el primer método, creará un nuevo dominio con la versión asociada. Este método es más sencillo, pero debe especificar la información y el rol de ejecución de Amazon Virtual Private Cloud (Amazon VPC) necesarios para crear el dominio.

Si ya se ha incorporado al dominio, puede emplear el segundo método para asociar la versión de la imagen al dominio actual. En este caso, no es necesario especificar la información y el rol de ejecución de Amazon VPC. Después de asociar la versión, elimine todas las aplicaciones del dominio y reinicie RStudio.

Adjunta la SageMaker imagen a un dominio nuevo

Para usar este método, debe especificar una función de ejecución que tenga la AmazonSageMakerFullAccesspolítica adjunta.

Siga los siguientes pasos para crear el dominio y adjuntar la imagen de SageMaker IA personalizada:

Obtenga su ID de VPC predeterminado y los ID de subred.
Cree el archivo de configuración para el dominio, que especifica la imagen.
Creación del dominio con el archivo de configuración.

Para añadir la SageMaker imagen personalizada a tu dominio

Obtenga su ID de VPC predeterminado.


aws ec2 describe-vpcs \
    --filters Name=isDefault,Values=true \
    --query "Vpcs[0].VpcId" --output text

Respuesta:


vpc-xxxxxxxx

Obtenga sus ID de subred predeterminados mediante el ID de VPC del paso anterior.


aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

Respuesta:


[
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

Cree un archivo de configuración llamado create-domain-input.json. Inserte el ID de VPC, los ID de subred, ImageName y AppImageConfigName desde los pasos anteriores. Dado que no se especifica ImageVersionNumber, se utiliza la versión más reciente de la imagen, que es la única versión en este caso. El rol de ejecución debe cumplir los requisitos de Cómo completar los requisitos previos de.


{
  "DomainName": "domain-with-custom-r-image",
  "VpcId": "<vpc-id>",
  "SubnetIds": [
    "<subnet-ids>"
  ],
  "DomainSettings": {
    "RStudioServerProDomainSettings": {
      "DomainExecutionRoleArn": "<execution-role>"
    }
  },
  "DefaultUserSettings": {
    "ExecutionRole": "<execution-role>",
    "RSessionAppSettings": {
      "CustomImages": [
        {
         "AppImageConfigName": "rstudio-custom-config",
         "ImageName": "rstudio-custom-image"
        }
      ]
     }
  },
  "AuthMode": "IAM"
}

Crea el dominio con la SageMaker imagen personalizada adjunta.


aws sagemaker create-domain \
    --cli-input-json file://create-domain-input.json

Respuesta:


{
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
    "Url": "https://domain-id.studio.region.sagemaker.aws/..."
}

Adjunta la SageMaker imagen a un dominio existente

En este método se da por sentado que ya se ha incorporado al dominio. Para obtener más información, consulte Descripción general del dominio Amazon SageMaker AI.

nota

Debe eliminar todas las aplicaciones del dominio antes de actualizarlo con la nueva versión de la imagen. Para obtener información acerca de cómo eliminar estas aplicaciones, consulteEliminar un dominio de Amazon SageMaker AI.

Sigue los siguientes pasos para añadir la SageMaker imagen a tu dominio actual.

Consíguelo DomainID desde la consola de SageMaker IA.
Utilice el DomainID para obtener el DefaultUserSettings para el dominio.
Agregue el ImageName y la AppImageConfig como una CustomImage a la DefaultUserSettings.
Actualice el dominio para incluir la imagen personalizada.

Para añadir la SageMaker imagen personalizada a tu dominio

Abre la consola Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, elija Dominios.
Seleccione el dominio que desee.
Seleccione Configuración del dominio.
En Configuración general, busque el ID del dominio. El ID tendrá el siguiente formato: d-xxxxxxxxxxxx.

Utilice el ID de dominio para obtener la descripción del dominio.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Respuesta:


{
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Guardar la sección DefaultUserSettings de la respuesta en un archivo denominado update-domain-input.json.

Inserte el ImageName y la AppImageConfigName de los pasos anteriores como imagen personalizada. Dado que no se especifica ImageVersionNumber, se utiliza la versión más reciente de la imagen, que es la única versión en este caso.


{
    "DefaultUserSettings": {
        "RSessionAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "rstudio-custom-image",
                 "AppImageConfigName": "rstudio-custom-config"
              }
           ]
        }
    }
}

Utilice el ID de dominio y el archivo de configuración de usuario predeterminado para actualizar el dominio.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://update-domain-input.json

Respuesta:


{
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}

Elimine la aplicación RStudioServerPro. Debe reiniciar la aplicación de dominio compartido RStudioServerPro para que la IU de RStudio Launcher recoja los cambios más recientes.
```
aws sagemaker delete-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default
```

Cree una nueva aplicación RStudioServerPro. Debe crear esta aplicación mediante AWS CLI.


aws sagemaker create-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Creación de una imagen

Iniciar una imagen personalizada