Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# SageMaker HyperPod Operaciones de clúster de Slurm
Esta sección proporciona orientación sobre la administración SageMaker HyperPod a través de la interfaz de usuario de la consola de SageMaker IA o la AWS Command Line Interface (CLI). Aprenderás a realizar diversas tareas relacionadas SageMaker HyperPod con si prefieres una interfaz visual o trabajar con comandos.
**Topics**
+ [Administrar los clústeres SageMaker HyperPod de Slurm mediante la consola SageMaker](sagemaker-hyperpod-operate-slurm-console-ui.md)
+ [Administrar los clústeres SageMaker HyperPod de Slurm mediante AWS CLI](sagemaker-hyperpod-operate-slurm-cli-command.md)
# Administrar los clústeres SageMaker HyperPod de Slurm mediante la consola SageMaker
Los temas siguientes proporcionan instrucciones sobre cómo administrar a SageMaker HyperPod través de la interfaz de usuario de la consola.
**Topics**
+ [Crea un SageMaker HyperPod clúster](#sagemaker-hyperpod-operate-slurm-console-ui-create-cluster)
+ [Examine sus SageMaker HyperPod clústeres](#sagemaker-hyperpod-operate-slurm-console-ui-browse-clusters)
+ [Vea los detalles de cada SageMaker HyperPod clúster](#sagemaker-hyperpod-operate-slurm-console-ui-view-details-of-clusters)
+ [Edita un SageMaker HyperPod clúster](#sagemaker-hyperpod-operate-slurm-console-ui-edit-clusters)
+ [Elimina un SageMaker HyperPod clúster](#sagemaker-hyperpod-operate-slurm-console-ui-delete-cluster)
## Crea un SageMaker HyperPod clúster
Consulte las instrucciones [Cómo empezar a SageMaker HyperPod usar la consola de SageMaker IA](smcluster-getting-started-slurm-console.md) para crear un SageMaker HyperPod clúster nuevo a través de la interfaz de usuario de la SageMaker HyperPod consola.
## Examine sus SageMaker HyperPod clústeres
**En el panel principal de la SageMaker HyperPod consola, en la página principal de la SageMaker HyperPod consola, todos los clústeres creados deberían aparecer en la sección **Clústeres**, que proporciona una vista resumida de los clústeres ARNs, su estado y la hora de creación.**
## Vea los detalles de cada SageMaker HyperPod clúster
En el apartado **Clústeres** de la página principal de la consola, los **Nombres** de los clústeres se activan como enlaces. Seleccione el enlace del nombre del clúster para ver los detalles de cada clúster.
## Edita un SageMaker HyperPod clúster
1. En **Clústeres**, en el panel principal de la SageMaker HyperPod consola, selecciona el clúster que deseas actualizar.
1. Seleccione el clúster y elija **Editar**.
1. En la página **Editar **, puede editar las configuraciones de los grupos de instancias existentes, añadir más grupos de instancias, eliminar grupos de instancias y cambiar las etiquetas del clúster. Una vez realizados los cambios, seleccione **Enviar**.
1. En la sección **Configurar grupos de instancias**, puede añadir más grupos de instancias. Para ello, seleccione **Crear grupo de instancias**.
1. En la sección **Configurar grupos de instancias**, puede elegir **Editar** para cambiar su configuración o **Eliminar** para eliminar el grupo de instancias de forma permanente.
**importante**
Cuando elimine un grupo de instancias, tenga en cuenta los siguientes puntos:
El SageMaker HyperPod clúster debe mantener siempre al menos un grupo de instancias.
Asegúrese de hacer una copia de seguridad de todos los datos importantes antes de eliminarlos.
El proceso de eliminación no se puede deshacer.
**nota**
Al eliminar un grupo de instancias, se eliminarán todos los recursos de computación asociados a ese grupo.
1. En la sección **Etiquetas**, puede actualizar las etiquetas del clúster.
## Elimina un SageMaker HyperPod clúster
1. En **Clústeres**, en el panel principal de la SageMaker HyperPod consola, selecciona el clúster que deseas eliminar.
1. Seleccione el clúster y elija **Eliminar**.
1. En la ventana emergente para eliminar el clúster, revise detenidamente la información del clúster para confirmar que ha elegido el clúster correcto que desea eliminar.
1. Tras revisar la información del clúster, seleccione **Sí, eliminar el clúster**.
1. En el campo de texto para confirmar esta eliminación, escriba **delete**.
1. Seleccione **Eliminar** en la esquina inferior derecha de la ventana emergente para terminar de enviar la solicitud de eliminación del clúster.
# Administrar los clústeres SageMaker HyperPod de Slurm mediante AWS CLI
Los siguientes temas proporcionan orientación sobre cómo escribir archivos de solicitudes de SageMaker HyperPod API en formato JSON y ejecutarlos mediante los AWS CLI comandos.
**Topics**
+ [Creación de un nuevo clúster](#sagemaker-hyperpod-operate-slurm-cli-command-create-cluster)
+ [Describir un clúster](#sagemaker-hyperpod-operate-slurm-cli-command-describe-cluster)
+ [Enumeración de los detalles de los nodos del clúster](#sagemaker-hyperpod-operate-slurm-cli-command-list-cluster-nodes)
+ [Descripción de los detalles de un nodo de clúster](#sagemaker-hyperpod-operate-slurm-cli-command-describe-cluster-node)
+ [Enumerar clústeres](#sagemaker-hyperpod-operate-slurm-cli-command-list-clusters)
+ [Actualización de la configuración de un clúster](#sagemaker-hyperpod-operate-slurm-cli-command-update-cluster)
+ [Actualice el software de la SageMaker HyperPod plataforma de un clúster](#sagemaker-hyperpod-operate-slurm-cli-command-update-cluster-software)
+ [Reducción vertical de un clúster](#sagemaker-hyperpod-operate-slurm-cli-command-scale-down)
+ [Eliminar un clúster](#sagemaker-hyperpod-operate-slurm-cli-command-delete-cluster)
## Creación de un nuevo clúster
1. Prepare un script de configuración de ciclo de vida y cárguelo en un bucket de S3, como, por ejemplo, `s3://sagemaker-amzn-s3-demo-bucket/lifecycle-script-directory/src/`. En el paso 2 siguiente, se supone que hay un script de punto de entrada denominado `on_create.sh` en el bucket de S3 especificado.
**importante**
Asegúrese de configurar la ruta de S3 para empezar con `s3://sagemaker-`. El [Función de IAM para SageMaker HyperPod](sagemaker-hyperpod-prerequisites-iam.md#sagemaker-hyperpod-prerequisites-iam-role-for-hyperpod) tiene asociada la [https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-cluster.html](https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-cluster.html) administrada, que permite el acceso a los buckets de S3 con el prefijo específico `sagemaker-`.
1. Prepara un archivo de solicitud de [CreateCluster](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateCluster.html)API en formato JSON. Debe configurar los grupos de instancias para que coincidan con el clúster de Slurm que diseñe en el archivo `provisioning_parameters.json` que se utilizará durante la creación del clúster como parte de la ejecución de un conjunto de scripts de ciclo de vida. Para obtener más información, consulte [Personalización de SageMaker HyperPod clústeres mediante scripts de ciclo de vida](sagemaker-hyperpod-lifecycle-best-practices-slurm.md). La siguiente plantilla tiene dos grupos de instancias para cumplir con los requisitos mínimos de un clúster de Slurm: un nodo de controlador (principal) y un nodo de computación (de trabajo). En `ExecutionRole`, proporcione el ARN del rol de IAM que ha creado con la `AmazonSageMakerClusterInstanceRolePolicy` administrada de la sección [Función de IAM para SageMaker HyperPod](sagemaker-hyperpod-prerequisites-iam.md#sagemaker-hyperpod-prerequisites-iam-role-for-hyperpod).
```
// create_cluster.json
{
"ClusterName": "your-hyperpod-cluster",
"InstanceGroups": [
{
"InstanceGroupName": "controller-group",
"InstanceType": "ml.m5.xlarge",
"InstanceCount": 1,
"LifeCycleConfig": {
"SourceS3Uri": "s3://amzn-s3-demo-bucket-sagemaker/lifecycle-script-directory/src/",
"OnCreate": "on_create.sh"
},
"ExecutionRole": "arn:aws:iam::111122223333:role/iam-role-for-cluster",
// Optional: Configure an additional storage per instance group.
"InstanceStorageConfigs": [
{
// Attach an additional EBS volume to each instance within the instance group.
// The default mount path for the additional EBS volume is /opt/sagemaker.
"EbsVolumeConfig":{
// Specify an integer between 1 and 16384 in gigabytes (GB).
"VolumeSizeInGB": integer,
}
}
]
},
{
"InstanceGroupName": "worker-group-1",
"InstanceType": "ml.p4d.xlarge",
"InstanceCount": 1,
"LifeCycleConfig": {
"SourceS3Uri": "s3://amzn-s3-demo-bucket-sagemaker/lifecycle-script-directory/src/",
"OnCreate": "on_create.sh"
},
"ExecutionRole": "arn:aws:iam::111122223333:role/iam-role-for-cluster"
}
],
// Optional
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
// Optional
"VpcConfig": {
"SecurityGroupIds": [ "string" ],
"Subnets": [ "string" ]
}
}
```
En función de cómo diseñe la estructura del clúster a través de los scripts de ciclo de vida, puede configurar hasta 20 grupos de instancias en el parámetro `InstanceGroups`.
Para el parámetro de `Tags` solicitud, puedes añadir etiquetas personalizadas para gestionar el SageMaker HyperPod clúster como un AWS recurso. Puede agregar etiquetas a su clúster de la misma manera que las agrega en otros AWS servicios que admiten el etiquetado. Para obtener más información sobre el etiquetado de AWS los recursos en general, consulte la Guía del usuario de [AWS los recursos de etiquetado](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).
Para el parámetro de solicitud `VpcConfig`, especifique la información de la VPC que desee utilizar. Para obtener más información, consulte [Configuración SageMaker HyperPod con una Amazon VPC personalizada](sagemaker-hyperpod-prerequisites.md#sagemaker-hyperpod-prerequisites-optional-vpc).
1. Ejecute el comando [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-cluster.html) de la siguiente manera.
```
aws sagemaker create-cluster \
--cli-input-json file://complete/path/to/create_cluster.json
```
Esto debería devolver el ARN del nuevo clúster.
## Describir un clúster
Ejecute [describe-cluster](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/describe-cluster.html) para comprobar el estado del clúster. Puede especificar el nombre o el ARN del clúster.
```
aws sagemaker describe-cluster --cluster-name your-hyperpod-cluster
```
Cuando el estado del clúster cambie a **InService**, continúe con el siguiente paso. Con esta API, también puedes recuperar los mensajes de error relacionados con la ejecución de otras operaciones de la HyperPod API.
## Enumeración de los detalles de los nodos del clúster
Ejecute [list-cluster-nodes](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/list-cluster-nodes.html)para comprobar la información clave de los nodos del clúster.
```
aws sagemaker list-cluster-nodes --cluster-name your-hyperpod-cluster
```
Esto devuelve una respuesta, y el `InstanceId` es lo que necesita usar para iniciar sesión (mediante `aws ssm`) en ellos.
## Descripción de los detalles de un nodo de clúster
Ejecute [describe-cluster-node](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/describe-cluster-node.html)para recuperar los detalles de un nodo del clúster. Puede obtener el ID del nodo del clúster a partir del list-cluster-nodes resultado. Puede especificar el nombre o el ARN del clúster.
```
aws sagemaker describe-cluster-node \
--cluster-name your-hyperpod-cluster \
--node-id i-111222333444555aa
```
## Enumerar clústeres
Ejecute [list-clusters](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/list-clusters.html) para ver una lista de todos los clústeres de la cuenta.
```
aws sagemaker list-clusters
```
También puede añadir indicadores adicionales para filtrar la lista de clústeres. Para obtener más información sobre lo que este comando ejecuta en un nivel bajo y otros indicadores de filtrado, consulta la referencia de la [ListClusters](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListClusters.html)API.
## Actualización de la configuración de un clúster
Ejecute [update-cluster](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-cluster.html) para actualizar la configuración de un clúster.
**nota**
Puedes usar la `UpdateCluster` API para reducir o eliminar grupos de instancias completos del SageMaker HyperPod clúster. Para obtener instrucciones adicionales sobre cómo reducir verticalmente o eliminar grupos de instancias, consulte [Reducción vertical de un clúster](#sagemaker-hyperpod-operate-slurm-cli-command-scale-down).
1. Cree un archivo de solicitud `UpdateCluster` en formato JSON. Asegúrese de especificar el nombre del clúster y el nombre del grupo de instancias correctos para actualizarlos. Puede cambiar el tipo de instancia, el número de instancias, el script de punto de entrada de la configuración del ciclo de vida y la ruta al script.
1. En `ClusterName`, especifique el nombre del clúster que desea actualizar.
1. En `InstanceGroupName`
1. Para actualizar un grupo de instancias existente, especifique el nombre del grupo de instancias que desea actualizar.
1. Para añadir un nuevo grupo de instancias, especifique un nombre nuevo que no exista en el clúster.
1. En `InstanceType`
1. Para actualizar un grupo de instancias existente, debe hacer coincidir el tipo de instancia que ha especificado inicialmente con el grupo.
1. Para añadir un nuevo grupo de instancias, especifique el tipo de instancia con el que desea configurar el grupo.
1. En `InstanceCount`
1. Para actualizar un grupo de instancias existente, especifique un número entero que corresponda al número de instancias deseado. Puede indicar un valor mayor o menor (hasta 0) para escalar el grupo de instancias hacia arriba o hacia abajo.
1. Para añadir un nuevo grupo de instancias, especifique un número entero mayor o igual a 1.
1. En `LifeCycleConfig`, puede cambiar como desee los valores tanto de `SourceS3Uri` como de `OnCreate` para actualizar el grupo de instancias.
1. En `ExecutionRole`
1. Para actualizar un grupo de instancias existente, siga usando el mismo rol de IAM que ha asociado durante la creación del clúster.
1. Para añadir un nuevo grupo de instancias, especifique el rol de IAM que desee asociar.
1. En `ThreadsPerCore`
1. Para actualizar un grupo de instancias existente, siga usando el mismo valor que ha especificado durante la creación del clúster.
1. Para añadir un nuevo grupo de instancias, puede elegir cualquier valor de las opciones permitidas por tipo de instancia. Para obtener más información, busque el tipo de instancia y consulte la columna **Subprocesos válidos por núcleo** de la tabla de referencia de [Núcleos de CPU y subprocesos por núcleo de CPU por tipo de instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cpu-options-supported-instances-values.html) en la *Guía del usuario de Amazon EC2*.
El siguiente fragmento de código es una plantilla de archivo de solicitud JSON que puede utilizar. Para obtener más información sobre la sintaxis y los parámetros de las solicitudes de esta API, consulta la referencia de la [UpdateCluster](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateCluster.html)API.
```
// update_cluster.json
{
// Required
"ClusterName": "name-of-cluster-to-update",
// Required
"InstanceGroups": [
{
"InstanceGroupName": "name-of-instance-group-to-update",
"InstanceType": "ml.m5.xlarge",
"InstanceCount": 1,
"LifeCycleConfig": {
"SourceS3Uri": "s3://amzn-s3-demo-bucket-sagemaker/lifecycle-script-directory/src/",
"OnCreate": "on_create.sh"
},
"ExecutionRole": "arn:aws:iam::111122223333:role/iam-role-for-cluster",
// Optional: Configure an additional storage per instance group.
"InstanceStorageConfigs": [
{
// Attach an additional EBS volume to each instance within the instance group.
// The default mount path for the additional EBS volume is /opt/sagemaker.
"EbsVolumeConfig":{
// Specify an integer between 1 and 16384 in gigabytes (GB).
"VolumeSizeInGB": integer,
}
}
]
},
// add more blocks of instance groups as needed
{ ... }
]
}
```
1. Ejecute el siguiente comando `update-cluster` para enviar la solicitud.
```
aws sagemaker update-cluster \
--cli-input-json file://complete/path/to/update_cluster.json
```
## Actualice el software de la SageMaker HyperPod plataforma de un clúster
Ejecute [update-cluster-software](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-cluster-software.html)para actualizar los clústeres existentes con el software y los parches de seguridad proporcionados por el SageMaker HyperPod servicio. En `--cluster-name`, especifique el nombre o el ARN del clúster que desea actualizar.
**importante**
Tenga en cuenta que debe hacer una copia de seguridad de su trabajo antes de ejecutar esta API. El proceso de aplicación de parches reemplaza el volumen raíz por la AMI actualizada, lo que significa que se perderán los datos anteriores almacenados en el volumen raíz de la instancia. Asegúrese de hacer una copia de seguridad de los datos del volumen raíz de la instancia en Amazon S3 o Amazon FSx for Lustre. Para obtener más información, consulte [Utilice el script de respaldo proporcionado por SageMaker HyperPod](#sagemaker-hyperpod-operate-slurm-cli-command-update-cluster-software-backup).
```
aws sagemaker update-cluster-software --cluster-name your-hyperpod-cluster
```
Este comando llama a la [UpdateClusterSoftware](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateClusterSoftware.html)API. Tras la llamada a la API, SageMaker HyperPod comprueba si hay una DLAMI más reciente disponible para las instancias del clúster. Si se requiere una actualización de DLAMI SageMaker HyperPod , actualizará las instancias del clúster para utilizar las [SageMaker HyperPod DLAMI](sagemaker-hyperpod-ref.md#sagemaker-hyperpod-ref-hyperpod-ami) más recientes y ejecutará los scripts de su ciclo de vida en el bucket de Amazon S3 que especificó durante la creación o actualización del clúster. Si el clúster ya utiliza la última versión de DLAMI SageMaker HyperPod , no realizará ningún cambio en el clúster ni volverá a ejecutar los scripts del ciclo de vida. El equipo SageMaker HyperPod de servicio lanza periódicamente nuevos [SageMaker HyperPod DLAMI](sagemaker-hyperpod-ref.md#sagemaker-hyperpod-ref-hyperpod-ami) dispositivos para mejorar la seguridad y la experiencia de los usuarios. Le recomendamos que se mantenga siempre actualizado a la última SageMaker HyperPod DLAMI. Para futuras actualizaciones de SageMaker HyperPod DLAMI para parches de seguridad, consulte con. [Notas de SageMaker HyperPod lanzamiento de Amazon](sagemaker-hyperpod-release-notes.md)
**sugerencia**
Si se produce un error en el parche de seguridad, puede recuperar los mensajes de error ejecutando la API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeCluster.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeCluster.html), tal y como se indica en las instrucciones de [Describir un clúster](#sagemaker-hyperpod-operate-slurm-cli-command-describe-cluster).
**nota**
Solo puede ejecutar esta API mediante programación. La funcionalidad de aplicación de parches no está implementada en la interfaz de usuario de la consola. SageMaker HyperPod
### Utilice el script de respaldo proporcionado por SageMaker HyperPod
SageMaker HyperPod proporciona un script para realizar copias de seguridad de sus datos y restaurarlos [https://github.com/aws-samples/awsome-distributed-training/blob/main/1.architectures/5.sagemaker-hyperpod/patching-backup.sh](https://github.com/aws-samples/awsome-distributed-training/blob/main/1.architectures/5.sagemaker-hyperpod/patching-backup.sh)en el * GitHub repositorio de Awsome Distributed Training*. El script proporciona las dos funciones siguientes.
**Copia de seguridad de los datos en un bucket de S3 antes de aplicar los parches**
```
sudo bash patching-backup.sh --create
```
Tras ejecutar el comando, el script comprueba `squeue` para ver si hay trabajos en cola, detiene Slurm si no hay ningún trabajo en la cola, hace copia de seguridad de `mariadb` y copia los elementos locales en el disco definido en `LOCAL_ITEMS`. Puede añadir más archivos y directorios a `LOCAL_ITEMS`.
```
# Define files and directories to back up.
LOCAL_ITEMS=(
"/var/spool/slurmd"
"/var/spool/slurmctld"
"/etc/systemd/system/slurmctld.service"
"/home/ubuntu/backup_slurm_acct_db.sql"
# ... Add more items as needed
)
```
Además, puede añadir código personalizado al script proporcionado para hacer copia de seguridad de cualquier aplicación según su caso de uso.
**Restauración de los datos de un bucket de S3 después de aplicar un parche**
```
sudo bash patching-backup.sh --restore
```
## Reducción vertical de un clúster
Puedes reducir el número de instancias o eliminar grupos de instancias de tu SageMaker HyperPod clúster para optimizar la asignación de recursos o reducir los costos.
Puede reducir verticalmente utilizando la operación de la API `UpdateCluster` para terminar las instancias de su grupo de instancias de forma aleatoria hasta un número específico, o bien finalizar instancias específicas mediante la operación de la API `BatchDeleteClusterNodes`. También puede eliminar por completo grupos de instancias completos mediante la API `UpdateCluster`. Para obtener más información acerca de cómo reducir verticalmente usando estos métodos, consulte [Reducir la escala de un SageMaker HyperPod clúster](smcluster-scale-down.md).
**nota**
No puede eliminar instancias configuradas como nodos de controlador de Slurm. Si se intenta eliminar un nodo del controlador de Slurm, se genera un error de validación con el código de error `NODE_ID_IN_USE`.
## Eliminar un clúster
Ejecute [delete-cluster](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/delete-cluster.html) para eliminar un clúster. Puede especificar el nombre o el ARN del clúster.
```
aws sagemaker delete-cluster --cluster-name your-hyperpod-cluster
```