チュートリアル: Azure Kubernetes Service (AKS) にアプリケーションをデプロイする

2024-08-02

Kubernetes には、コンテナー化されたアプリケーション用の分散プラットフォームが用意されています。独自のアプリケーションとサービスをビルドして Kubernetes クラスターにデプロイし、クラスターで可用性と接続性を管理できるようにします。

このチュートリアルでは、Kubernetes クラスターにサンプルアプリケーションをデプロイします。次の方法を学びます：

Kubernetes マニフェストファイルを更新する。
Kubernetes でアプリケーションを実行する。
アプリケーションをテストします。

ヒント

AKS では、構成管理に次の方法を使用できます。

GitOps: クラスターの状態の宣言をクラスターに自動的に適用できるようになります。 GitOps を使用して AKS クラスターでアプリケーションをデプロイする方法については、Flux v2 を使用した GitOps チュートリアルの Azure Kubernetes Service クラスターの前提条件に関する記事を参照してください。
DevOps: 継続的インテグレーション (CI) と継続的デリバリー (CD) でビルド、テスト、およびデプロイを行うことができます。 DevOps を使用して AKS クラスターでアプリケーションをデプロイする方法の例については、「Azure Pipelines を使用して AKS にビルドしてデプロイする」または「Kubernetes にデプロイするための GitHub Actions」を参照してください。

開始する前に

前のチュートリアルでは、アプリケーションをコンテナーイメージにパッケージ化し、そのイメージを Azure Container Registry にアップロードして、Kubernetes クラスターを作成しました。このチュートリアルを完了するには、事前に作成した aks-store-quickstart.yaml Kubernetes マニフェストファイルが必要です。このファイルは、「チュートリアル 1 - AKS 用のアプリケーションの準備」からアプリケーションのソースコードにダウンロードされました。

このチュートリアルには、Azure CLI バージョン 2.0.53 以降が必要です。 az --version を使用して、お使いのバージョンを確認します。インストールまたはアップグレードする必要には、「Azure CLI のインストール」をご覧ください。

マニフェストファイルを更新する

これらのチュートリアルでは、Azure Container Registry (ACR) インスタンスがサンプルアプリケーション用のコンテナーイメージを格納しています。アプリケーションをデプロイするには、Kubernetes マニフェストファイル内のイメージ名を、ACR ログインサーバー名が含まれるように更新する必要があります。

az acr list コマンドを使用してログインサーバーのアドレスを取得し、ログインサーバーのクエリを実行します。
```
az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
```
クローンされた aks-store-demo ディレクトリ内にいることを確認し、テキストエディターで aks-store-quickstart.yaml マニフェストファイルを開きます。

image を ACR ログインサーバー名に置き換えて、コンテナーのプロパティを更新します。

containers:
...
- name: order-service
  image: <acrName>.azurecr.io/aks-store-demo/order-service:latest
...
- name: product-service
  image: <acrName>.azurecr.io/aks-store-demo/product-service:latest
...
- name: store-front
  image: <acrName>.azurecr.io/aks-store-demo/store-front:latest
...

ファイルを保存して閉じます。

Get-AzContainerRegistry コマンドレットを使用してログインサーバーのアドレスを取得し、ログインサーバーのクエリを実行します。 <acrName> は必ず ACR インスタンスの名前に置き換えてください。
```
(Get-AzContainerRegistry -ResourceGroupName myResourceGroup -Name $ACRNAME).LoginServer
```
クローンされた aks-store-demo ディレクトリ内にいることを確認し、テキストエディターで aks-store-quickstart.yaml マニフェストファイルを開きます。

image を ACR ログインサーバー名に置き換えて、コンテナーのプロパティを更新します。

containers:
...
- name: order-service
  image: <acrName>.azurecr.io/aks-store-demo/order-service:latest
...
- name: product-service
  image: <acrName>.azurecr.io/aks-store-demo/product-service:latest
...
- name: store-front
  image: <acrName>.azurecr.io/aks-store-demo/store-front:latest
...

ファイルを保存して閉じます。

アプリケーションの実行

kubectl apply コマンドを使用してアプリケーションをデプロイします。これにより、マニフェストファイルが解析され、定義された Kubernetes オブジェクトが作成されます。

