Azure Stack Hub の Windows に AKS エンジンをインストールする

[アーティクル]
12/01/2023

最新バージョンの AKS エンジンのバイナリダウンロードは、 Github で入手できます。オペレーティングシステム用のパッケージをダウンロードし、AKS エンジンバージョン 0.73.0 以降の aks-engine ファイルを抽出します。 AKS エンジンバージョン 0.75.3 以降の場合は、 aks-engine-azurestack ファイルを抽出します (必要に応じて環境変数に追加して $PATH 、より便利な CLI を使用できるようにします)。

クライアント VM の準備

AKS エンジンとは、お使いの Kubernetes クラスターをデプロイおよび管理するために使用するコマンドラインツールです。このエンジンは、お使いの Azure Stack Hub のコンピューターで実行できます。このマシンから AKS エンジンを実行して、クラスターの実行に必要な IaaS リソースとソフトウェアをデプロイします。その後、このエンジンを実行しているコンピューターを使用して、お使いのクラスターで管理タスクを実行できます。

お使いのクライアントコンピューターを選択する場合には、次の点を考慮してください。

障害発生時にクライアントコンピューターを復旧可能にする必要があるかどうか。
クライアントコンピューターに接続する方法と、マシンがクラスターとどのように対話するか。

接続された環境に AKS エンジンをインストールする

クライアント VM をインストールし、インターネットに接続されている Azure Stack Hub 上のお使いの Kubernetes クラスターを管理できます。

Azure Stack Hub で Windows VM を作成します。手順については、「クイックスタート:Azure Stack Hub ポータルを使用して Windows サーバー VM を作成する」を参照してください。
お使いの VM に接続します。
PowerShell の手順に従って Chocolatey をインストールします。

Chocolatey の Web サイトによると:Chocolatey は、Windows のパッケージマネージャーです。例えば、Windows 用の apt-get や yum などです。必要なアプリケーションとツールを迅速にインストールするための分散型フレームワークとして設計されています。現在 PowerShell を使用している NuGet インフラストラクチャ上に構築されており、ディストリビューションからドア、err、コンピューターへのパッケージの配信に重点を置いています。
Azure CLI をインストールします。ダウンロードリンクを選択し、[実行] を選択します。必要に応じてセットアップの手順を選択します。
AKS エンジンと Azure Stack のバージョンマッピングテーブルで、AKS エンジンのバージョンを確認します。この AKS ベースのエンジンは、ご自分の Azure Stack Hub の Marketplace で入手できるようになっている必要があります。コマンドを実行するときに、バージョン --version v0.xx.x を指定する必要があります。バージョンを指定しない場合、コマンドは最新バージョンをインストールします。これは、マーケットプレースで使用できない VHD イメージが必要になる場合があります。

Note

Azure Stack Hub と AKS エンジンのバージョン番号のマッピングについては、AKS エンジンのリリースノートをご覧ください。
管理者特権でのプロンプトで次のコマンドを実行し、バージョン番号を含めます。

Note

AKSe バージョン 0.75.3 以降の場合、AKS エンジンをインストールするコマンドはです choco install aks-engine-azurestack。
```
    choco install aks-engine --version 0.xx.x -y
```
注意

このインストール方法が失敗した場合は、以下の切断された環境の手順を試すことができます。

切断された環境に AKS エンジンをインストールする

インターネットから切断されている Azure Stack Hub 上のお使いの Kubernetes クラスターは、クライアント VM をインストールして管理できます。

インターネットにアクセスできるコンピューターから、GitHub Azure/aks-engine に移動します。 aks-engine-v0.xx.x-windows-amd64.tar.gz など、Windows マシンのアーカイブ (*.tar.gz) をダウンロードします。サポート対象の Kubernetes バージョンの表で、その AKS エンジンのバージョンを確認します。
お使いの Azure Stack Hub インスタンスにストレージアカウントを作成し、AKS エンジンバイナリを使用してアーカイブファイル (*.tar.gz) をアップロードします。 Azure Storage Explorer の使用方法については、Azure Stack Hub と Azure Storage Explorer に関するページを参照してください。
Azure Stack Hub で Windows VM を作成します。手順については、「クイックスタート:Azure Stack Hub ポータルを使用して Windows サーバー VM を作成する」を参照してください
アーカイブファイル (* tar.gz) をアップロードした Azure Stack Hub ストレージアカウントの BLOB URL から、お使いの管理 VM にファイルをダウンロードします。コマンドプロンプトから、アクセス権のあるディレクトリにアーカイブを抽出します。
お使いの VM に接続します。
PowerShell の手順に従って Chocolatey をインストールします。
管理者特権でのプロンプトで、次のコマンドを実行します。適切なバージョン番号を含めます。

注意

AKSe バージョン 0.75.3 以降の場合、AKS エンジンをインストールするコマンドはです choco install aks-engine-azurestack。
```
    choco install aks-engine --version 0.xx.x -y
```

インストールの確認

クライアント VM を設定したら、AKS エンジンをインストールしたことをチェックします。

お使いのクライアント VM に接続します。
次のコマンドを実行します。

Note

AKSe バージョン 0.75.3 以降の場合、AKS エンジンの現在のバージョンをチェックするコマンドはですaks-engine-azurestack version。
```
aks-engine version
```

クライアント VM に AKS エンジンがインストールされていることを確認できない場合は、「 AKS エンジンのインストールのトラブルシューティング」を参照してください。

ASDK のインストール

ASDK の外部のマシンで ASDK 上で AKS エンジンのクライアント VM を実行する場合は、証明書を追加する必要があります。 ASDK 環境内で Windows VM を使用している場合、マシンでは既に ASDK 証明書が信頼されています。クライアントマシンが ASDK の外部にある場合は、ASDK から証明書を抽出し、Windows マシンに追加する必要があります。

ご自分の Azure Resource Manager エンドポイントが自己署名証明書を使用する ASDK を使用している場合、コンピューターの信頼された証明書ストアにこの証明書を明示的に追加する必要があります。 ASDK のルート証明書は、ASDK にデプロイするすべての VM にあります。

CA ルート証明書をエクスポートします。手順については、「Azure Stack Hub の CA ルート証明書をエクスポートする」を参照してください。
Azure Stack Hub の CA ルート証明書を信頼します。手順については、「Azure Stack Hub の CA ルート証明書を信頼する」を参照してください。

次のステップ

Azure Stack Hub に AKS エンジンを使用して Kubernetes クラスターをデプロイする