Azure CLI を使用して Azure Kubernetes Service (AKS) クラスター上に Windows Server コンテナーをデプロイする

[アーティクル]
08/02/2024

Azure Kubernetes Service (AKS) は、クラスターをすばやくデプロイおよび管理することができる、マネージド Kubernetes サービスです。この記事では、Azure CLI を使用して Windows Server コンテナーを実行する AKS クラスターをデプロイします。また、Windows Server コンテナー内の ASP.NET サンプルアプリケーションをクラスターにデプロイします。

Note

AKS クラスターの迅速なプロビジョニングを開始するため、この記事には、評価のみを目的とした既定の設定でクラスターをデプロイする手順が含まれています。運用環境に対応したクラスターをデプロイする前に、ベースライン参照アーキテクチャを理解して、ビジネス要件にどの程度合致しているかを検討することをお勧めします。

開始する前に

このクイックスタートは、Kubernetes の基本的な概念を理解していることを前提としています。詳細については、「Azure Kubernetes Services (AKS) における Kubernetes の中心概念」を参照してください。

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンスコマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
- ローカルインストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。認証プロセスを完了するには、ターミナルに表示される手順に従います。その他のサインインオプションについては、Azure CLI でのサインインに関するページを参照してください。
- 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
- az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。最新バージョンにアップグレードするには、az upgrade を実行します。

この記事では、Azure CLI のバージョン 2.0.64 以降が必要です。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。
クラスターの作成に使用している ID に、適切な最小限のアクセス許可が与えられていることを確認します。 AKS のアクセスと ID の詳細については、「Azure Kubernetes Service (AKS) でのアクセスと ID オプション」を参照してください。
複数の Azure サブスクリプションをお持ちの場合は、az account set コマンドを使用して、リソースが課金の対象となる適切なサブスクリプション ID を選択してください。詳細については、Azure CLI で Azure サブスクリプションを管理する方法に関するページを参照してください。

リソースグループを作成する

Azure リソースグループは、Azure リソースが展開され管理される論理グループです。リソースグループを作成する際は、場所を指定するよう求められます。この場所は、リソースグループのメタデータが格納される場所です。また、リソースの作成時に別のリージョンを指定しない場合は、Azure でリソースが実行される場所です。

az group create コマンドを使用して、リソースグループを作成します。次の例では、myResourceGroup という名前のリソースグループを eastus に作成します。次のコマンドとこの記事内のその他のコマンドを BASH シェルに入力します。
```
az group create --name myResourceGroup --location eastus
```
次の出力例は、正常に作成されたリソースグループを示しています。
```
{
  "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
  "location": "eastus",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": null
}
```

AKS クラスターを作成する

このセクションでは、次の構成で AKS クラスターを作成します。

クラスターは、確実に動作するように 2 つのノードで構成されます。ノードは、Kubernetes ノードコンポーネントとコンテナーランタイムを実行する Azure 仮想マシン (VM) です。
クラスター上のすべての Windows Server ノードの管理者資格情報は、--windows-admin-password パラメーターと --windows-admin-username パラメーターによって設定されます。これは Windows Server のパスワード要件を満たしている必要があります。
ノードプールは VirtualMachineScaleSets を使用します。

Azure CLI を使用して AKS クラスターを作成するには、以下の手順に従います。

