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

• Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の概要」を参照してください。

  

• CLI 参照コマンドをローカルで実行する場合は、Azure CLI を インストール します。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

  • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、「 Azure CLI を使用した Azure への認証」を参照してください。

  • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、「Azure CLI で拡張機能を使用および管理する」を参照してください。

  • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

• この記事では、Azure CLI のバージョン 2.77.0 以降が必要です。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。
• 複数の Azure サブスクリプションがある場合は、 az account set コマンドを使用してリソースを課金する適切なサブスクリプション ID を選択します。

• Bicep ファイルをデプロイするには、作成したリソースに対するアクセス権を書き込み、 Microsoft.Resources/deployments リソースの種類に対するすべての操作にアクセスする必要があります。 たとえば、仮想マシンを作成するには、 Microsoft.Compute/virtualMachines/write と Microsoft.Resources/deployments/* アクセス許可が必要です。 ロールとアクセス許可の一覧については、Azure の組み込みロールに関するページを参照してください。

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

Azure リソース グループは、Azure リソースが展開され管理される論理グループです。

次の例では、myResourceGroup という名前のリソース グループを eastus に作成します。

az group create コマンドを使用してリソース グループを作成します。

az group create --name myResourceGroup --___location eastus

次の出力例は、リソース グループの正常な作成に似ています。

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

AKS 自動クラスターを作成する

AKS 自動クラスターを作成するには、 az aks create コマンドを使用します。 次の例では、Managed Prometheus と Container Insights の統合が有効になっている myAKSAutomaticCluster という名前のクラスターを作成します。

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

数分後、コマンドが完了し、クラスターに関する JSON 形式の情報が返されます。

クラスターに接続する

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

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

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

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-13213685-vmss000000   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000001   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000002   Ready    agent   2m26s   v1.28.5

自動 Kubernetes クラスターを作成する

1. AKS 自動クラスターを作成するには、 Kubernetes Services を検索し、ドロップダウン オプションから [自動 Kubernetes クラスター ] を選択します。

   

2. [ 基本 ] タブで、開始するために必要なすべての必須フィールド (サブスクリプション、リソース グループ、Kubernetes クラスター名、リージョン) を入力します。

   

3. [ 監視 ] タブで、Azure Monitor、Managed Prometheus、Grafana Dashboards、Container Network Observability (ACNS) から監視構成を選択するか、アラートを構成します。 Managed Grafana (省略可能) を有効にし、タグを追加して (省略可能)、クラスターの作成に進みます。

   

4. [ 詳細設定 ] タブで、ネットワーク (省略可能)、マネージド ID (省略可能)、セキュリティとマネージド名前空間 (省略可能) の設定を更新し、クラスターの作成に進みます。

   

5. GitHub から最初のアプリケーションの構成を開始し、自動化されたデプロイ パイプラインを設定します。

   

クラスターに接続する

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

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

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

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-13213685-vmss000000   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000001   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000002   Ready    agent   2m26s   v1.28.5

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

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

次の例では、myResourceGroup という名前のリソース グループを eastus に作成します。

az group create コマンドを使用してリソース グループを作成します。

az group create --name myResourceGroup --___location eastus

次の出力例は、リソース グループの正常な作成に似ています。

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

Bicep ファイルを確認する

この Bicep ファイルは、AKS 自動クラスターを定義します。 プレビュー段階では、 システム nodepool エージェント プール プロファイルを指定する必要があります。

@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'
  }
}

Bicep ファイルで定義されているリソースの詳細については、 Microsoft.ContainerService/managedClusters リファレンスを 参照してください。

Bicep ファイルをデプロイする

1. Bicep ファイルを main.bicep としてローカル コンピューターに保存します。

   Important

   Bicep ファイルは、 clusterName パラメーターを 文字列 myAKSAutomaticCluster に設定します。 別のクラスター名を使用する場合は、ファイルをコンピューターに保存する前に、文字列を任意のクラスター名に更新してください。

2. Azure CLI を使用して Bicep ファイルをデプロイします。

   az deployment group create --resource-group myResourceGroup --template-file main.bicep
   

   AKS クラスターの作成には数分かかります。 次の手順に進む前に、クラスターが正常にデプロイされるまで待ちます。

クラスターに接続する

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

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

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

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-13213685-vmss000000   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000001   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000002   Ready    agent   2m26s   v1.28.5