AKS Edge Essentials 用にマシンを準備する

この記事では、Azure Kubernetes Service (AKS) Edge Essentials ノード マシンを設定する方法について説明します。

前提条件

注意

オフライン インストールを実行している場合、またはコンピューターがインターネット接続を制限する可能性があるセキュリティ ポリシーが設定された企業環境で実行されている場合は、AKS Edge Essentials オフライン インストールをチェックしてください。

AKS Edge Essentials のダウンロード

AKS Edge Essentials クラスターは、1 台のマシンまたは複数のマシンにデプロイできます。 マルチマシンデプロイでは、いずれかのマシンが Kubernetes 制御ノードを持つプライマリ マシンであり、もう 1 つのマシンは制御ノードまたはワーカー ノードであるセカンダリ マシンです。 次のように、プライマリ マシンとセカンダリ マシンの両方に AKS Edge Essentials をインストールする必要があります。 AKS Edge Essentials がインストールされたら、Kubernetes クラスターを作成するときに、1 台のマシンをプライマリマシンとして、残りをセカンダリ マシンとして識別します。

  1. コンピューターで、 使用 する Kubernetes ディストリビューションに応じて、 AksEdge-k3s.msiまたはAksEdge-k8s.msi ファイルをダウンロードします。 また、Windows ワーカー ノードを作成する場合は、Windows ノード ファイルが必要です。

    ファイル Link
    K8s インストーラー (1.27.6) aka.ms/aks-edge/k8s-msi
    K3s インストーラー (1.27.6) aka.ms/aks-edge/k3s-msi
    K8s インストーラー (1.26.6) aka.ms/aks-edge/k8s-msi-1.26
    K3s インストーラー (1.26.10) aka.ms/aks-edge/k3s-msi-1.26
    Windows ノード ファイル aka.ms/aks-edge/windows-node-zip
  2. MSI に加えて、Microsoft には 、AKS Edge GitHub リポジトリからダウンロードできるサンプルとツールが用意されています。 [ コード ] タブに移動し、[ Zip のダウンロード ] ボタンをクリックして、リポジトリを .zip ファイルとしてダウンロードします。 GitHub .zip ファイルをローカル フォルダーに抽出します。

  3. インストールする前に、プライベート プレビュー インストールをアンインストールし、システムを再起動してから続行してください。

このリリースでは、K8 と K3 の両方がサポートされています。 Kubernetes ディストリビューションごとに 2 つの個別の MSI インストーラーを提供しました。 K8 と K3 の両方を同時にインストールしないでください。 別の Kubernetes ディストリビューションをインストールする場合は、まず既存のディストリビューションをアンインストールしてから再起動します。

注意

Windows ノード機能を使用する場合は、zip アーカイブからインストーラーの MSI と同じフォルダーに Windows ノード ファイルを抽出する必要があります。 MSI をインストールする前に、 機能サポート マトリックス を確認して、使用可能なさまざまなオプションを理解できます。

AKS Edge Essentials のインストール

  1. 管理者 (管理者特権の PowerShell) として PowerShell を開き、インストーラー ファイルを含むフォルダー ディレクトリに移動します。

  2. 次のコマンドを発行し、ダウンロードして実行した Kubernetes ディストリビューション/バージョンに置き換えます kXs-x.x.xxx.x

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi
    

    必要に応じて、 と を使用してINSTALLDIRVHDXDIR、インストール ディレクトリと vhdx ディレクトリ (仮想マシンの vhdx ファイルが格納されているディレクトリ) を指定できます。 既定では、これらは に含 C:\Program Files\AksEdgeまれます。

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx
    

    または、 AksEdge-k8s-x.x.xxx.x.msi または AksEdge-k3s-x.x.xxx.x.msi ファイルをダブルクリックして、最新バージョンをインストールすることもできます。

  3. Windows ノードを含めるには、選択した Kubernetes ディストリビューションを含む MSI インストーラーと、解凍された AksEdgeWindows-v1 ファイルが同じフォルダーにあることを確認します。 次のコマンドで、 を、ダウンロードして実行した Kubernetes ディストリビューション/バージョンに置き換えます kXs-x.x.xxx.x

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature
    

    OR

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx
    

    これで、混合デプロイを実行する準備ができました。

  4. 別の管理者特権の PowerShell ウィンドウを開き、次の手順に進みます。

AKS Edge Essentials モジュールを確認する

インストールが完了したら、管理者特権の PowerShell で次のコマンドを実行して、正常に完了したことを確認します。

Set-ExecutionPolicy RemoteSigned -Scope Process -Force
Import-Module AksEdge
Get-Command -Module AKSEdge | Format-Table Name, Version

このコマンドは、次の一覧のような出力を表示します。

インストールされている PowerShell モジュールのスクリーンショット。

サポートされているコマンドの完全な一覧については、 AKS Edge Essentials PowerShell コマンドレットリファレンスを参照してください

デバイス設定の確認

コマンドを Install-AksEdgeHostFeatures 実行して、コンピューター上の Hyper-V、SSH、および電源の設定を検証できます。 これには、システムの再起動が必要な場合があります。

Install-AksEdgeHostFeatures

このコマンドは、次の一覧のような出力を表示します。

完了したチェックを示すスクリーンショット。

次の手順