mcpField
H
hyperpod-version-checker

hyperpod-version-checker

github.com/awslabsクラウド・DevOps932146 回インストール3 週間前に更新
リポジトリ

hyperpod-version-checker について

hyperpod-version-checker は、HyperPod ノードのソフトウェアと関連コンポーネントを調べるスクリプトスキルです。テキストまたは JSON レポートを生成してノード間で比較でき、CUDA とドライバーの互換性も分析します。

主な機能

  1. 01GPU と CUDA コンポーネントの確認
  2. 02EFA、NCCL、MPI、GDRCopy の確認
  3. 03Neuron SDK と ML ソフトウェアの確認
  4. 04コンテナランタイムの確認
  5. 05テキストまたは JSON レポートの出力
  6. 06CUDA とドライバーの互換性分析

活用シーン

  1. 01ノード上のコンポーネントバージョンの監査
  2. 02クラスター内ノード間のソフトウェア環境比較
  3. 03ドライバーと CUDA の互換性確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/awslabs/agent-plugins --skill hyperpod-version-checker

インストール後、Claude Code で/hyperpod-version-checkerを入力して読み込まれたか確認します。

同梱ファイルscripts/hyperpod_check_versions.sh

詳細

HyperPod バージョンチェッカー

hyperpod-ssm スキルを使ってクラスターのノードにアップロードし、実行します。

使い方

# Text report to console + file
bash hyperpod_check_versions.sh

# JSON only to stdout (text report still saved to file) — best for piping/parsing
bash hyperpod_check_versions.sh --json

# Custom output file
bash hyperpod_check_versions.sh --output /tmp/versions.txt

# No color (for logging)
bash hyperpod_check_versions.sh --no-color

出力ファイル:component_versions_<hostname>_<timestamp>.txt(デフォルト)

チェック項目

コンポーネント検出方法適用対象
NVIDIA ドライバーnvidia-smiGPU インスタンス(p3/p4/p5/g5)
CUDA Toolkitnvcc、/usr/local/cuda シンボリックリンクGPU インスタンス
cuDNNヘッダーファイル、パッケージディープラーニングを実行する GPU インスタンス
NCCLライブラリのファイル名、ヘッダー、パッケージ分散 GPU トレーニング
EFA/opt/amazon/efa_installed_packages、fi_infoEFA 対応インスタンス(p4d/p4de/p5/trn1/trn2)
AWS OFI NCCLefa_installed_packages、ライブラリの検索EFA + NCCL ワークロード
GDRCopyrpm/dpkg、カーネルモジュールRDMA を使用する GPU インスタンス(p4d+/p5)
MPImpirun、/opt/amazon/openmpi分散トレーニング
Neuron SDKneuronx-cc、neuron-ls、パッケージTrainium/Inferentia(trn1/trn2/inf1/inf2)
Python/PyTorchpython3、torch のインポートML ワークロード
コンテナランタイムdocker、containerd、kubectl、nvidia-ctkEKS クラスター

複数ノードの比較

hyperpod-ssm スキルを使って、各ノードで個別に実行します。--json を指定すると、標準出力に差分比較しやすいクリーンな JSON が出力されます。

互換性のリファレンス

スクリプトは CUDA とドライバーの互換性を自動的に分析します。参考情報:

ドライバーシリーズ対応 CUDA
580+13.x、12.x、11.x
570+12.8+(Blackwell)、12.x、11.x
545+12.3-12.7、11.x
525-53512.0-12.2、11.x
450+11.x のみ

NCCL:CUDA 12.x では 2.18+、CUDA 11.x では 2.12+ を使用します。すべてのノードで同じバージョンにする必要があります。

EFA インストーラーAWS OFI NCCL
1.29+v1.7.3+(推奨)
1.26-1.28v1.7.0-v1.7.2
1.20-1.25v1.6.0+

コメント