NetScaler IPAMコントローラーをデプロイする

最終公開日 : Oct 02, 2026
NetScalerは、IPアドレス管理用のIPAMコントローラーを提供します。NetScaler IPAMコントローラーは、Kubernetesクラスター内でNetScaler Ingress Controllerと並行して動作します。NetScaler IPAMコントローラーは、指定されたIPアドレス範囲から、LoadBalancerタイプのサービスおよびイングレスリソースにIPアドレスを割り当てます。
NetScaler IPAMコントローラーには、NetScalerのVIPカスタムリソース定義 (CRD) が必要です。VIP CRDは、NetScaler Ingress ControllerとNetScaler IPAMコントローラー間の内部通信に使用されます。
Related information
デプロイメントソリューション

前提条件

  • Kubernetesクラスターと、クラスターと通信するためのkubectlコマンドラインツール。
  • リソースを分離するために、netscalerという名前空間を作成します。名前空間を作成するには、次のコマンドを実行します。
    kubectl create namespace netscaler
  • 次のHelmコマンドを使用して、NetScaler VPXまたはNetScaler MPX用にNetScaler Ingress Controllerをインストールします。
注:
次のコマンドを実行する前に、NetScaler VPXまたはNetScaler MPXの資格情報を使用してシークレットを作成してください。
helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/

helm install NetScaler-ingress-controller netscaler/NetScaler-ingress-controller --set nsIP=<NSIP of MPX/VPX>,license.accept=yes,adcCredentialSecret=<Secret-for-ADC-credentials>,ingressClass[0]=netscaler,serviceClass[0]=netscaler,ipam=true,crds.install=true -n netscaler
Helmチャートを使用してNetScaler Ingress Controllerをデプロイおよび構成する方法の詳細については、Helmチャートリポジトリを参照してください。

IPAMコントローラーをデプロイする

  1. 次のコマンドを使用して、NetScaler Helmチャートリポジトリをローカルレジストリに追加します。
    helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/
  2. 次のコマンドを使用して、NetScaler IPAMコントローラーをインストールします。
    helm install netscaler-ipam-controller netscaler/netscaler-ipam-controller --set vipRange='[{"<VIP-range-key>": ["<ip-range>"]}]' -n netscaler
Helmチャートを使用してIPAMコントローラーをインストールする際のすべての構成可能なパラメーターに関する情報については、Helmチャートリポジトリを参照してください。

IPアドレスの割り当て

  • LoadBalancerタイプのサービスの場合、VIP範囲から各サービスに一意のIPアドレスが割り当てられます。
  • イングレスリソースの場合、指定されたIP範囲内のIPアドレスが割り当てられます。複数のイングレスリソースが同じVIP範囲を参照する場合、最初のイングレスリソースに割り当てられたIPアドレスが他のすべてのイングレスリソースに割り当てられます。
  • LoadBalancerタイプのサービスとイングレスリソースの両方が、同時にNetScaler IPAMコントローラーをIPアドレスの割り当てに使用できます。いずれかのリソースタイプにIPアドレスが割り当てられている場合、他のリソースタイプでは利用できません。ただし、同じIPアドレスを複数のイングレスリソースに割り当てることができます。

IPAMコントローラーにおける環境変数

このセクションでは、NetScaler IPAMコントローラーの環境変数に関する情報を提供します。

VIP_RANGE

VIP_RANGE 環境変数を使用すると、IPアドレス範囲を定義できます。IPアドレス範囲を定義するか、一意の名前に関連付けられたIPアドレス範囲を定義することができます。
IPアドレス範囲
サブネットまたは複数のサブネットからIPアドレス範囲を定義できます。また、- 文字を使用してIPアドレス範囲を定義することもできます。IPAMコントローラーは、このIPアドレス範囲からサービスにIPアドレスを割り当てます。
一意の名前に関連付けられたIPアドレス範囲
IPアドレス範囲に一意の名前を割り当て、VIP_RANGE 環境変数でその範囲を定義できます。このIPアドレス範囲の割り当て方法により、IPアドレス範囲を区別できます。LoadBalancer タイプのサービスを作成する際、サービス定義で service.citrix.com/ipam-range アノテーションを使用して、IPアドレス割り当てに使用するIPアドレス範囲を指定できます。

reuseIngressVip

reuseIngressVip 変数を使用すると、IPAMコントローラーを設定して、同じVIP範囲を参照する各イングレスリソースに同じIPアドレスまたは異なるIPアドレスのいずれかを割り当てることができます。
reuseIngressVip の値 説明
true (デフォルト) 各イングレスリソースに同じIPアドレスを割り当てる
偽 各イングレスリソースに異なるIPアドレスを割り当てる

参照

  • IPAMコントローラーによって割り当てられたIPアドレスを持つLoadBalancerタイプのサービスを公開する方法については、このセクションを参照してください。