クラスターの Windows Server ノードの管理者資格情報として使用するユーザー名を作成します。次のコマンドを実行すると、ユーザー名の入力が求められ、後のコマンドで使用できるように WINDOWS_USERNAME と設定されます。
```
echo "Please enter the username to use as administrator credentials for Windows Server nodes on your cluster: " && read WINDOWS_USERNAME
```
前の手順で作成した管理者ユーザー名のパスワードを作成します。パスワードは 14 文字以上で、Windows Server パスワードの複雑さの要件を満たしている必要があります。
```
echo "Please enter the password to use as administrator credentials for Windows Server nodes on your cluster: " && read WINDOWS_PASSWORD
```
az aks create コマンドを使用してクラスターを作成し、--windows-admin-username および --windows-admin-password パラメーターを指定します。次のコマンド例では、前のコマンドで設定した WINDOWS_USERNAME の値を使用してクラスターを作成します。または、WINDOWS_USERNAME を使用する代わりに、パラメーターに直接別のユーザー名を指定することもできます。
```
az aks create \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --node-count 2 \
    --enable-addons monitoring \
    --generate-ssh-keys \
    --windows-admin-username $WINDOWS_USERNAME \
    --windows-admin-password $WINDOWS_PASSWORD \
    --vm-set-type VirtualMachineScaleSets \
    --network-plugin azure
```
数分後、コマンドが完了し、クラスターに関する情報が JSON 形式で返されます。場合によっては、クラスターのプロビジョニングに数分以上かかることがあります。プロビジョニングには最大 10 分かかります。

パスワード検証エラーが発生し、設定したパスワードが長さと複雑さの要件を満たしている場合は、別のリージョンにリソースグループを作成してみてください。その後、新しいリソースグループを使用してクラスターを作成してください。

ノードプールの作成時に管理者のユーザー名とパスワードを指定しない場合、ユーザー名は azureuser に設定され、パスワードはランダムな値に設定されます。詳細については、「Windows Server に関する FAQ」を参照してください

管理者のユーザー名は変更できませんが、az aks update を使用して AKS クラスターが Windows Server ノードに使用する管理者パスワードを変更することはできます。詳細については、「Windows Server に関する FAQ」を参照してください。

Windows Server コンテナー用のノードプールをサポートする AKS クラスターを実行するには、Azure CNI の (高度な) ネットワークプラグインを使用するネットワークポリシーを、ご利用のクラスターで使用する必要があります。 --network-plugin azure パラメーターは Azure CNI を指定します。

ノードプールを追加する

既定では、Linux コンテナーを実行できるノードプールを使用して、AKS クラスターが作成されます。 Linux ノードプールと共に Windows Server コンテナーを実行できる別のノードプールを追加する必要があります。

Kubernetes バージョン 1.25.0 以降の場合、Windows Server 2022 が既定のオペレーティングシステムです。 Windows Server 2019 は、以前のバージョンの既定の OS です。特定の OS SKU を指定しない場合、Azure によって、クラスターで使用される Kubernetes のバージョンの既定の SKU を使用して新しいノードプールが作成されます。

既定の OS SKU を使用するには、OS SKU を指定せずにノードプールを作成します。ノードプールは、クラスターの Kubernetes バージョンに基づき、既定のオペレーティングシステムに対して設定されます。

az aks nodepool add コマンドを使用して、Windows ノードプールを追加します。次のコマンドでは、npwin という名前の新しいノードプールが作成され、それが myAKSCluster に追加されます。コマンドではまた、az aks create の実行時に作成された既定の仮想ネットワークの既定のサブネットが使用されます。 OS SKU が指定されていないため、ノードプールは、クラスターの Kubernetes バージョンに基づいて既定のオペレーティングシステムに設定されます。

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --os-type Windows \
    --name npwin \
    --node-count 1

Windows Server 2022 を使用するには、以下のパラメーターを指定します。

os-type を Windows に設定
os-sku を Windows2022 に設定

Note

Windows Server 2022 には、Kubernetes バージョン 1.23.0 以降が必要です。 Windows Server 2022 は、Kubernetes バージョン 1.34 がサポート終了 (EOL) に達した後に廃止されました。この廃止の詳細については、AKS リリースノートを参照してください。

以下のように az aks nodepool add コマンドを使用して、Windows Server 2022 ノードプールを追加します。

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --os-type Windows \
    --os-sku Windows2022 \
    --name npwin \
    --node-count 1

Windows Server 2019 を使用するには、以下のパラメーターを指定します。

os-type を Windows に設定
os-sku を Windows2019 に設定

Note

