翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon SageMaker HyperPod Inference リリースノート
<a name="sagemaker-hyperpod-inference-release-notes"></a>

このトピックでは、Amazon SageMaker HyperPod Inference の更新、修正、新機能を追跡するリリースノートについて説明します。SageMaker HyperPod Inference を使用すると、エンタープライズグレードの信頼性で HyperPod クラスターに機械学習モデルをデプロイおよびスケーリングできます。Amazon SageMaker HyperPod プラットフォームの一般的なリリース、更新、改善については、「」を参照してください[Amazon SageMaker HyperPod リリースノート](sagemaker-hyperpod-release-notes.md)。

SageMaker HyperPod 推論機能とデプロイオプションの詳細については、「」を参照してください[Amazon SageMaker HyperPod にモデルをデプロイする](sagemaker-hyperpod-model-deployment.md)。

## SageMaker HyperPod Inference リリースノート: v3.0
<a name="sagemaker-hyperpod-inference-release-notes-20260223"></a>

**リリース日:** 2026 年 2 月 23 日

**[概要]**

Inference Operator 3.0 では、ライフサイクル管理を簡素化するための EKS アドオン統合、詳細なスケジューリング制御のための Node Affinity サポート、リソースのタグ付けの改善が導入されています。既存の Helm ベースのインストールは、提供された移行スクリプトを使用して EKS アドオンに移行できます。アップグレードする前に、推論オペレーターの実行ロールを新しいタグ付けアクセス許可で更新します。

**主な機能**
+ **EKS アドオン統合** – シンプルなインストールエクスペリエンスによるエンタープライズグレードのライフサイクル管理
+ **ノードアフィニティ – **スポットインスタンスの除外、アベイラビリティーゾーンの優先、カスタムラベルによるノードのターゲット設定のためのきめ細かなスケジューリング制御

前提条件、アップグレード手順、移行ガイダンスなどの詳細については、以下のセクションを参照してください。

### 前提条件
<a name="sagemaker-hyperpod-inference-v3-0-prerequisites"></a>

Helm バージョンを 3.0 にアップグレードする前に、推論演算子の実行ロールにタグ付けアクセス許可を追加する必要があります。リソースのタグ付けとセキュリティの向上の一環として、推論オペレーターは ALB、S3、および ACM リソースにタグ付けするようになりました。この機能強化には、推論演算子の実行ロールで追加のアクセス許可が必要です。推論演算子の実行ロールに次のアクセス許可を追加します。

```
{  
    "Sid": "CertificateTagginPermission",  
    "Effect": "Allow",  
    "Action": [  
        "acm:AddTagsToCertificate"  
    ],  
    "Resource": "arn:aws:acm:*:*:certificate/*",  
},  
{  
    "Sid": "S3PutObjectTaggingAccess",  
    "Effect": "Allow",  
    "Action": [  
        "s3:PutObjectTagging"  
    ],  
    "Resource": [  
        "arn:aws:s3:::<TLS_BUCKET>/*" # Replace * with your TLS bucket  
    ]  
}
```

### v3.0 へのアップグレード
<a name="sagemaker-hyperpod-inference-v3-0-upgrade"></a>

Helm 経由で Inference Operator が既にインストールされている場合は、次のコマンドを使用してアップグレードします。

```
helm get values -n kube-system hyperpod-inference-operator \
> current-values.yaml

cd sagemaker-hyperpod-cli/helm_chart/HyperPodHelmChart/\
charts/inference-operator

helm upgrade hyperpod-inference-operator . -n kube-system \
  -f current-values.yaml --set image.tag=v3.0
    
# Verification
kubectl get deployment hyperpod-inference-operator-controller-manager \
  -n hyperpod-inference-system \
  -o jsonpath='{.spec.template.spec.containers[0].image}'
```

### Helm から EKS へのアドオン移行
<a name="sagemaker-hyperpod-inference-v3-0-migration"></a>

3.0 バージョンより前に Helm 経由で推論演算子がインストールされている場合は、EKS アドオンに移行して、推論演算子用にリリースされる新機能をタイムリーに更新することをお勧めします。このスクリプトは、SageMaker HyperPod Inference Operator を Helm ベースのインストールから EKS アドオンインストールに移行します。

