Azure Kubernetes Service (AKS) 用のアプリケーションルーティングアドオンを使用した高度な NGINX イングレスコントローラーとイングレス構成

この記事では、Azure Kubernetes Service (AKS) のアプリケーションルーティングアドオンを使用してイングレスコントローラーとイングレスオブジェクトを構成する 2 つの方法について説明します。

複数のコントローラーの作成、プライベートロードバランサーの構成、静的 IP アドレスの設定などの NGINX イングレスコントローラーの構成。
注釈を使用したイングレスリソースごとの構成。

前提条件

アプリケーションルーティングアドオンが有効になっている AKS クラスター。
kubectl AKS クラスターに接続するように構成されています。詳細については、「 AKS クラスターへの接続」を参照してください。

ご利用の AKS クラスターに接続する

お使いのローカルコンピューターから Kubernetes クラスターに接続するには、kubectl (Kubernetes コマンドラインクライアント) を使用します。 az aks install-cli コマンドを使用してローカルにインストールできます。 Azure Cloud Shell を使用している場合、kubectl は既にインストールされています。

az aks get-credentials コマンドを使用して、Kubernetes クラスターに接続するように kubectl を構成します。
```
az aks get-credentials --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME
```

NGINX イングレスコントローラーの構成プロパティ

アプリケーションルーティングアドオンは、と呼ばれる NginxIngressController を使用して、NGINX イングレスコントローラーを構成します。さらにイングレスコントローラーを作成することも、既存の構成を変更することもできます。

次の表に、 NginxIngressControllerを構成するために設定できるプロパティを示します。

フィールド	タイプ	説明	必須	既定値
`controllerNamePrefix`	文字列	マネージド NGINX イングレスコントローラーリソースの名前。	イエス	`nginx`
`customHTTPErrors`	アレイ	エラーが発生した場合に既定のバックエンドに送信されるエラーコードの配列。	いいえ
`defaultBackendService`	オブジェクト	一致しない HTTP トラフィックをルーティングするサービス。入れ子になったプロパティが含まれています。	いいえ
`name`	文字列	サービス名	イエス
`namespace`	文字列	サービス名前空間。	イエス
`defaultSSLCertificate`	オブジェクト	既定のバックエンドサービスにアクセスするための既定の証明書が含まれています。入れ子になったプロパティが含まれています。	いいえ
`forceSSLRedirect`	ブーリアン	証明書が設定されているときに HTTPS リダイレクトを強制します。	いいえ	`false`
`keyVaultURI`	文字列	証明書を格納する Key Vault シークレットの URI。	いいえ
`secret`	オブジェクト	既定の SSL 証明書のシークレット情報を保持します。入れ子になったプロパティが含まれています。	いいえ
`name`	文字列	シークレット名。	イエス
`namespace`	文字列	シークレット名前空間。	イエス
`httpDisabled`	ブーリアン	コントローラーへの HTTP トラフィックを無効にするフラグ。	いいえ
`ingressClassName`	文字列	コントローラーで使用される IngressClass 名。	イエス	`nginx.approuting.kubernetes.azure.com`
`loadBalancerAnnotations`	オブジェクト	NGINX イングレスコントローラーのサービスの動作を制御するために、ロードバランサーの注釈を設定するアノテーションのマップ。	いいえ
`scaling`	オブジェクト	コントローラーをスケーリングするための構成。入れ子になったプロパティが含まれています。	いいえ
`maxReplicas`	整数	レプリカ数の上限。	いいえ	`100`
`minReplicas`	整数	レプリカ数の下限。	いいえ	`2`
`threshold`	文字列	どの程度積極的にスケーリングするかを定義する、スケーリングのしきい値。 `rapid` では突然の急増に対して迅速にスケーリングし、`steady` ではコスト効率が優先され、`balanced` はその組み合わせです。	いいえ	`balanced`

既定の NGINX イングレスコントローラー構成を制御する

