Uso pcluster update-cluster

En laAWS ParallelCluster versión 3.x,pcluster update-cluster analiza la configuración utilizada para crear el clúster actual y la configuración del archivo de configuración para detectar problemas. Si se descubre algún problema, se informa de ello y se muestran los pasos a seguir para solucionarlo. Por ejemplo, si InstanceTypese cambia la computación, se debe detener la flota de procesamiento antes de poder continuar con la actualización. Este problema se informa cuando se descubre. Si no se detecta ningún problema de bloqueo, se inicia el proceso de actualización y se informa de los cambios.

Puede utilizar elpcluster update-cluster--dryrun option para ver los cambios antes de que se ejecuten. Para obtener más información, consulte Ejemplos del pcluster update-cluster.

Para obtener instrucciones sobre la solución de problemas, consulteSolución de problemas de AWS ParallelCluster.

Política de actualización: definiciones

Política de actualización: esta configuración se puede cambiar durante una actualización.

Después de cambiar esta configuración, el clúster se puede actualizar mediantepcluster update-cluster.

Política de actualización: si se cambia esta configuración, la actualización no está permitida.

Después de cambiar esta configuración, el clúster no se puede actualizar. Debe revertir la configuración del clúster original y crear un nuevo clúster con la configuración actualizada. Puede eliminar el clúster original más adelante. Para crear el nuevo clúster, utilicepcluster create-cluster. Para eliminar el clúster original, utilicepcluster delete-cluster.

Política de actualización: esta configuración no se analiza durante una actualización.

Esta configuración se puede cambiar y el clúster se puede actualizar mediantepcluster update-cluster.

Política de actualización: la flota de procesamiento debe estar detenida para poder cambiar esta configuración para una actualización.

Esta configuración no se puede cambiar mientras exista la flota de procesamiento. Se debe revertir el cambio o se debe detener (utilizarpcluster update-compute-fleet) la flota de cómputos. Una vez que se detenga la flota de cómputos, puede actualizar el clúster (pcluster update-cluster) para activar los cambios. Por ejemplo, si utiliza unSlurm planificador con SlurmQueues/ComputeResources/- Name/MinCount> 0, se inicia una flota de procesamiento.

Política de actualizaciones: esta configuración no se puede reducir durante una actualización.

Estos ajustes se pueden cambiar, pero no se pueden reducir. Si debe disminuir esta configuración, debe revertir la configuración del clúster original y crear un nuevo clúster con la configuración actualizada. Puede eliminar el clúster original más adelante. Para crear el nuevo clúster, utilicepcluster create-cluster. Para eliminar el clúster original, utilicepcluster delete-cluster.

Política de actualización: para reducir el tamaño de una cola por debajo del número actual de nodos, es necesario detener primero la flota de procesamiento.

Esta configuración se puede cambiar, pero si el cambio reduce el tamaño de la cola por debajo del tamaño actual, se debe detener la flota de cómputos (utilizarlapcluster update-compute-fleet). Una vez que se detenga la flota de cómputos, puede actualizar el clúster (pcluster update-cluster) para activar los cambios.

Política de actualización: para reducir la cantidad de nodos estáticos en una cola, es necesario detener primero la flota de procesamiento.

Esta configuración se puede cambiar, pero si el cambio reduce la cantidad de nodos estáticos de la cola por debajo del tamaño actual, la flota de procesamiento debe detenerse (utilizarlapcluster update-compute-fleet). Una vez que se detenga la flota de cómputos, puede actualizar el clúster (pcluster update-cluster) para activar los cambios.

Política de actualización: si se cambia esta configuración, la actualización no está permitida. Si fuerza la actualización, se ignorará el nuevo valor y se utilizará el antiguo.

Después de cambiar esta configuración, el clúster no se puede actualizar. Debe revertir la configuración del clúster original y crear un nuevo clúster con la configuración actualizada. Puede eliminar el clúster original más adelante. Para crear el nuevo clúster, utilicepcluster create-cluster. Para eliminar el clúster original, utilicepcluster delete-cluster.

Política de actualización: la flota de cómputos QueueUpdateStrategydebe estar detenida o configurada para cambiar esta configuración con vistas a una actualización.

Estos ajustes se pueden cambiar. La flota de cómputos debe estar detenida (en usopcluster update-compute-fleet) o QueueUpdateStrategydebe configurarse. Después de detener o QueueUpdateStrategyconfigurar la flota de procesamiento, puede actualizar el clúster (pcluster update-cluster) para activar los cambios.

nota

Esta política de actualización se admite a partir deAWS ParallelCluster la versión 3.2.0.

Política de actualización: para esta configuración de valores de lista, se puede agregar un nuevo valor durante una actualización o se debe detener la flota de procesamiento al eliminar un valor existente.

Se puede añadir un nuevo valor para estos ajustes durante una actualización. Después de añadir un nuevo valor a la lista, el clúster se puede actualizar mediante (pcluster update-cluster).

Para eliminar un valor existente de la lista, se debe detener (utilizarpcluster update-compute-fleet) la flota de procesamiento.

Por ejemplo, si utiliza unSlurm planificador y agrega una nueva cola SlurmQueues, puede actualizar el clúster sin detener la flota de procesamiento. Para eliminar una cola existente SlurmQueues, primero se debe detener la flota de procesamiento (utilizandopcluster update-compute-fleet).

