クイック スタート: Azure Kubernetes Service (AKS)自動クラスターを作成する

適用対象: ✔️ AKS Automatic

Azure Kubernetes Service (AKS) Automatic は、AKS クラスターのセットアップと操作を自動化し、ベスト プラクティス構成を埋め込むマネージド Kubernetes エクスペリエンスです。 AKS Automatic には、[ポッドの準備 SLA][azure-sla] も含まれています。これにより、5 分以内に 99.9% の適格なポッド準備操作が完了し、アプリケーションの信頼性の高い自己復旧インフラストラクチャが保証されます。 このクイックスタートでは、次の方法について説明します。

• AKS 自動クラスターをデプロイします。
• マイクロサービスのグループと、小売シナリオをシミュレートする Web フロントエンドを使用して、サンプルのマルチコンテナー アプリケーションを実行します。

開始する前に

• このクイックスタートは、Kubernetes の基本的な概念を理解していることを前提としています。 詳細については、Azure Kubernetes Service (AKS) の Kubernetes のコア概念を参照してください。
• AKS の自動機能で AKS クラスター上の Azure Policy を有効にしますが、事前にサブスクリプションに リソース プロバイダーを登録する必要があります。 詳細については、「Azure リソース プロバイダーと種類を参照してください。

制限事項

• AKS 自動クラスターのシステム ノードプールは、少なくとも 3 つの可用性ゾーン、エフェメラル OS ディスク、Azure Linux OS をサポートする Azure リージョンにデプロイする必要があります。
• AKS Automatic は、australiaeast、austriaeast、belgiumcentral、brazilsouth、canadacentral、centralindia、centralus、chilecentral、denmarkeast、eastasia、eastus、eastus2、francecentral、germanywestcentral、indonesiacentral、israelcentral、italynorth、japaneast、japanwest、koreacentral、malaysiawest、mexicocentral、newzealandnorth、northcentralus、northeurope、norwayeast、polandcentral、southafricanorth、southcentralus、southeastasia、spaincentral、swedencentral、switzerlandnorth、uaenorth、uksouth、westeurope、westus、westus2、westus3。
• AKS 自動クラスターには、node リソース グループのロックダウンが事前に構成されています。これにより、MC_ リソース グループへの変更が許可されないため、既定の プライベート DNS ゾーンでの仮想ネットワーク リンクが防止されます。 クロス VNet またはカスタム DNS シナリオの場合は、カスタム仮想ネットワークにプライベート Azure Kubernetes Service (AKS)自動クラスターを作成>に従って、カスタム ネットワークとプライベート DNS を使用します。

az group create --name myResourceGroup --location eastus

