NetScaler Ingress Controller の ConfigMap サポート

NetScaler Ingress Controller でサポートされている環境変数

• LOGLEVEL: NetScaler Ingress Controller によって生成されるログを制御するためのログレベル (debug、info、critical など) を指定します。デフォルト値は debug です。
• NS_HTTP2_SERVER_SIDE: NetScaler サービスグループ構成で HTTP2 を有効にします。指定可能な値は ON または OFF です。
• NS_PROTOCOL: ADC セッションを確立するためのプロトコル (HTTP/HTTPS) を指定します。デフォルト値は http です。
• NS_PORT: セッションを確立するためのポートを指定します。デフォルト値は 80 です。
• NS_COOKIE_VERSION: 永続性クッキーのバージョン (0 または 1) を指定します。デフォルト値は 0 です。
• NS_DNS_NAMESERVER: NetScaler VPX に DNS ネームサーバーを追加できるようにします。
• POD_IPS_FOR_SERVICEGROUP_MEMBERS: 外部のティア 1 NetScaler で LoadBalancer または NodePort タイプのサービスを構成する際に、NodeIP および NodePort の代わりにポッドの IP アドレスとポートをサービスグループメンバーとして追加するように指定します。
• IGNORE_NODE_EXTERNAL_IP: 外部のティア 1 NetScaler で LoadBalancer または NodePort タイプのサービスの NodeIP を構成する際に、外部 IP アドレスを無視し、NodeIP に内部 IP アドレスを追加するように指定します。
• FRONTEND_HTTP_PROFILE: イングレス定義の ingress.citrix.com/frontend-httpprofile スマートアノテーションによって上書きされない限り、フロントエンド仮想サーバー (クライアントプレーン) の HTTP オプションを設定します。
• FRONTEND_TCP_PROFILE: フロントエンド仮想サーバー（クライアント側）のTCPオプションを設定します。ただし、イングレス定義のingress.citrix.com/frontend-tcpprofileスマートアノテーションによって上書きされない限りです。
• FRONTEND_SSL_PROFILE: フロントエンド仮想サーバー（クライアント側）のSSLオプションを設定します。ただし、イングレス定義のingress.citrix.com/frontend-sslprofileスマートアノテーションによって上書きされない限りです。
• JSONLOG: ログメッセージがJSON形式で必要な場合は、この引数をtrueに設定します。
• NS_ADNS_IPS: NetScalerをADNSサーバーとして構成できるようにします。

NetScaler Ingress ControllerのConfigMapサポートの構成

1. ConfigMapに必要なキーと値のペアを含むYAMLファイルcic-configmap.yamlを作成します。
   apiVersion: v1
kind: ConfigMap
metadata:
  name: cic-configmap
  labels:
    app: citrix-ingress-controller
data:
  LOGLEVEL: 'info'
  NS_PROTOCOL: 'http'
  NS_PORT: '80'
  NS_COOKIE_VERSION: '0'
  NS_HTTP2_SERVER_SIDE: 'ON'
2. 次のコマンドを使用してcic-configmap.yamlをデプロイします。
   kubectl create -f cic-configmap.yaml
3. NetScaler Ingress Controllerをスタンドアロンポッドとしてデプロイするためにcic.yamlファイルを編集し、以下を指定します。
   Args:
    - --configmap
        default/cic-configmap
   注:
   名前空間の指定は必須です。名前空間が指定されていない場合、ConfigMapは考慮されません。
   ConfigMap構成でNetScaler Ingress ControllerをデプロイするためのYAMLファイルのサンプルを以下に示します。完全なYAMLファイルについては、citrix-k8s-ingress-controller.yamlを参照してください。
   apiVersion: apps/v1
kind: Deployment
metadata:
  name: cic-k8s-ingress-controller
spec:
  selector:
    matchLabels:
      app: cic-k8s-ingress-controller
    replicas: 1
    template:
      metadata:
        name: cic-k8s-ingress-controller
        labels:
          app: cic-k8s-ingress-controller
      annotations:
      spec:
        serviceAccountName: cic-k8s-role
        containers:
        - name: cic-k8s-ingress-controller
          image: "quay.io/citrix/citrix-k8s-ingress-controller:1.36.5"
          env:
          # Set NetScaler NSIP/SNIP, SNIP in case of HA (mgmt has to be enabled)
          - name: "NS_IP"
            value: "x.x.x.x"
          - name: "EULA"
            value: "yes"
          args:
            - --ingress-classes
              citrix
            - --feature-node-watch
              false
            - --configmap
              default/cic-configmap
          imagePullPolicy: Always
4. YAMLを適用して、NetScaler Ingress Controllerをスタンドアロンポッドとしてデプロイします。
   kubectl apply -f cic.yaml
5. 環境変数の値を変更したい場合は、ConfigMapの値を編集します。この例では、NS_HTTP2_SERVER_SIDEの値が「OFF」に変更されています。
   apiVersion: v1
kind: ConfigMap
metadata:
  name: cic-configmap
  labels:
    app: citrix-ingress-controller
data:
  LOGLEVEL: 'info'
  NS_PROTOCOL: 'http'
  NS_PORT: '80'
  NS_COOKIE_VERSION: '0'
  NS_HTTP2_SERVER_SIDE: 'OFF'
6. 次のコマンドを使用してConfigMapを再適用します。
   kubectl apply -f cic-configmap.yaml
7. (オプション) ConfigMapを削除する必要がある場合は、次のコマンドを使用します。
   kubectl delete -f cic-configmap.yaml
   ConfigMapを削除すると、環境変数構成は次の優先順位に従ってフォールバックします。 ConfigMap構成 > 環境変数構成 > デフォルト