nota

Esta política de actualización se admite a partir deAWS ParallelCluster la versión 3.2.0.

Política de actualización: para configurar esta lista de valores, la flota de procesamiento QueueUpdateStrategydebe detenerse o configurarse para agregar un nuevo valor; la flota de procesamiento debe detenerse al eliminar un valor existente.

Se puede añadir un nuevo valor para estos ajustes durante una actualización. La flota de cómputos debe estar detenida (en usopcluster update-compute-fleet) o QueueUpdateStrategydebe configurarse. Después de detener o QueueUpdateStrategyconfigurar la flota de procesamiento, puede actualizar el clúster (pcluster update-cluster) para activar los cambios.

Para eliminar un valor existente de la lista, se debe detener (utilizarpcluster update-compute-fleet) la flota de procesamiento.

nota

Esta política de actualización se admite a partir deAWS ParallelCluster la versión 3.3.0.

Política de actualización: todos los nodos de procesamiento deben detenerse para eliminar un grupo de ubicación administrado. La flota de procesamiento debe estar detenida o QueueUpdateStrategyconfigurada para que esta configuración se cambie a fin de actualizarla.

La flota de procesamiento debe detenerse (usarsepcluster update-compute-fleet) para eliminar un grupo de ubicación administrado. Si ejecutas una actualización del clúster para eliminar un grupo de ubicación gestionado antes de detener la flota de procesamiento, aparecerá un mensaje de configuración no válido y la actualización no continuará. Detener la flota de cómputos garantiza que no se esté ejecutando ninguna instancia.

Ejemplos del pcluster update-cluster

• En este ejemplo se muestra una actualización con algunos cambios permitidos y la actualización se inicia directamente.

  $ pcluster update-cluster --cluster-name cluster_name --cluster-config ~/.parallelcluster/test_cluster --region us-east-1
  {
    "cluster": {
      "clusterName": cluster_name,
      "cloudformationStackStatus": "UPDATE_IN_PROGRESS",
      "cloudformationStackArn": stack_arn,
      "region": "us-east-1",
      "version": "3.5.0",
      "clusterStatus": "UPDATE_IN_PROGRESS"
    },
    "changeSet": [
      {
        "parameter": "HeadNode.Networking.AdditionalSecurityGroups",
        "requestedValue": [
          "sg-0cd61884c4ad11234"
        ],
        "currentValue": [
          "sg-0cd61884c4ad16341"
        ]
      }
    ]
  }

• En este ejemplo se muestra una actualización de ejecución en seco con algunos cambios permitidos. Dryrun es útil para informar del cambio establecido sin iniciar la actualización.

  $ pcluster update-cluster --cluster-name cluster_name --cluster-config ~/.parallelcluster/test_cluster --region us-east-1 --dryrun true
  {
    "message": "Request would have succeeded, but DryRun flag is set.",
    "changeSet": [
      {
        "parameter": "HeadNode.Networking.AdditionalSecurityGroups",
        "requestedValue": [
          "sg-0cd61884c4ad11234"
        ],
        "currentValue": [
          "sg-0cd61884c4ad16341"
        ]
      }
    ]
  }

• En este ejemplo se muestra una actualización con algunos cambios que la bloquean.

  $ pcluster update-cluster --cluster-name cluster_name --cluster-config ~/.parallelcluster/test_cluster --region us-east-1
  {
    "message": "Update failure",
    "updateValidationErrors": [
      {
        "parameter": "HeadNode.Ssh.KeyName",
        "requestedValue": "mykey_2",
        "message": "Update actions are not currently supported for the 'KeyName' parameter. Restore 'KeyName' value to 'jenkinsjun'. If you need this change, please consider creating a new cluster instead of updating the existing one.",
        "currentValue": "mykey_1"
      },
      {
        "parameter": "Scheduling.SlurmQueues[queue1].ComputeResources[queue1-t2micro].InstanceType",
        "requestedValue": "c4.xlarge",
        "message": "All compute nodes must be stopped. Stop the compute fleet with the pcluster update-compute-fleet command",
        "currentValue": "t2.micro"
      },
      {
        "parameter": "SharedStorage[ebs1].MountDir",
        "requestedValue": "/my/very/very/long/shared_dir",
        "message": "Update actions are not currently supported for the 'MountDir' parameter. Restore 'MountDir' value to '/shared'. If you need this change, please consider creating a new cluster instead of updating the existing one.",
        "currentValue": "/shared"
      }
    ],
    "changeSet": [
      {
        "parameter": "HeadNode.Networking.AdditionalSecurityGroups",
        "requestedValue": [
          "sg-0cd61884c4ad11234"
        ],
        "currentValue": [
          "sg-0cd61884c4ad16341"
        ]
      },
      {
        "parameter": "HeadNode.Ssh.KeyName",
        "requestedValue": "mykey_2",
        "currentValue": "mykey_1"
      },
      {
        "parameter": "Scheduling.SlurmQueues[queue1].ComputeResources[queue1-t2micro].InstanceType",
        "requestedValue": "c4.xlarge",
        "currentValue": "t2.micro"
      },
      {
        "parameter": "SharedStorage[ebs1].MountDir",
        "requestedValue": "/my/very/very/long/shared_dir",
        "currentValue": "/shared"
      }
    ]
  }