Azure Kubernetes Service (AKS) でデュアルスタック ネットワークを使用する

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

az group create --location <region> --name <resourceGroupName>

az aks create パラメーターが --ip-families に設定された ipv4,ipv6 コマンドを使用して、デュアルスタック AKS クラスターを作成します。

az aks create \
    --location <region> \
    --resource-group <resourceGroupName> \
    --name <clusterName> \
    --network-plugin azure \
    --network-plugin-mode overlay \
    --ip-families ipv4,ipv6 \
    --generate-ssh-keys

クラスターを作成したら、 az aks get-credentials コマンドを使用してクラスターの資格情報を取得します。

az aks get-credentials --resource-group <resourceGroupName> --name <clusterName>

ARM テンプレートを作成し、networkProfile オブジェクトの ipFamilies プロパティを ["IPv4", "IPv6"] に設定します。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "clusterName": {
      "type": "string",
      "defaultValue": "aksdualstack"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "nodeCount": {
      "type": "int",
      "defaultValue": 3
    },
    "nodeSize": {
      "type": "string",
      "defaultValue": "Standard_B2ms"
    }
  },
  "resources": [
    {
      "type": "Microsoft.ContainerService/managedClusters",
      "apiVersion": "2026-03-01",
      "name": "[parameters('clusterName')]",
      "location": "[parameters('location')]",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "agentPoolProfiles": [
          {
            "name": "nodepool1",
            "count": "[parameters('nodeCount')]",
            "mode": "System",
            "vmSize": "[parameters('nodeSize')]"
          }
        ],
        "dnsPrefix": "[parameters('clusterName')]",
        "networkProfile": {
          "networkPlugin": "azure",
          "networkPluginMode": "overlay",
          "ipFamilies": [
            "IPv4",
            "IPv6"
          ]
        }
      }
    }
  ]
}

クラスターを作成したら、 az aks get-credentials コマンドを使用してクラスターの資格情報を取得します。

az aks get-credentials --resource-group <resourceGroupName> --name <clusterName>

Bicep テンプレートを作成し、networkProfile オブジェクトの ipFamilies プロパティを ["IPv4", "IPv6"] に設定します。

param clusterName string = 'aksdualstack'
param location string = resourceGroup().location
param nodeCount int = 3
param nodeSize string = 'Standard_B2ms'

resource aksCluster 'Microsoft.ContainerService/managedClusters@2026-03-01' = {
  name: clusterName
  location: location
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    agentPoolProfiles: [
      {
        name: 'nodepool1'
        count: nodeCount
        mode: 'System'
        vmSize: nodeSize
      }
    ]
    dnsPrefix: clusterName
    networkProfile: {
      networkPlugin: 'azure'
      networkPluginMode: 'overlay'
      ipFamilies: [
        'IPv4'
        'IPv6'
      ]
    }
  }
}

クラスターを作成したら、 az aks get-credentials コマンドを使用してクラスターの資格情報を取得します。

az aks get-credentials --resource-group <resourceGroupName> --name <clusterName>

kubectl create deployment nginx コマンドを実行して NGINX Web サーバーを作成します。

kubectl create deployment nginx --image=nginx:latest --replicas=3

kubectl get pods コマンドを実行してポッド リソースを表示します。

kubectl get pods -o custom-columns="NAME:.metadata.name,IPs:.status.podIPs[*].ip,NODE:.spec.nodeName,READY:.status.conditions[?(@.type=='Ready')].status"

出力は、ポッドに IPv4 と IPv6 の両方のアドレスがあることを示しています。 ポッドには、準備ができるまで IP アドレスは表示されません。

NAME                     IPs                                NODE                                READY
nginx-55649fd747-9cr7h   10.244.2.2,fd12:3456:789a:0:2::2   aks-nodepool1-14508455-vmss000002   True
nginx-55649fd747-p5lr9   10.244.0.7,fd12:3456:789a::7       aks-nodepool1-14508455-vmss000000   True
nginx-55649fd747-r2rqh   10.244.1.2,fd12:3456:789a:0:1::2   aks-nodepool1-14508455-vmss000001   True