NGINX を使用してアプリケーションルーティングアドオンを有効にすると、一般向けの Azure ロードバランサーを使用して構成された default に、app-routing-namespace と呼ばれるイングレスコントローラーが作成されます。このイングレスコントローラーは、webapprouting.kubernetes.azure.com のイングレスクラス名を使用します。

既定値がパブリック IP または内部 IP どちらを取得するか、アドオンを有効にするときに作成するかどうかを制御することもできます。

使用可能な構成オプションは次のとおりです。

None: 既定の NGINX イングレスコントローラーは作成されず、既に存在する場合は削除されません。必要に応じて、既定の NginxIngressController カスタムリソースを手動で削除する必要があります。
Internal: 既定の NGINX イングレスコントローラーは、内部ロードバランサーを使用して作成されます。 NginxIngressControllerカスタムリソースを外部にするための注釈の変更は上書きされます。
External: 外部ロードバランサーで作成された既定の NGINX イングレスコントローラー。 NginxIngressControllerカスタムリソースを内部にするための注釈の変更はすべて上書きされます。
AnnotationControlled (既定値): 既定の NGINX イングレスコントローラーは、外部ロードバランサーを使用して作成されます。既定の NginxIngressController カスタムリソースを編集して、ロードバランサーの注釈を構成できます)。

az aks createフラグと--enable-app-routing フラグを指定して --app-routing-default-nginx-controller コマンドを使用して、新しいクラスターでアプリケーションルーティングを有効にします。 <DefaultIngressControllerType>を、「既定の NGINX イングレスコントローラー構成の制御」で説明されている構成オプションのいずれかに設定する必要があります。
```
az aks create \
  --resource-group $RESOURCE_GROUP \
  --name $CLUSTER_NAME \
  --location $LOCATION \
  --enable-app-routing \
  --app-routing-default-nginx-controller <DefaultIngressControllerType>
```

webAppRouting プロファイルには、既定の構成を制御するために変更できるnginx プロパティを持つオプションのdefaultIngressControllerType構成があります。

defaultIngressControllerType プロパティを、「既定の NGINX イングレスコントローラー構成の制御」で説明されている構成オプションのいずれかに設定します。
```
"ingressProfile": {
  "webAppRouting": {
    "nginx": {
        "defaultIngressControllerType": "None|Internal|External|AnnotationControlled"
    }
}
```

既存のクラスターで既定のイングレスコントローラーの構成を更新する

Azure CLI
Bicep

az aks approuting update フラグを指定して --nginx コマンドを使用して、既存のクラスターでアプリケーションルーティングの既定のイングレスコントローラー構成を更新します。 <DefaultIngressControllerType>を、「既定の NGINX イングレスコントローラー構成の制御」で説明されている構成オプションのいずれかに設定する必要があります。
```
az aks approuting update \
  --resource-group $RESOURCE_GROUP \
  --name $CLUSTER_NAME \
  --nginx <DefaultIngressControllerType>
```

defaultIngressControllerType プロパティを、「既定の NGINX イングレスコントローラー構成の制御」で説明されている構成オプションのいずれかに設定します。
```
"ingressProfile": {
  "webAppRouting": {
    "nginx": {
        "defaultIngressControllerType": "None|Internal|External|AnnotationControlled"
    }
}
```

別の一般向けの NGINX イングレスコントローラーを作成する

次の YAML マニフェストを nginx-public-controller.yaml という名前の新しいファイルにコピーし、ローカルコンピューターに保存します。

apiVersion: approuting.kubernetes.azure.com/v1alpha1
kind: NginxIngressController
metadata:
  name: nginx-public
spec:
  ingressClassName: nginx-public
  controllerNamePrefix: nginx-public

kubectl apply コマンドを使用して NGINX イングレスコントローラーリソースを作成します。
```
kubectl apply -f nginx-public-controller.yaml
```
次の出力例では、作成されたリソースが示されています。
```
nginxingresscontroller.approuting.kubernetes.azure.com/nginx-public created
```

プライベート IP アドレスを持つ内部 NGINX イングレスコントローラーを作成する

次の YAML マニフェストを nginx-internal-controller.yaml という名前の新しいファイルにコピーし、ローカルコンピューターに保存します。