kubectl apply -f aks-store-quickstart.yaml

次の出力例では、AKS クラスター内で正常に作成されたリソースが示されています。

statefulset.apps/rabbitmq created
configmap/rabbitmq-enabled-plugins created
service/rabbitmq created
deployment.apps/order-service created
service/order-service created
deployment.apps/product-service created
service/product-service created
deployment.apps/store-front created
service/store-front created

kubectl get pods コマンドでポッドを表示して、デプロイが成功したことを確認します。
```
kubectl get pods
```

kubectl apply -f aks-store-quickstart.yaml

次の出力例では、AKS クラスター内で正常に作成されたリソースが示されています。

statefulset.apps/rabbitmq created
configmap/rabbitmq-enabled-plugins created
service/rabbitmq created
deployment.apps/order-service created
service/order-service created
deployment.apps/product-service created
service/product-service created
deployment.apps/store-front created
service/store-front created

kubectl get pods コマンドでポッドを表示して、デプロイが成功したことを確認します。
```
kubectl get pods
```

azd でのデプロイは、フックによって表される複数のステージに分割されます。 azd では、既定ですべてのフックを使用してデプロイされます。

azd up コマンドを使用して、アプリケーションをデプロイします。
```
azd up
```

Azure リソースをホストするサブスクリプションとリージョンを選択します。

? Select an Azure Subscription to use:  [Use arrows to move, type to filter]
> 1. My Azure Subscription (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
Select an Azure location to use:  [Use arrows to move, type to filter]
> 43. (US) East US 2 (eastus2)

AZURE_LOCATION と AZURE_SUBSCRIPTION_ID の変数は、.azure/<your-env-name>/.env ファイル内で更新できます。

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

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

コマンドライン

kubectl get service コマンドと --watch 引数を使用して、進行状況を監視します。
```
kubectl get service store-front --watch
```
最初は、EXTERNAL-IP サービスの store-front は <pending> として表示されます。
```
store-front   LoadBalancer   10.0.34.242   <pending>     80:30676/TCP   5s
```
EXTERNAL-IP アドレスが <pending> からパブリック IP アドレスに変わったら、CTRL-C を使用して kubectl 監視プロセスを停止します。

次の出力例は、サービスに割り当てられている有効なパブリック IP アドレスを示しています。
```
store-front   LoadBalancer   10.0.34.242   52.179.23.131   80:30676/TCP   67s
```
Web ブラウザーを開いてサービスの外部 IP アドレス http://<external-ip> に移動し、アプリケーションの動作を確認します。

アプリケーションが読み込まれない場合、イメージレジストリの承認に問題がある可能性があります。コンテナーのステータスを表示するには、kubectl get pods コマンドを使用します。コンテナーイメージをプルできない場合は、「Azure Kubernetes Service から Azure Container Registry の認証を受ける」を参照してください。

Azure portal

Azure portal に移動してデプロイ情報を見つけます。

AKS クラスターリソースに移動します。
サービスメニューの [Kubernetes リソース] で、[サービスとイングレス] を選択します。
store-front サービスの列に表示されている外部 IP をコピーします。
IP をブラウザーに貼り付け、ストアページにアクセスします。

リソースをクリーンアップする

アプリケーションの機能を検証したので、アプリケーションからクラスターを削除できるようになりました。次のチュートリアルでは、アプリケーションを再度デプロイします。

kubectl delete コマンドを使用して、コンテナーインスタンスとリソースを停止して削除します。
```
kubectl delete -f aks-store-quickstart.yaml
```
kubectl get pods コマンドを使用して、すべてのアプリケーションポッドが削除されていることを確認します。
```
kubectl get pods
```

次のステップ

このチュートリアルでは、サンプルの Azure アプリケーションを AKS の Kubernetes クラスターにデプロイしました。以下の方法を学習しました。

Kubernetes マニフェストファイルを更新する。
Kubernetes でアプリケーションを実行する。
アプリケーションをテストします。

次のチュートリアルでは、Kubernetes のステートフルワークロードに PaaS サービスを使用する方法について説明します。

AKS のステートフルワークロードに PaaS サービスを使用する