次の YAML マニフェストを使用して NGINX Web サーバーを作成します。

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: nginx
  name: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx:latest
        name: nginx

kubectl get pods コマンドを実行してポッド リソースを表示します。

kubectl get pods -o custom-columns="NAME:.metadata.name,IPs:.status.podIPs[*].ip,NODE:.spec.nodeName,READY:.status.conditions[?(@.type=='Ready')].status"

出力は、ポッドに IPv4 と IPv6 の両方のアドレスがあることを示しています。 ポッドには、準備ができるまで IP アドレスは表示されません。

NAME                     IPs                                NODE                                READY
nginx-55649fd747-9cr7h   10.244.2.2,fd12:3456:789a:0:2::2   aks-nodepool1-14508455-vmss000002   True
nginx-55649fd747-p5lr9   10.244.0.7,fd12:3456:789a::7       aks-nodepool1-14508455-vmss000000   True
nginx-55649fd747-r2rqh   10.244.1.2,fd12:3456:789a:0:1::2   aks-nodepool1-14508455-vmss000001   True

kubectl expose deployment nginx コマンドを使用して、個別の IPv4 および IPv6 LoadBalancer サービスを使用して NGINX デプロイを公開します。

kubectl expose deployment nginx --name=nginx-ipv4 --port=80 --type=LoadBalancer
kubectl expose deployment nginx --name=nginx-ipv6 --port=80 --type=LoadBalancer --overrides='{"spec":{"externalTrafficPolicy":"Local","ipFamilies":["IPv6"]}}'

サービスが公開されていることを示す出力を受け取ります。

service/nginx-ipv4 exposed
service/nginx-ipv6 exposed

デプロイを公開し、 LoadBalancer サービスを完全にプロビジョニングしたら、 kubectl get services コマンドを使用してサービスの IP アドレスを取得します。

kubectl get services

NAME         TYPE           CLUSTER-IP               EXTERNAL-IP         PORT(S)        AGE
nginx-ipv4   LoadBalancer   10.0.88.78               20.46.24.24         80:30652/TCP   97s
nginx-ipv6   LoadBalancer   fd12:3456:789a:1::981a   2603:1030:8:5::2d   80:32002/TCP   63s

IPv6 アドレスが割り当てられ、IPv6 ルーティングが構成されている Linux VM またはオンプレミス のマシンの機能を確認します。 Azure Cloud Shellは IPv6 をサポートしていません。

SERVICE_IP=$(kubectl get services nginx-ipv6 -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
curl -s "http://[${SERVICE_IP}]" | head -n5

<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
<style>

次の YAML マニフェストを使用して、個別の IPv4 および IPv6 LoadBalancer サービスで NGINX デプロイを公開します。

---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: nginx
  name: nginx-ipv4
spec:
  externalTrafficPolicy: Cluster
  ports:
    - port: 80
      protocol: TCP
      targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: nginx
  name: nginx-ipv6
spec:
  externalTrafficPolicy: Local
  ipFamilies:
    - IPv6
  ports:
    - port: 80
      protocol: TCP
      targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer

デプロイを公開し、 LoadBalancer サービスを完全にプロビジョニングしたら、 kubectl get services コマンドを使用してサービスの IP アドレスを取得します。

kubectl get services

NAME         TYPE           CLUSTER-IP               EXTERNAL-IP         PORT(S)        AGE
nginx-ipv4   LoadBalancer   10.0.88.78               20.46.24.24         80:30652/TCP   97s
nginx-ipv6   LoadBalancer   fd12:3456:789a:1::981a   2603:1030:8:5::2d   80:32002/TCP   63s

IPv6 アドレスが割り当てられ、IPv6 ルーティングが構成されている Linux VM またはオンプレミス のマシンの機能を確認します。 Azure Cloud Shellは IPv6 をサポートしていません。

SERVICE_IP=$(kubectl get services nginx-ipv6 -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
curl -s "http://[${SERVICE_IP}]" | head -n5

<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
<style>