

 **このページの改善にご協力ください** 

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「**GitHub でこのページを編集する**」リンクを選択してください。

# Image Builder を使用してカスタム Windows AMI を構築する
<a name="eks-custom-ami-windows"></a>

EC2 Image Builder を使用し、次のオプションのいずれかを使用して、カスタムの Amazon EKS 最適化 Windows AMI を作成できます。
+  [Amazon EKS 最適化 Windows AMI をベースとして使用する](#custom-windows-ami-as-base) 
+  [Amazon 管理ビルドコンポーネントを使用する](#custom-windows-ami-build-component) 

どちらの方法でも、独自の Image Builder レシピを作成する必要があります。詳細については、「Image Builder ユーザーガイド」の「[イメージレシピの新しいバージョンの作成](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html)」を参照してください。

**重要**  
以下の `eks` の **[Amazon 管理]** コンポーネントには、`CVE-2024-5321` のパッチが含まれます。  
 `1.28.2` 以上
 `1.29.2` 以上
 `1.30.1` 以上
Kubernetes 1.31 以降のすべてのバージョン

## Amazon EKS 最適化 Windows AMI をベースとして使用する
<a name="custom-windows-ami-as-base"></a>

このオプションは、カスタム Windows AMI を構築するのに推奨される方法です。当社が提供する Amazon EKS 最適化 Windows AMI は、Amazon 管理のビルドコンポーネントよりも頻繁に更新されます。

1. 新しい Image Builder レシピを始める

   1. https://console.aws.amazon.com/imagebuilder で、EC2 Image Builder コンソールを開きます。

   1. 左側のナビゲーションペインで、**[イメージレシピ]** を選択します。

   1. **[イメージレシピの作成]** を選択します。

1. **[レシピの詳細]** セクションで、**[名前]** と **[バージョン]** を入力します。

1. **[ベースイメージ]** セクションで Amazon EKS 最適化 Windows AMI の ID を指定します。

   1. **[カスタム AMI ID を入力]** を選択します。

   1. 必要な Windows OS バージョンの AMI ID を取得します。詳細については、「[推奨 Microsoft Windows AMI ID を取得する](retrieve-windows-ami-id.md)」を参照してください。

   1. カスタム **[AMI ID]** を入力します。AMI ID が見つからない場合は、AMI ID の AWS リージョンがコンソールの右上に表示されている AWS リージョンと一致しているか確認してください。

1. (オプション) 最新のセキュリティアップデートを入手するには、`update-windows` コンポーネントを **[ビルドコンポーネント - ]** セクションに追加します。

   1. **[名前でコンポーネントを検索する]** 検索ボックスの右側にあるドロップダウンリストから、**[Amazon 管理]** を選択します。

   1. **[名前でコンポーネントを検索する]** 検索ボックスに `update-windows` と入力します。

   1. ** `update-windows` **の検索結果のチェックボックスを選択します。このコンポーネントは、オペレーティングシステムの最新 Windows パッチを含みます。

1. 必要な設定で残りのイメージレシピの入力を完了します。詳細については、「Image Builder ユーザーガイド」の「[イメージレシピの新しいバージョンの作成 (コンソール)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html#create-image-recipe-version-console)」を参照してください。

1. **[レシピを作成する]** を選択します。

1. 新しいイメージレシピを新規または既存のイメージパイプラインで使用します。イメージパイプラインが正常に実行されると、カスタム AMI が出力イメージとして一覧表示され、使用できるようになります。詳細については、「[EC2 Image Builder コンソールウィザードを使用してイメージパイプラインを作成する](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html)」を参照してください。

## Amazon 管理ビルドコンポーネントを使用する
<a name="custom-windows-ami-build-component"></a>

Amazon EKS 最適化 Windows AMI をベースとして使用できない場合は、代わりに Amazon 管理ビルドコンポーネントを使用できます。このオプションは、サポートされている最新の Kubernetes バージョンよりも遅れる可能性があります。

1. 新しい Image Builder レシピを始める

   1. https://console.aws.amazon.com/imagebuilder で、EC2 Image Builder コンソールを開きます。

   1. 左側のナビゲーションペインで、**[イメージレシピ]** を選択します。

   1. **[イメージレシピの作成]** を選択します。

1. **[レシピの詳細]** セクションで、**[名前]** と **[バージョン]** を入力します。

1. **[ベースイメージ]** のセクションで、カスタム AMI の作成に使用するオプションを決定します。
   +  **[管理イメージの選択]** — **[イメージオペレーティングシステム (OS)]** で **[Windows]** を選択します。次に、**[イメージのオリジン]** について、以下のいずれかのオプションを選択します。
     +  **[クイックスタート (Amazon 管理)]** – **[イメージ名]** ドロップダウンから、Amazon EKS でサポートされている Windows Server のバージョンを選択します。詳細については、「[最適化された Windows AMI を使用してノードを作成する](eks-optimized-windows-ami.md)」を参照してください。
     +  **[ユーザー所有のイメージ]** – **[イメージ名]** で、独自ライセンスを持つ独自のイメージの ARN を選択します。Amazon EKS コンポーネントをインストール済みのイメージを指定することはできません。
   +  **[カスタム AMI ID を入力]** – [AMI ID] に、独自ライセンスを持つ AMI の ID を入力します。Amazon EKS コンポーネントをインストール済みのイメージを指定することはできません。

1. **[ビルドコンポーネント - Windows]** セクションで、次の操作を行います。

   1. **[名前でコンポーネントを検索する]** 検索ボックスの右側にあるドロップダウンリストから、**[Amazon 管理]** を選択します。

   1. **[名前でコンポーネントを検索する]** 検索ボックスに `eks` と入力します。

   1. たとえ目的のバージョンではない場合でも、** `eks-optimized-ami-windows` **検索結果のチェックボックスを選択します。

   1. **[名前でコンポーネントを検索する]** 検索ボックスに `update-windows` と入力します。

   1. **update-windows** の検索結果のチェックボックスを選択します。このコンポーネントは、オペレーティングシステムの最新 Windows パッチを含みます。

1. **[選択したコンポーネント]** セクションで、次の手順を実行します。

   1. ** [`eks-optimized-ami-windows`] ** の **[バージョニングオプション]** を選択してください。

   1. **[コンポーネントバージョンを指定する]** を選択します。

   1. **[コンポーネントバージョン]** フィールドに *version.x* と入力し、*バージョン*をサポートされている Kubernetes バージョンに置き換えます。バージョン番号の一部に *x* を入力すると、明示的に定義したバージョンの一部と一致する最新のコンポーネントバージョンが使用されます。コンソールの出力に注目してください。目的のバージョンが管理コンポーネントとして利用可能かどうかが示されます。ビルドコンポーネントでは、最新の Kubernetes バージョンを使用できない場合があります。使用できるバージョンの詳細については、「[`eks-optimized-ami-windows` コンポーネントのバージョンに関する情報を取得する](#custom-windows-ami-component-versions)」を参照してください。

1. 必要な設定で残りのイメージレシピの入力を完了します。詳細については、「Image Builder ユーザーガイド」の「[イメージレシピの新しいバージョンの作成 (コンソール)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html#create-image-recipe-version-console)」を参照してください。

1. **[レシピを作成する]** を選択します。

1. 新しいイメージレシピを新規または既存のイメージパイプラインで使用します。イメージパイプラインが正常に実行されると、カスタム AMI が出力イメージとして一覧表示され、使用できるようになります。詳細については、「[EC2 Image Builder コンソールウィザードを使用してイメージパイプラインを作成する](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html)」を参照してください。

## `eks-optimized-ami-windows` コンポーネントのバージョンに関する情報を取得する
<a name="custom-windows-ami-component-versions"></a>

各コンポーネントにインストールされているものに関する特定の情報を取得できます。例えば、どの `kubelet` バージョンがインストールされているかを確認できます。コンポーネントには、Amazon EKS がサポートする Windows オペレーティングシステムのバージョンで機能テストが実施されます。詳細については、「[リリースカレンダー](eks-optimized-windows-ami.md#windows-ami-release-calendar)」を参照してください。その他の Windows OS バージョンで、サポートされていない、またはサポート終了としてリストにあるものは、このコンポーネントと互換性がない可能性があります。

1. https://console.aws.amazon.com/imagebuilder で、EC2 Image Builder コンソールを開きます。

1. 左にあるナビゲーションペインで、**[コンポーネント]** をクリックします。

1. **[名前でコンポーネントを検索する]** 検索ボックスの右側にあるドロップダウンリストで、**[自己所有]** を **[クイックスタート (Amazon 管理)]** に変更します。

1. [**名前でコンポーネントを検索**] ボックスに `eks` と入力します。

1. (オプション) 最新バージョンを使用している場合は、**[バージョン]** 列を 2 回選択して降順にソートします。

1. 目的のバージョンの **[`eks-optimized-ami-windows`]** リンクを選択します。

結果のページの **[説明]** には、特定の情報が表示されます。