使用 pcluster update-cluster - AWS ParallelCluster
更新政策：定义pcluster update-cluster 示例

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 pcluster update-cluster

在AWS ParallelCluster3.x，pcluster update-cluster分析用于创建当前集群的设置以及配置文件中的设置是否存在问题。如果发现任何问题，就会报告这些问题，并显示修复问题的步骤。例如，如果计算InstanceType更改后，必须先停止计算队列，然后才能继续更新。发现此问题后即会报告。如果未发现任何阻塞问题，则启动更新过程并报告更改。

你可以使用pcluster update-cluster --dryrun option以便在运行之前查看更改。有关更多信息，请参阅pcluster update-cluster 示例：

有关故障排除指南，请参阅AWS ParallelCluster 故障排除。

更新政策：定义

更新政策：可以在更新期间更改此设置。

更改此设置后，可以使用以下命令更新集群pcluster update-cluster。

更新政策：如果更改此设置，则不允许更新。

更改此设置后，集群将无法更新。您必须恢复原始集群的设置，并使用更新的设置创建一个新集群。您可以稍后删除原始集群。要创建新集群，请使用pcluster create-cluster。要删除原始集群，请使用pcluster delete-cluster。

更新政策：更新期间不分析此设置。

可以更改这些设置，也可以使用更新集群pcluster update-cluster。

更新策略：必须停止计算队列才能更改此设置以进行更新。

当计算队列存在时，无法更改这些设置。要么必须恢复更改，要么必须停止计算队列（使用pcluster update-compute-fleet)。停止计算队列后，您可以更新集群 (pcluster update-cluster) 以激活更改。例如，如果你使用的是Slurm调度器带有SlurmQueues/ComputeResources/-Name/MinCount> 0，则启动计算队列。

更新政策：更新期间不能减少此设置。

这些设置可以更改，但不能减少。如果必须减少这些设置，则必须恢复原始集群的设置并使用更新的设置创建一个新集群。您可以稍后删除原始集群。要创建新集群，请使用pcluster create-cluster。要删除原始集群，请使用pcluster delete-cluster。

更新政策：要将队列大小减至当前节点数以下，需要先停止计算队列。

可以更改这些设置，但是如果更改会将队列大小减至当前大小以下，则必须停止计算队列（使用pcluster update-compute-fleet)。停止计算队列后，您可以更新集群 (pcluster update-cluster) 以激活更改。

更新政策：减少队列中静态节点的数量需要先停止计算队列。

可以更改这些设置，但是如果更改会将队列中的静态节点数量减少到当前大小以下，则必须停止计算队列（使用pcluster update-compute-fleet)。停止计算队列后，您可以更新集群 (pcluster update-cluster) 以激活更改。

更新政策：如果更改此设置，则不允许更新。如果您强制更新，则新值将被忽略并使用旧值。

更改此设置后，集群将无法更新。您必须恢复原始集群的设置，并使用更新的设置创建一个新集群。您可以稍后删除原始集群。要创建新集群，请使用pcluster create-cluster。要删除原始集群，请使用pcluster delete-cluster。

更新政策：必须停止计算队列或QueueUpdateStrategy必须进行设置才能更改此设置才能进行更新。

这些设置可以更改。要么必须停止计算队列（使用pcluster update-compute-fleet) 或QueueUpdateStrategy必须设置。在计算队列停止后或QueueUpdateStrategy设置后，您可以更新集群 (pcluster update-cluster) 以激活更改。

注意

从以下开始支持此更新政策AWS ParallelCluster版本 3.2.0。

更新政策：对于此列表值设置，可以在更新期间添加新值，或者在删除现有值时必须停止计算队列。

可以在更新期间为这些设置添加一个新值。向列表添加新值后，可以使用 (更新集群)pcluster update-cluster)。

要从列表中移除现有值，必须停止计算队列（使用pcluster update-compute-fleet)。

例如，如果你使用的是Slurm调度器并将新队列添加到SlurmQueues，您可以在不停止计算队列的情况下更新集群。从中移除现有队列SlurmQueues，则必须先停止计算队列（使用pcluster update-compute-fleet)。

注意

从以下开始支持此更新政策AWS ParallelCluster版本 3.2.0。

更新政策：对于此列表值设置，必须停止计算队列或QueueUpdateStrategy必须设置为添加新值；移除现有值时必须停止计算队列。

可以在更新期间为这些设置添加一个新值。要么必须停止计算队列（使用pcluster update-compute-fleet) 或QueueUpdateStrategy必须设置。在计算队列停止后或QueueUpdateStrategy设置后，您可以更新集群 (pcluster update-cluster) 以激活更改。

要从列表中移除现有值，必须停止计算队列（使用pcluster update-compute-fleet)。

注意

从以下开始支持此更新政策AWS ParallelCluster版本 3.3.0。

更新政策：必须停止所有计算节点才能删除托管置放群组。必须停止计算队列或QueueUpdateStrategy必须进行设置才能更改此设置才能进行更新。

必须停止计算队列（使用pcluster update-compute-fleet)，以便移除受管理的置放群组。如果您在停止计算队列之前运行集群更新以移除托管置放群组，则会返回一条无效的配置消息，并且更新不会继续。停止计算队列可以保证没有实例在运行。

pcluster update-cluster 示例

  • 此示例演示了包含一些允许更改的更新，并且更新是直接启动的。

    $ 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.7.0",
    "clusterStatus": "UPDATE_IN_PROGRESS"
  },
  "changeSet": [
    {
      "parameter": "HeadNode.Networking.AdditionalSecurityGroups",
      "requestedValue": [
        "sg-0cd61884c4ad11234"
      ],
      "currentValue": [
        "sg-0cd61884c4ad16341"
      ]
    }
  ]
}

  • 此示例演示了一个 dryrun 更新，其中包含一些允许的更改。Dryrun 可用于在不启动更新的情况下报告更改集。

    $ 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"
      ]
    }
  ]
}

  • 此示例演示了一个更新，其中包含一些阻碍更新的更改。

    $ 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"
    }
  ]
}