WebUI の AWS ParallelCluster Manager と AWS ParallelCluster のバージョンの互換性を意識しよう

AWS ParallelCluster Manger のバージョンが AWS ParallelCluster のバージョンより低いと Web UI からクラスターの管理はできません。
2022.11.13

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

AWS ParallelCluster Manager から新しく作成したクラスターの情報を確認できません。どうしたらいいですか?

メジャーバージョンの互換性がないというエラーが表示されます。

エラーメッセージ

Error ([YourClusterName]): Bad Request: Cluster '[YourClusterName]' belongs to an incompatible ParallelCluster major version.

原因と対処

AWS ParallelCluster Manager の仕様です。ParallelCluster Manger のバージョンより新しいバージョンの ParallelCluster のクラスターは管理できません。

対処は対象のクラスターのバージョンより高いバージョン AWS ParallelCluster Manager へアップデートするか、新しいバージョンの AWS ParallelCluster Manager をデプロイするかです。ただ、AWS ParallelCluster Manager の新しいバージョンがリリースが遅いです。

ParallelCluster の新バージョンがリリースされた直後から ParallelCluster Manager で管理できると期待しない方がよいです。

検証環境

AWS ParallelCluster Manager 3.2.0

AWS ParallelCluster Manager とは

AWS ParallelCluster Manager はWeb UI でクラスターを管理できる便利ツールです。サーバレスアーキテクチャなおかげで利用費もほぼほぼ掛かりませんし、デプロイも CloudFormation テンプレートを実行するだけで簡単です。

エラーの状況確認

AWS ParallelCluster Manager 3.2.0 から AWS ParallelCluster 3.3.0 のクラスターを参照しようとするとエラーになります。

AWS ParallelCluster Manager 3.2.0 から AWS ParallelCluster 3.2.0 のクラスターを参照するのは問題ありません。CloudWatch Logs に出力しているヘッドノードのログを AWS ParallelCluster Manager から確認できていますね。

となると、現在利用中のバージョンはなんなのか確認したくなると思います。

AWS ParallelCluster Manger のバージョン確認

オススメの方法は Official Images からバージョンを確認です。

CloudFormation スタック

初回構築時に CloudFormation テンプレートを実行したスタックのパラメーターにバージョンを指定する必要があるため、パラメーターを確認すれば導入時のバージョンは確認できます。もしすでにバージョンアップデートしていた場合はスタックの更新が入らないため、パラメーターの値を参照しても役にたちません。

Official Images のイメージ

AWS ParallelCluster Manager から利用できるオフィシャルイメージ一覧を確認できます。ここに表示されるバージョンは AWS ParallelCluster Manager のバージョンと同じです。現時点では ParallelCluster 3.3.0 がリリースされているのですが、AWS ParallelCluster Manager は古いバージョンしか表示されていません。

AWS ParallelCluster Manager 3.3.0 で同じページを確認すると、3.3.0 になっていることが確認できます。

AWS ParallelCluster Manager 3.3.0 時点では Official Images のバージョンから判断するのがよい方法です。

AWS ParallelCluster Manager のアップデート

AWS ParallelCluster Manager 3.3.0 のリリースではじめてリリースタグが打たれるようになりました。今後はリリースタグを確認すれば最新バージョンを確認できると思います。

Releases · aws-samples/pcluster-manager

アップデートスクリプトを実行して関係する Lambda を差し替えてアップデートすることになります。初回のデプロイで使用した CloudFormation のスタック更新してアップデートするわけではありません。

aws-samples/pcluster-manager: Manage AWS ParallelCluster through an easy to use web interface

おわりに

AWS ParallelCluster Manager は ParallelCluster よりさらに情報が少ないため、ナレッジを共有していきたいと思います。