apiVersion: approuting.kubernetes.azure.com/v1alpha1
kind: NginxIngressController
metadata:
  name: nginx-internal
spec:
  ingressClassName: nginx-internal
  controllerNamePrefix: nginx-internal
  loadBalancerAnnotations: 
    service.beta.kubernetes.io/azure-load-balancer-internal: "true"

kubectl apply コマンドを使用して NGINX イングレスコントローラーリソースを作成します。
```
kubectl apply -f nginx-internal-controller.yaml
```
次の出力例では、作成されたリソースが示されています。
```
nginxingresscontroller.approuting.kubernetes.azure.com/nginx-internal created
```

静的 IP アドレスを使用して NGINX イングレスコントローラーを作成する

az group create コマンドを使用して、Azure リソースグループを作成します。
```
az group create --name $NETWORK_RESOURCE_GROUP --location $LOCATION
```
az network public ip create コマンドを使用して静的パブリック IP アドレスを作成します。
```
az network public-ip create \
  --resource-group $NETWORK_RESOURCE_GROUP \
  --name $PUBLIC_IP_NAME \
  --sku Standard \
  --allocation-method static
```
Note

AKS クラスターで Basic SKU ロードバランサーを使用している場合は、パブリック IP を定義するときに、Basic パラメーターに--skuを使用します。 Basic SKU IP のみが Basic SKU ロードバランサーで動作し、Standard SKU ロードバランサーで動作する SKU IP はのみです。

az role assignment create コマンドを使用して、AKS クラスターで使用されるクラスター ID に、パブリック IP のリソースグループへの委任されたアクセス許可が含まれていることを確認してください。

CLIENT_ID=$(az aks show --name $CLUSTER_NAME --resource-group $RESOURCE_GROUP --query identity.principalId -o tsv)
RG_SCOPE=$(az group show --name $NETWORK_RESOURCE_GROUP --query id -o tsv)
az role assignment create \
  --assignee ${CLIENT_ID} \
  --role "Network Contributor" \
  --scope ${RG_SCOPE}

次の YAML マニフェストを nginx-staticip-controller.yaml という名前の新しいファイルにコピーし、ローカルコンピューターに保存します。

Note

YAML 例のように、パブリック IP 名に service.beta.kubernetes.io/azure-pip-name を使用するか、IPv4 アドレスには service.beta.kubernetes.io/azure-load-balancer-ipv4、IPv6 アドレスには service.beta.kubernetes.io/azure-load-balancer-ipv6 を使用できます。 service.beta.kubernetes.io/azure-pip-name注釈を追加すると、最も効率的なロードバランサーの作成を可能にし、潜在的なスロットリングを回避するために強く推奨されます。
```
apiVersion: approuting.kubernetes.azure.com/v1alpha1
kind: NginxIngressController
metadata:
  name: nginx-static
spec:
  ingressClassName: nginx-static
  controllerNamePrefix: nginx-static
  loadBalancerAnnotations: 
    service.beta.kubernetes.io/azure-pip-name: "$PUBLIC_IP_NAME"
    service.beta.kubernetes.io/azure-load-balancer-resource-group: "$NETWORK_RESOURCE_GROUP"
```
kubectl apply コマンドを使用して NGINX イングレスコントローラーリソースを作成します。
```
kubectl apply -f nginx-staticip-controller.yaml
```
次の出力例では、作成されたリソースが示されています。
```
nginxingresscontroller.approuting.kubernetes.azure.com/nginx-static created
```

イングレスコントローラーが作成されたことを確認する

kubectl get nginxingresscontroller コマンドを使用して、NGINX イングレスコントローラーの状態を確認します。
```
kubectl get nginxingresscontroller --name $INGRESS_CONTROLLER_NAME
```
次の出力例では、作成されたリソースが示されています。コントローラーが使用可能になるまでに数分かかる場合があります。
```
NAME           INGRESSCLASS   CONTROLLERNAMEPREFIX   AVAILABLE
nginx-public   nginx-public   nginx                  True
```