{
  "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
  "location": "eastus",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

az aks create \
    --resource-group myResourceGroup \
    --name myAKSAutomaticCluster \
    --sku automatic

@description('The name of the managed cluster resource.')
param clusterName string = 'myAKSAutomaticCluster'

@description('The location of the managed cluster resource.')
param location string = resourceGroup().location

resource aks 'Microsoft.ContainerService/managedClusters@2024-03-02-preview' = {
  name: clusterName
  location: location  
  sku: {
  name: 'Automatic'
  }
  properties: {
    agentPoolProfiles: [
      {
        name: 'systempool'
        mode: 'System'
  count: 3
      }
    ]
  }
  identity: {
    type: 'SystemAssigned'
  }
}

クラスターに接続する

Kubernetes クラスターを管理するには、Kubernetes のコマンドライン クライアントである kubectl を使います。 Azure Cloud Shellを使用する場合、kubectl は既にインストールされています。 kubectl コマンドを使用して、az aks install-cliをローカルにインストールできます。 AKS 自動クラスターは、Kubernetes ロールベースのアクセス制御 (RBAC) 用に Microsoft Entra ID で構成されます。

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

   az aks get-credentials --resource-group myResourceGroup --name myAKSAutomaticCluster
   

2. kubectl get コマンドを使用して、ご利用のクラスターへの接続を確認します。 このコマンドでは、クラスター ノードの一覧が返されます。

   kubectl get nodes
   

   次の出力例は、ログインを求められる方法を示しています。

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code AAAAAAAAA to authenticate.
   

   ログインすると、次のサンプル出力にマネージド システム ノード プールが表示されます。 ノードの状態が [準備完了] になっていることを確認します。

   NAME                                STATUS   ROLES   AGE     VERSION
   aks-nodepool1-12345678-vmss000000   Ready    agent   2m26s   v1.28.5
   aks-nodepool1-12345678-vmss000001   Ready    agent   2m26s   v1.28.5
   aks-nodepool1-12345678-vmss000002   Ready    agent   2m26s   v1.28.5
   

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

アプリケーションをデプロイするには、マニフェスト ファイルを使用して、AKS ストア アプリケーションの実行に必要なすべてのオブジェクトを作成します。 Kubernetes マニフェスト ファイルは、実行するコンテナー イメージなど、クラスターの望ましい状態を定義します。 マニフェストには、次の Kubernetes のデプロイとサービスが含まれています。

• ストア フロント: 顧客が製品を表示して注文するための Web アプリケーション。
• 製品サービス: 製品情報を表示します。
• 注文サービス: 注文を行います。
• Rabbit MQ: 注文キュー用のメッセージキュー。

1. Kubernetes リソースをデプロイするための名前空間 aks-store-demo を作成します。

   kubectl create ns aks-store-demo
   

2. kubectl apply コマンドを使用して、aks-store-demo名前空間にアプリケーションをデプロイします。 デプロイを定義する YAML ファイルは、GitHubにあります。

   kubectl apply -n aks-store-demo -f https://raw.githubusercontent.com/Azure-Samples/aks-store-demo/main/aks-store-ingress-quickstart.yaml
   

   次の出力例は、デプロイとサービスを示しています。

   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
   ingress/store-front created
   

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

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

1. kubectl get pods コマンドを使用して、デプロイされたポッドの状態を確認します。 続行する前に、すべてのポッドが Running されていることを確認します。 これがデプロイする最初のワークロードである場合、 ノードの自動プロビジョニング によってポッドを実行するノード プールが作成されるまでに数分かかる場合があります。

   kubectl get pods -n aks-store-demo
   

2. ストア フロント アプリケーションのパブリック IP アドレスを確認します。 kubectl get service コマンドと --watch 引数を使用して進行状況を監視します。

   kubectl get ingress store-front -n aks-store-demo --watch
   

   ADDRESS 出力は、最初は空として表示されます。

   NAME          CLASS                                HOSTS   ADDRESS        PORTS   AGE
   store-front   webapprouting.kubernetes.azure.com   *                      80      12m
   

3. ADDRESS が空白から実際のパブリック IP アドレスに変わったら、CTRL-Cを使用してkubectl監視プロセスを停止します。

   次の出力例は、サービスに割り当てられている有効なパブリック IP アドレスを示しています。

   NAME          CLASS                                HOSTS   ADDRESS        PORTS   AGE
   store-front   webapprouting.kubernetes.azure.com   *       4.255.22.196   80      12m
   

4. イングレスの外部 IP アドレスに対して Web ブラウザーを開き、Azure ストア アプリの動作を確認します。

   

クラスターを削除する

AKS チュートリアルを実行する予定がない場合は、不要なリソースをクリーンアップしてAzure料金を回避します。

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

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

関連するコンテンツ

このクイック スタートでは、 AKS Automatic を使用して Kubernetes クラスターをデプロイし、それに単純なマルチコンテナー アプリケーションをデプロイしました。 このサンプル アプリケーションはデモ専用であり、Kubernetes アプリケーションのすべてのベスト プラクティスを表すわけではありません。 運用環境用の AKS を使用して完全なソリューションを作成する方法のガイダンスについては、 AKS ソリューションのガイダンスを参照してください。

AKS Automatic の詳細については、Azure Kubernetes Service (AKS) Automatic の紹介をご覧ください。