Windows Server 2019 は、Kubernetes バージョン 1.32 がサポート終了 (EOL) に達した後に廃止され、今後のリリースではサポートされません。この廃止の詳細については、AKS リリースノートを参照してください。

以下のように az aks nodepool add コマンドを使用して、Windows Server 2019 ノードプールを追加します。

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --os-type Windows \
    --os-sku Windows2019 \
    --name npwin \
    --node-count 1

クラスターに接続する

Kubernetes クラスターを管理するには、Kubernetes のコマンドラインクライアントである kubectl を使用します。 Azure Cloud Shell を使用している場合、kubectl は既にインストールされています。 kubectl をローカルにインストールして実行したい場合は、az aks install-cli コマンドを呼び出します。

az aks get-credentials コマンドを使用して、Kubernetes クラスターに接続するように kubectl を構成します。このコマンドは、資格情報をダウンロードし、それを使用するように Kubernetes CLI を構成します。
```
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
```

クラスターノードの一覧を返す kubectl get コマンドを使用してクラスターへの接続を確認します。

kubectl get nodes -o wide

次の出力例は、クラスター内のすべてのノードを示しています。すべてのノードの状態が [準備完了] であることを確認します。

NAME                                STATUS   ROLES   AGE   VERSION   INTERNAL-IP   EXTERNAL-IP   OS-IMAGE                         KERNEL-VERSION      CONTAINER-RUNTIME
aks-nodepool1-20786768-vmss000000   Ready    agent   22h   v1.27.7   10.224.0.4    <none>        Ubuntu 22.04.3 LTS               5.15.0-1052-azure   containerd://1.7.5-1
aks-nodepool1-20786768-vmss000001   Ready    agent   22h   v1.27.7   10.224.0.33   <none>        Ubuntu 22.04.3 LTS               5.15.0-1052-azure   containerd://1.7.5-1
aksnpwin000000                      Ready    agent   20h   v1.27.7   10.224.0.62   <none>        Windows Server 2022 Datacenter   10.0.20348.2159     containerd://1.6.21+azure

Note

各ノードプールのコンテナーランタイムは、 コンテナーランタイムの下に表示されます。コンテナーランタイムの値は containerd:// で始まり、これはそれぞれがコンテナーランタイムとして containerd を使用することを意味します。

アプリケーションをデプロイする

Kubernetes のマニフェストファイルでは、どのコンテナーイメージを実行するかなど、クラスターの望ましい状態を定義します。この記事では、Windows Server コンテナー内で ASP.NET サンプルアプリケーションを実行するために必要なすべてのオブジェクトを作成するのにマニフェストを使用します。このマニフェストには、ASP.NET サンプルアプリケーションの Kubernetes デプロイと、インターネットからアプリケーションにアクセスするための外部 Kubernetes サービスが含まれています。

ASP.NET サンプルアプリケーションは、.NET Framework のサンプルの一部として提供され、Windows Server コンテナー内で実行されます。 AKS では、Windows Server コンテナーは Windows Server 2019 以降のイメージをベースにしている必要があります。 Kubernetes マニフェストファイルではまた、ノードセレクターを定義する必要があり、この定義では、Windows Server コンテナーを実行できるノード上でご利用の ASP.NET サンプルアプリケーションのポッドを実行するように AKS クラスターに指示します。

sample.yaml という名前のファイルを作成し、以下の YAML 定義をコピーします。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: sample
  labels:
    app: sample
spec:
  replicas: 1
  template:
    metadata:
      name: sample
      labels:
        app: sample
    spec:
      nodeSelector:
        "kubernetes.io/os": windows
      containers:
      - name: sample
        image: mcr.microsoft.com/dotnet/framework/samples:aspnetapp
        resources:
          limits:
            cpu: 1
            memory: 800M
        ports:
          - containerPort: 80
  selector:
    matchLabels:
      app: sample
---
apiVersion: v1
kind: Service
metadata:
  name: sample
spec:
  type: LoadBalancer
  ports:
  - protocol: TCP
    port: 80
  selector:
    app: sample