イングレスコントローラーの条件を表示する

kubectl get nginxingresscontroller コマンドを使用して、イングレスコントローラーの条件を表示して問題のトラブルシューティングを行います。

kubectl get nginxingresscontroller --name $INGRESS_CONTROLLER_NAME -o jsonpath='{range .items[*].status.conditions[*]}{.lastTransitionTime}{"\t"}{.status}{"\t"}{.type}{"\t"}{.message}{"\n"}{end}'

次の出力例では、正常なイングレスコントローラーの状態が示されています。

2023-11-29T19:59:24Z    True    IngressClassReady       Ingress Class is up-to-date
2023-11-29T19:59:50Z    True    Available               Controller Deployment has minimum availability and IngressClass is up-to-date
2023-11-29T19:59:50Z    True    ControllerAvailable     Controller Deployment is available
2023-11-29T19:59:25Z    True    Progressing             Controller Deployment has successfully progressed

イングレスでイングレスコントローラーを使用する

次の YAML マニフェストを ingress.yaml という名前の新しいファイルにコピーし、ローカルコンピューターに保存します。

Note

<HostName> を DNS ホスト名で更新します。 <IngressClassName> は、NginxIngressController の作成時に定義したものです。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  namespace: hello-web-app-routing
spec:
  ingressClassName: <IngressClassName>
  rules:
  - host: <HostName>
    http:
      paths:
      - backend:
          service:
            name: aks-helloworld
            port:
              number: 80
        path: /
        pathType: Prefix

kubectl apply コマンドを使ってクラスターリソースを作成します。
```
kubectl apply -f ingress.yaml --namespace hello-web-app-routing
```
次の出力例では、作成されたリソースが示されています。
```
ingress.networking.k8s.io/aks-helloworld created
```

マネージドイングレスが作成されたことを確認する

kubectl get ingress コマンドを使用して、マネージドイングレスが作成されたことを確認します。

kubectl get ingress --namespace hello-web-app-routing

出力は、次の出力例のようになります。

NAME             CLASS                                HOSTS               ADDRESS       PORTS     AGE
aks-helloworld   webapprouting.kubernetes.azure.com   myapp.contoso.com   20.51.92.19   80, 443   4m

イングレスコントローラーを削除する

kubectl delete nginxingresscontroller コマンドを使用して NGINX イングレスコントローラーを削除します。
```
kubectl delete nginxingresscontroller --name $INGRESS_CONTROLLER_NAME
```

注釈を使用したイングレスリソースごとの構成

NGINX イングレスコントローラーでは、特定のイングレスオブジェクトに注釈を追加して動作をカスタマイズできます。

フィールドにそれぞれの注釈を追加すると、イングレスオブジェクトにmetadata.annotationsできます。

Note

注釈キーおよび値には文字列のみを使用できます。ブール値や数値など、他の型は引用符で囲む必要があります。たとえば、"true"、"false"、"100" などです。

次のセクションでは、一般的な構成の例を示します。完全な一覧については、 NGINX イングレス注釈のドキュメントを参照してください。

カスタムの最大本文サイズ

NGINX の場合、要求のサイズがクライアントの要求本文の最大許容サイズを超えると、クライアントに 413 エラーが返されます。既定値をオーバーライドするには、注釈を使用します。

nginx.ingress.kubernetes.io/proxy-body-size: 4m

この注釈を使用したイングレス構成の例を次に示します。

Note

<HostName> を DNS ホスト名で更新します。 <IngressClassName> は、NginxIngressController の作成時に定義したものです。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  namespace: hello-web-app-routing
  annotations:
    nginx.ingress.kubernetes.io/proxy-body-size: 4m
spec:
  ingressClassName: <IngressClassName>
  rules:
  - host: <HostName>
    http:
      paths:
      - backend:
          service:
            name: aks-helloworld
            port:
              number: 80
        path: /
        pathType: Prefix

カスタム接続タイムアウト