**概要:** スクリプトはクラスター名とリージョンをパラメータとして受け取り、既存の Helm インストール設定を取得し、EKS アドオンデプロイに移行します。これにより、推論オペレーター、ALB コントローラー、および KEDA オペレーターの新しい IAM ロールが作成されます。

Inference Operator を移行する前に、スクリプトは必要な依存関係 (S3 CSI ドライバー、FSx CSI ドライバー、cert-manager、および metrics-server) が存在することを確認します。存在しない場合は、アドオンとしてデプロイされます。

Inference Operator アドオンの移行が完了すると、スクリプトは S3、FSx、およびその他の依存関係 (ALB、KEDA、cert-manager、metrics-server) も移行します。を使用して`--skip-dependencies-migration`、S3 CSI ドライバー、FSx CSI ドライバー、cert-manager、および metrics-server のこのステップをスキップします。ALB と KEDA は、推論演算子と同じ名前空間のアドオンの一部としてインストールされ、推論演算子アドオンの一部として移行されることに注意してください。

**重要**  
移行中は、移行が完了するまでデプロイされないため、新しいモデルをデプロイしないでください。Inference Operator アドオンが ACTIVE 状態になると、新しいモデルをデプロイできます。移行には通常 15～20 分かかり、現在デプロイされているモデルが少数しかない場合は 30 分以内に完了します。

**移行の前提条件:**
+ AWS CLI 適切な認証情報で設定されている
+ EKS クラスターへのアクセスで設定された kubectl
+ Helm のインストール
+ hyperpod-inference-operator の既存の Helm インストール

**注記**  
すでに実行されているエンドポイントは、移行プロセス中に中断されません。既存のエンドポイントは、移行中も中断することなくトラフィックを引き続き処理します。

**移行スクリプトの取得:**

```
git clone https://github.com/aws/sagemaker-hyperpod-cli.git
cd sagemaker-hyperpod-cli/helm_chart/HyperPodHelmChart/\
charts/inference-operator/migration
```

**使用:**

```
./helm_to_addon.sh [OPTIONS] \
  --cluster-name <cluster-name> (Required) \
  --region <region> (Required) \
  --helm-namespace kube-system (Optional) \
  --auto-approve (Optional) \
  --skip-dependencies-migration (Optional) \
  --s3-mountpoint-role-arn <s3-mountpoint-role-arn> (Optional) \
  --fsx-role-arn <fsx-role-arn> (Optional)
```

**オプション:**
+ `--cluster-name NAME` – EKS クラスター名 (必須)
+ `--region REGION` – AWS リージョン (必須)
+ `--helm-namespace NAMESPACE` – Helm チャートがインストールされている名前空間 (デフォルト: kube-system) (オプション)
+ `--s3-mountpoint-role-arn ARN` – S3 Mountpoint CSI ドライバー IAM ロール ARN (オプション)
+ `--fsx-role-arn ARN` – FSx CSI ドライバー IAM ロール ARN (オプション)
+ `--auto-approve` – このフラグが有効になっている場合は確認プロンプトをスキップします。 `step-by-step`と `auto-approve` は相互に排他的です。 `--auto-approve` が指定されている場合は、指定しないでください `--step-by-step` (オプション)
+ `--step-by-step` – 主要な各ステップの後、レビューのために一時停止します。`--auto-approve` が既に追加されている場合、これは言及しないでください (オプション)
+ `--skip-dependencies-migration` – Helm にインストールされた依存関係のアドオンへの移行をスキップします。依存関係が推論演算子 Helm チャートを介してインストールされなかった場合、または個別に管理する場合。 (オプション)

**例:**

基本的な移行 (依存関係を移行):

```
./helm_to_addon.sh \
  --cluster-name my-cluster \
  --region us-east-1
```

プロンプトなしでの自動承認:

```
./helm_to_addon.sh \
  --cluster-name my-cluster \
  --region us-east-1 \
  --auto-approve
```

FSx、S3 マウントポイント、証明書マネージャー、メトリクスサーバーの依存関係移行をスキップします。

```
./helm_to_addon.sh \
  --cluster-name my-cluster \
  --region us-east-1 \
  --skip-dependencies-migration
```

