クイックスタート: Azure Kubernetes Service (AKS) Automatic クラスターをデプロイする (プレビュー)

• 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 Automatic クラスターの作成

AKS Automatic クラスターを作成するには、az aks create コマンドを使います。 次の例では、マネージド Prometheus とコンテナーの分析情報の統合を有効にして、myAKSAutomaticCluster という名前のクラスターを作成します。

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

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

クラスターに接続する

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

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

ログイン後、次のサンプル出力は、前の手順で作成されたマネージド ノード プールを示しています。 ノードの状態が [Ready] であることを確認してください。

NAME                                STATUS   ROLES   AGE     VERSION
aks-default-f8vj2                   Ready    agent   2m26s   v1.28.5
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

Automatic Kubernetes クラスターを作成する

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

   

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

   

   前提条件が満たされておらず、サブスクリプションでプレビュー フラグの登録が必要な場合は、[サブスクリプション] フィールドにエラーが表示されます。

   

3. [監視] タブで、Azure Monitor、マネージド Prometheus、Managed Grafana から監視構成を選んだり、アラートを構成したりできます。 タグを追加し (省略可能)、クラスターの作成に進みます。

   

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

   

クラスターに接続する

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

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

ログイン後、次のサンプル出力は、前の手順で作成されたマネージド ノード プールを示しています。 ノードの状態が [Ready] であることを確認してください。

NAME                                STATUS   ROLES   AGE     VERSION
aks-default-f8vj2                   Ready    agent   2m26s   v1.28.5
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 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'
  		tier: 'Standard'
  }
  properties: {
    agentPoolProfiles: [
      {
        name: 'systempool'
        count: 3
        vmSize: 'Standard_DS4_v2'
        osType: 'Linux'
        mode: 'System'
      }
    ]
  }
  identity: {
    type: 'SystemAssigned'
  }
}

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

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

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

   重要

   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 Automatic クラスターは、Kubernetes ロールベースのアクセス制御 (RBAC) 用に Microsoft Entra ID を使って構成されます。 Bicep を使ってクラスターを作成する場合は、組み込みロールの 1 つ (Azure Kubernetes Service RBAC Reader、Azure Kubernetes Service RBAC Writer、Azure Kubernetes Service RBAC Admin、または Azure Kubernetes Service RBAC Cluster Admin など) を、クラスターまたは特定の名前空間のスコープでユーザーに割り当てる必要があります。 また、ユーザーが az aks get-credentials を実行できる Azure Kubernetes Service Cluster User 組み込みロールを持っていることを確認してから、az aks get-credentials コマンドを使って AKS クラスターの kubeconfig を取得します。

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

ログイン後、次のサンプル出力は、前の手順で作成されたマネージド ノード プールを示しています。 ノードの状態が [Ready] であることを確認してください。

NAME                                STATUS   ROLES   AGE     VERSION
aks-default-f8vj2                   Ready    agent   2m26s   v1.28.5
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