NGINX イングレスコントローラーがワークロードとの接続を閉じるのを待機するタイムアウトを変更できます。すべてのタイムアウト値は、単位なし (秒単位) です。既定のタイムアウトをオーバーライドするには、次の注釈を使用して、有効な 120 秒のプロキシ読み取りタイムアウトを設定します。

nginx.ingress.kubernetes.io/proxy-read-timeout: "120"

他の構成オプションのカスタムタイムアウトを確認します。

この注釈を使用したイングレス構成の例を次に示します。

Note

<HostName> を DNS ホスト名で更新します。 <IngressClassName> は、NginxIngressController の作成時に定義したものです。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  namespace: hello-web-app-routing
  annotations:
    nginx.ingress.kubernetes.io/proxy-read-timeout: "120"
spec:
  ingressClassName: <IngressClassName>
  rules:
  - host: <HostName>
    http:
      paths:
      - backend:
          service:
            name: aks-helloworld
            port:
              number: 80
        path: /
        pathType: Prefix

バックエンドプロトコル

NGINX イングレスコントローラーは、既定で HTTP を使用してサービスに到達します。 HTTPSやGRPCなどの代替バックエンドプロトコルを構成するには、次のいずれかの注釈を使用します。

# HTTPS annotation
nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"

# GRPC annotation
nginx.ingress.kubernetes.io/backend-protocol: "GRPC"

その他の構成オプションについては、「バックエンドプロトコル」を確認してください。

この注釈を使用したイングレス構成の例を次に示します。

Note

<HostName> を DNS ホスト名で更新します。 <IngressClassName> は、NginxIngressController の作成時に定義したものです。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  namespace: hello-web-app-routing
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
spec:
  ingressClassName: <IngressClassName>
  rules:
  - host: <HostName>
    http:
      paths:
      - backend:
          service:
            name: aks-helloworld
            port:
              number: 80
        path: /
        pathType: Prefix

イングレスルールでクロスオリジンリソース共有 (CORS) を有効にするには、次の注釈を使用します。

nginx.ingress.kubernetes.io/enable-cors: "true"

その他の構成オプションについては、「CORS を有効にする」を確認してください。

この注釈を使用したイングレス構成の例を次に示します。

Note

<HostName> を DNS ホスト名で更新します。 <IngressClassName> は、NginxIngressController の作成時に定義したものです。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  namespace: hello-web-app-routing
  annotations:
    nginx.ingress.kubernetes.io/enable-cors: "true"
spec:
  ingressClassName: <IngressClassName>
  rules:
  - host: <HostName>
    http:
      paths:
      - backend:
          service:
            name: aks-helloworld
            port:
              number: 80
        path: /
        pathType: Prefix

SSL リダイレクトを無効にする

既定で TLS がイングレスに対して有効になっている場合、コントローラーは (308) を HTTPS にリダイレクトします。特定のイングレスリソースに対してこの機能を無効にするには、次の注釈を使用します。

nginx.ingress.kubernetes.io/ssl-redirect: "false"

その他の構成オプションについては、「リダイレクトを使用したサーバー側の HTTPS の適用」を確認してください。

この注釈を使用したイングレス構成の例を次に示します。

Note

<HostName> を DNS ホスト名で更新します。 <IngressClassName> は、NginxIngressController の作成時に定義したものです。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  namespace: hello-web-app-routing
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "false"
spec:
  ingressClassName: <IngressClassName>
  rules:
  - host: <HostName>
    http:
      paths:
      - backend:
          service:
            name: aks-helloworld
            port:
              number: 80
        path: /
        pathType: Prefix

URL の書き換え

一部のシナリオでは、バックエンドサービスで公開される URL が、イングレスルールの指定されたパスと異なります。再書き込みがない場合、要求は 404 を返します。この構成は、同じドメインの下で 2 つの異なる Web アプリケーションを提供できるパスベースのルーティングで役立ちます。次の注釈を使用して、サービスで予期されるパスを設定できます。

nginx.ingress.kubernetes.io/rewrite-target: /$2

この注釈を使用したイングレス構成の例を次に示します。

Note