既存の S3 および FSx IAM ロールを指定します。

```
./helm_to_addon.sh \
  --cluster-name my-cluster \
  --region us-east-1 \
  --s3-mountpoint-role-arn arn:aws:iam::123456789012:role/s3-csi-role \
  --fsx-role-arn arn:aws:iam::123456789012:role/fsx-csi-role
```

**バックアップの場所:**

バックアップは に保存されます。 `/tmp/hyperpod-migration-backup-<timestamp>/`

バックアップにより、安全な移行と復旧が可能になります。
+ **失敗時のロールバック** – 移行が失敗した場合、スクリプトはバックアップされた設定を使用してクラスターを移行前の状態に自動的に復元できます。
+ **監査証跡** – トラブルシューティングとコンプライアンスのために、移行前に存在していたものの完全な記録を提供します。
+ **設定リファレンス** – 移行前と移行後の設定を比較できます
+ **手動復旧** – 必要に応じて、バックアップディレクトリから特定のリソースを手動で検査および復元できます。

**ロールバック:**

移行が失敗した場合、スクリプトはロールバックを開始して以前の状態を復元する前に、ユーザーの確認を求めます。

## SageMaker HyperPod Inference リリースノート: v2.3
<a name="sagemaker-hyperpod-inference-release-notes-20260203"></a>

**最新情報**

このリリースでは、デプロイ設定の柔軟性を高めるために、カスタムリソース定義 (CRDs) に新しいオプションフィールドが導入されました。

**特徴**
+ **マルチインスタンスタイプ**
  + **デプロイの信頼性の向上** – 優先オプションに容量がない場合、代替インスタンスタイプへの自動フェイルオーバーでマルチインスタンスタイプの設定をサポートします。
  + **インテリジェントリソーススケジューリング** – Kubernetes ノードアフィニティを使用してインスタンスタイプに優先順位を付け、優先リソースが使用できない場合でもデプロイを保証します
  + **コストとパフォーマンスの最適化** – インスタンスタイプの設定を維持し、クラスターの変動中の容量関連の障害を防止します。

**バグ修正**

の仕様`invocationEndpoint`の フィールドへの変更が有効`InferenceEndpointConfig`になりました。
+ `invocationEndpoint` フィールドがパッチ適用または更新されている場合、、Load Balancer`Ingress`、、`SageMakerEndpointRegistration`SageMaker エンドポイントなどの依存リソースは正規化で更新されます。
+ `invocationEndpoint` 指定された の値は、`InferenceEndpointConfig`仕様自体にそのまま保存されます。この値を使用してLoad Balancerを作成し、有効にすると SageMaker エンドポイントを作成すると、スラッシュが先頭に 1 つ付くように正規化されます。
  + `v1/chat/completions` は、、AWS Load Balancer`Ingress`、および SageMaker エンドポイント`/v1/chat/completions`に対して に正規化されます。の場合`SageMakerEndpointRegistration`、仕様には として表示されます`v1/chat/completions`。
  + `///invoke` は、、AWS Load Balancer`Ingress`、および SageMaker エンドポイント`/invoke`に対して に正規化されます。の場合`SageMakerEndpointRegistration`、仕様には と表示されます`invoke`。

**Helm のインストール:**

フォロー: [https://github.com/aws/sagemaker-hyperpod-cli/tree/main/helm\$1chart](https://github.com/aws/sagemaker-hyperpod-cli/tree/main/helm_chart)

推論演算子のインストールのみに重点を置いている場合は、ステップ 1、つまり の後`Set Up Your Helm Environment`、 を実行します`cd HyperPodHelmChart/charts/inference-operator`。推論演算子グラフディレクトリ自体にあるため、 コマンドで が表示される場所であれば`helm_chart/HyperPodHelmChart`、 を `.` に置き換えます。

**既にインストールされている場合は、オペレータを v2.3 にアップグレードします。**

```
cd sagemaker-hyperpod-cli/helm_chart/HyperPodHelmChart/\
charts/inference-operator

helm get values -n kube-system hyperpod-inference-operator \
> current-values.yaml

helm upgrade hyperpod-inference-operator . \
  -n kube-system \
  -f current-values.yaml \
  --set image.tag=v2.3
```