YAML マニフェストファイルの内訳については、「デプロイと YAML マニフェスト」を参照してください。

YAML ファイルをローカルに作成して保存する場合は、[ファイルのアップロード/ダウンロード] ボタンを選択し、ローカルファイルシステムからファイルを選択することで、CloudShell の既定のディレクトリにマニフェストファイルをアップロードできます。

kubectl apply コマンドを使用してアプリケーションをデプロイし、ご利用の YAML マニフェストの名前を指定します。
```
kubectl apply -f sample.yaml
```
次の出力例は、デプロイおよびサービスが正常に作成されたことを示しています。
```
deployment.apps/sample created
service/sample created
```

アプリケーションをテストする

アプリケーションが実行されると、Kubernetes サービスによってアプリケーションフロントエンドがインターネットに公開されます。このプロセスが完了するまでに数分かかることがあります。場合によっては、サービスのプロビジョニングに数分以上かかることがあります。プロビジョニングには最大 10 分かかります。

kubectl get pods コマンドを使って、デプロイされたポッドの状態を確認します。続行する前に、すべてのポッドを Running の状態にします。
```
kubectl get pods
```
kubectl get service コマンドと --watch 引数を使用して、進行状況を監視します。
```
kubectl get service sample --watch
```
最初に、サンプルサービスの EXTERNAL-IP が "保留中" として表示されます。
```
NAME               TYPE           CLUSTER-IP   EXTERNAL-IP   PORT(S)        AGE
sample             LoadBalancer   10.0.37.27   <pending>     80:30572/TCP   6s
```
EXTERNAL-IP アドレスが "保留中" から実際のパブリック IP アドレスに変わったら、CTRL-C を使用して kubectl ウォッチプロセスを停止します。次のサンプル出力は、サービスに割り当てられている有効なパブリック IP アドレスを示しています。
```
sample  LoadBalancer   10.0.37.27   52.179.23.131   80:30572/TCP   2m
```
Web ブラウザーを開いてサービスの外部 IP アドレスにアクセスして、サンプルアプリが動作していることを確認します。

リソースを削除する

AKS チュートリアルを実行する予定がない場合は、Azure の料金が発生しないようにクラスターを削除する必要があります。

az group delete コマンドを使用して、リソースグループ、コンテナーサービス、およびすべての関連リソースを削除します。

az group delete --name myResourceGroup --yes --no-wait

Note

AKS クラスターは、システム割り当てマネージド ID (このクイックスタートで使用される既定の ID オプション) を使用して作成されました。 Azure プラットフォームで ID を管理するため、削除する必要はありません。

次のステップ

このクイックスタートでは、Kubernetes クラスターをデプロイした後、そこへ Windows Server コンテナー内の ASP.NET サンプルアプリケーションをデプロイしました。このサンプルアプリケーションはデモ専用であり、Kubernetes アプリケーションのすべてのベストプラクティスを表すわけではありません。実稼動用に AKS を使用した完全なソリューションを作成するうえでのガイダンスについては、AKS ソリューションガイダンスに関する記事を参照してください。

AKS の詳細を学習し、コードからデプロイまでの完全な例を確認するには、Kubernetes クラスターチュートリアルに進んでください。

AKS チュートリアル

次の方法で共有

Azure CLI を使用して Azure Kubernetes Service (AKS) クラスター上に Windows Server コンテナーをデプロイする

開始する前に

リソースグループを作成する

AKS クラスターを作成する

ノードプールを追加する

クラスターに接続する

アプリケーションをデプロイする

アプリケーションをテストする

リソースを削除する

次のステップ

その他のリソース

次の方法で共有

Azure CLI を使用して Azure Kubernetes Service (AKS) クラスター上に Windows Server コンテナーをデプロイする

開始する前に

リソース グループを作成する

AKS クラスターを作成する

ノード プールを追加する

クラスターに接続する

アプリケーションをデプロイする

アプリケーションをテストする

リソースを削除する

次のステップ

その他のリソース

リソースグループを作成する

ノードプールを追加する