<HostName> を DNS ホスト名で更新します。 <IngressClassName> は、NginxIngressController の作成時に定義したものです。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  namespace: hello-web-app-routing
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$2
    nginx.ingress.kubernetes.io/use-regex: "true"
spec:
  ingressClassName: <IngressClassName>
  rules:
  - host: <HostName>
    http:
      paths:
      - path: /app-one(/|$)(.*)
        pathType: Prefix 
        backend:
          service:
            name: app-one
            port:
              number: 80
      - path: /app-two(/|$)(.*)
        pathType: Prefix 
        backend:
          service:
            name: app-two
            port:
              number: 80

NGINX 正常性チェックパスのアップデート

NGINX イングレスコントローラーに関連付けられている Azure Load Balancer の既定の正常性プローブパスは、 "/healthz"に設定する必要があります。正しい正常性チェックを行うために、イングレスコントローラーサービスに次の注釈があることを確認します。

metadata:
  annotations:
    service.beta.kubernetes.io/azure-load-balancer-health-probe-request-path: "/healthz"

Helm を使用して NGINX イングレスコントローラーを管理している場合は、Azure Load Balancer の正常性プローブ注釈を値ファイルに定義し、アップグレード中に適用できます。

controller:
  service:
    annotations:
      service.beta.kubernetes.io/azure-load-balancer-health-probe-request-path: "/healthz"

この構成は、サービスの可用性を維持し、アップグレード中の予期しないトラフィックの中断を回避するのに役立ちます。

次のステップ

アプリケーションのパフォーマンスと使用状況の分析の一環として、Grafana で Prometheus を使用して、アプリケーションルーティングアドオンに含まれる ingress-nginx コントローラーメトリックを監視する方法についてご確認ください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-31

次の方法で共有

Azure Kubernetes Service (AKS) 用のアプリケーション ルーティング アドオンを使用した高度な NGINX イングレス コントローラーとイングレス構成

前提条件

ご利用の AKS クラスターに接続する

NGINX イングレス コントローラーの構成プロパティ

既定の NGINX イングレス コントローラー構成を制御する

新しいクラスターで既定のイングレス コントローラー構成を制御する

既存のクラスターで既定のイングレス コントローラーの構成を更新する

別の一般向けの NGINX イングレス コントローラーを作成する

プライベート IP アドレスを持つ内部 NGINX イングレス コントローラーを作成する

静的 IP アドレスを使用して NGINX イングレス コントローラーを作成する

イングレス コントローラーが作成されたことを確認する

イングレス コントローラーの条件を表示する

イングレスでイングレス コントローラーを使用する

マネージド イングレスが作成されたことを確認する

イングレス コントローラーを削除する

注釈を使用したイングレス リソースごとの構成

カスタムの最大本文サイズ

カスタム接続タイムアウト

バックエンド プロトコル

クロスオリジン リソース共有 (CORS)

SSL リダイレクトを無効にする

URL の書き換え

NGINX 正常性チェック パスのアップデート

次のステップ

フィードバック

その他のリソース

Azure Kubernetes Service (AKS) 用のアプリケーションルーティングアドオンを使用した高度な NGINX イングレスコントローラーとイングレス構成

NGINX イングレスコントローラーの構成プロパティ

既定の NGINX イングレスコントローラー構成を制御する

新しいクラスターで既定のイングレスコントローラー構成を制御する

既存のクラスターで既定のイングレスコントローラーの構成を更新する

別の一般向けの NGINX イングレスコントローラーを作成する

プライベート IP アドレスを持つ内部 NGINX イングレスコントローラーを作成する

静的 IP アドレスを使用して NGINX イングレスコントローラーを作成する

イングレスコントローラーが作成されたことを確認する

イングレスコントローラーの条件を表示する

イングレスでイングレスコントローラーを使用する

マネージドイングレスが作成されたことを確認する

イングレスコントローラーを削除する

注釈を使用したイングレスリソースごとの構成

バックエンドプロトコル

クロスオリジンリソース共有 (CORS)

NGINX 正常性チェックパスのアップデート