MongoDB向け単一階層NetScaler® Ingressソリューション

前提条件

• クラウドまたはオンプレミスでKubernetesクラスターをセットアップする
• 展開モードをsharded replica setとして、KubernetesクラスターにMongoDBを展開します。MongoDBの他の展開モードはサポートされていません。
• Elasticsearchがインストールされ、構成されていることを確認してください。Elasticsearchを展開するには、elasticsearch.yamlファイルを使用します。
• トランザクションデータを視覚化するためにKibanaがインストールされていることを確認してください。Kibanaをデプロイするには、kibana.yamlファイルを使用します。
• Kubernetesクラスターの外部にNetScaler VPXインスタンスをデプロイします。NetScaler VPXのデプロイ方法については、NetScaler VPXインスタンスのデプロイを参照してください。

1. KubernetesクラスターのサブネットからIPアドレスをNetScalerのSNIPとして構成します。NetScalerでのSNIPの構成については、サブネットIPアドレス（SNIP）の構成を参照してください。
2. Kubernetesクラスターと同じサブネットであるSNIPの管理アクセスを有効にします。NetScaler Ingress ControllerがTier-1 NetScalerを構成できるように、SNIPはNetScaler Ingress Controller YAMLファイルでNS_IP変数として使用する必要があります。
   注:
   SNIPをNS_IPとして使用することは必須ではありません。NetScalerの管理IPアドレスがNetScaler Ingress Controllerから到達可能な場合、管理IPアドレスをNS_IPとして使用できます。

3. NetScaler Ingress Controller専用のNetScalerシステムユーザーアカウントを作成します。NetScaler Ingress Controllerは、システムユーザーアカウントを使用してTier-1 NetScalerを自動的に構成します。
4. NetScaler VPXを構成して、DNSクエリをKubernetesクラスター内のCoreDNSポッドIPアドレスに転送します。
   add dns nameServer <core-dns-pod-ip-address>
   たとえば、ポッドIPアドレスが192.244.0.2と192.244.0.3の場合、NetScaler VPXでネームサーバーを次のように構成します。
   add dns nameServer 192.244.0.3
add dns nameServer 192.244.0.2

MongoDB向けNetScaler Ingressソリューションのデプロイ

• NetScaler VPX用のスタンドアロンNetScaler Ingress Controller
• NetScaler VPX用のIngressリソース
• NetScaler 可観測性エクスポーター

1. NetScaler VPX のユーザー名とパスワードで Kubernetes シークレットを作成します。
   kubectl create secret  generic nslogin --from-literal=username='username' --from-literal=password='mypassword'
2. cic-configmap.yaml ファイルをダウンロードし、次のコマンドを使用して展開します。
   kubectl create -f cic-configmap.yaml
3. 次の手順を使用して、NetScaler Ingress Controller をポッドとして展開します。
   1. NetScaler Ingress Controller マニフェストファイルをダウンロードします。次のコマンドを使用します。
      wget https://raw.githubusercontent.com/citrix/citrix-k8s-ingress-controller/master/deployment/dual-tier/manifest/tier-1-vpx-cic.yaml
   2. NetScaler Ingress Controller マニフェストファイルを編集し、次の環境変数の値を入力します。

      環境変数	必須またはオプション	説明
      NS_IP	必須	NetScaler アプライアンスの IP アドレス。詳細については、前提条件 を参照してください。
      NS_USER と NS_PASSWORD	必須	Ingress デバイスとして使用される NetScaler VPX または MPX アプライアンスのユーザー名とパスワード。
      EULA	必須	エンドユーザーライセンス契約。値をYesとして指定します。
      LOGLEVEL	オプション	NetScaler Ingress Controllerによって生成されるログを制御するためのログレベル。デフォルトでは、値はDEBUGに設定されています。サポートされている値は、CRITICAL、ERROR、WARNING、INFO、DEBUGです。
      NS_PROTOCOL および NS_PORT	オプション	NetScaler Ingress ControllerがNetScalerと通信するために使用する必要があるプロトコルとポートを定義します。デフォルトでは、NetScaler Ingress Controllerはポート443でHTTPSを使用します。ポート80でHTTPを使用することもできます。
      イングレスクラス	オプション	複数のIngressロードバランサーが異なるIngressリソースの負荷分散に使用される場合。この環境変数を使用して、特定のIngressクラスに関連付けられたNetScalerを構成するようにNetScaler Ingress Controllerを指定できます。Ingressクラスの詳細については、Ingressクラスのサポートを参照してください。
      NS_VIP	オプション	NetScaler Ingress Controllerは、この環境変数で提供されるIPアドレスを使用して、Ingressトラフィックを受信するNetScalerに仮想IPアドレスを構成します。

   3. NetScaler Ingress Controller YAMLファイルで、以下の引数を指定または変更します。
      args:
 - --configmap
    default/cic-configmap
 - --ingress-classes
    tier-1-vpx
   4. 以下のコマンドを使用して、更新されたNetScaler Ingress Controllerマニフェストファイルをデプロイします。
      kubectl create -f tier-1-vpx-cic.yaml
4. tier-1-vpx-ingress.yamlファイルを使用して、Tier-1 NetScalerのIngressオブジェクトを作成します。
   kubectl apply -f tier-1-vpx-ingress.yaml
   tier-1-vpx-ingress.yamlファイルの内容は次のとおりです。このIngressリソースで指定されたルールに従い、NetScaler Ingress ControllerはNetScaler VPXを構成して、ポート27017でMongoDBトラフィックをリッスンします。この例に示すように、NetScaler VPXがトラフィックをルーティングできるように、MongoDbクエリールーター用に作成したサービス（例:serviceName: mongodb-mongos）を指定する必要があります。ここで、mongodb-mongosはMongoDBクエリールーターのサービスです。
   apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    ingress.citrix.com/analyticsprofile: '{"tcpinsight": {"tcpBurstReporting":"DISABLED"}}'
    ingress.citrix.com/insecure-port: "27017"
    ingress.citrix.com/insecure-service-type: mongo
    ingress.citrix.com/insecure-termination: allow
  name: vpx-ingress
spec:
  ingressClassName: tier-1-vpx
  defaultBackend:
      service:
        name: mongodb-mongos
        port:
          number: 27017
5. coe-es-mongo.yamlファイルを使用して、ElasticsearchをエンドポイントとしてNetScaler Observability Exporterをデプロイします。
   kubectl apply -f coe-es-mongo.yaml
   注:
   ELKServer環境変数に、IPアドレスまたはDNS名に基づいて、ポート情報とともにElasticsearchサーバーの詳細を設定する必要があります。

NetScaler Ingressソリューションのデプロイを検証する

MongoDBトラフィックの可観測性を検証する

• KubernetesクラスターにシャードレプリカセットとしてMongoDBをデプロイ済みであること。
• MongoDB用のNetScaler Ingressソリューションがデプロイされていること。
• MongoDBにトラフィックを送信するためのMongoDBクライアントアプリケーションがインストールされていること。
• 可視化のためにKibanaがインストールされていること。

1. MongoDB用のクライアントアプリケーションを、Tier-1 NetScaler VPXの仮想IPアドレスを指すように構成します。
   例:
   mongodb://<vip-of-vpx>:27017/
2. MongoDBクライアントアプリケーションを使用して、複数のリクエスト（挿入、更新、削除など）をMongoDBデータベースに送信します。トランザクションはElasticsearchサーバーにアップロードされます。
3. MongoDBトランザクションを可視化するためにKibanaダッシュボードを設定します。以下のサンプルKibanaダッシュボードを使用できます。

テレメトリデータをPrometheusにエクスポートする