デュアルティアまたはサービスメッシュライトトポロジをセットアップするための詳細な手順

ソフトウェア要件

始める前に

• NetScaler ADMとKubernetesクラスターが同じネットワーク上にある場合（例：Citrix Hypervisor™でホストされているNetScaler ADMとKubernetesクラスター）。
• NetScaler ADMとKubernetesクラスターが異なるネットワーク上にある場合。このシナリオでは、(/ja-jp/netscaler-application-delivery-management-software/13-1/deploy/multisite-deployment.html)を構成し、Kubernetesクラスターがホストされているネットワークにエージェントを登録する必要があります。

• NetScaler CPXをプロキシとするKubernetesクラスター。詳細については、NetScaler Ingress Controllerを参照してください。
• NetScaler ADMとNetScaler CPX間の通信を有効にするために、NetScaler ADMで(#configure-static-routes-in-citrix-adm)を構成済みであること
• (#download-the-sample-deployment-files-from-github)からサンプル展開ファイルをダウンロード済みであること。
• NetScaler ADMへのCPXの登録を成功させるために、(#add-parameters-in-cpx-yaml-file)に必要なパラメーターを追加済みであること。
• NetScaler ADMに(#add-kubernetes-cluster-in-citrix-adm)を追加済みであること。
• (#deploy-a-sample-microservice-application)を展開済みであること。
• (#deploy-cpx-and-register-cpx-in-adm)を展開し、CPXをADMに登録済みであること。
• 仮想サーバーをライセンスするために、仮想サーバーの自動選択を有効にしていること。
• NetScalerエージェントがHTTPトランザクションを取得できるように、Webトランザクション設定をすべてに変更していること。
• NetScalerエージェントがTCPメトリックを取得できるように、Istream.confファイルを更新し、TCP設定をAllに変更しました。

ソフトウェア要件

始める前に

• NetScaler ADMとKubernetesクラスターが同じネットワーク上にある場合（例：Citrix HypervisorでホストされているNetScaler ADMとKubernetesクラスター）。
• NetScaler ADMとKubernetesクラスターが異なるネットワーク上にある場合。このシナリオでは、オンプレミスエージェントを設定し、Kubernetesクラスターがホストされているネットワークにエージェントを登録する必要があります。

• NetScaler CPXをプロキシとして使用するKubernetesクラスター。詳細については、NetScaler Ingress Controllerを参照してください。
• NetScaler ADMとNetScaler CPX間の通信を有効にするために、NetScaler ADMで静的ルートを設定済みであること
• GitHubリポジトリからサンプル展開ファイルをダウンロード済みであること。
• NetScaler ADMへのCPX登録を成功させるために、CPX YAMLファイルに必要なパラメータを追加済みであること。
• NetScaler ADMにKubernetesクラスターを追加済みであること。
• サンプルマイクロサービスアプリケーションを展開済みであること。
• NetScaler CPXを展開し、CPXをADMに登録済みであること。
• 仮想サーバーをライセンスするために、仮想サーバーの自動選択を有効にしていること。
• NetScalerエージェントがHTTPトランザクションを取得できるように、Webトランザクション設定をすべてに変更していること。
• Istream.conf ファイルを更新し、NetScaler エージェントが TCP メトリックを取得できるように TCP 設定を All に変更しました。

NetScaler ADM で静的ルートを構成する

• Kubernetes マスター – 101.xx.xx.112
• Kubernetes ワーカー 1 – 101.xx.xx.111
• Kubernetes ワーカー 2 – 101.xx.xx.110

1. SSH クライアントを使用して NetScaler ADM にログオンします
2. コマンド route add -net <public IP address range> <Kubernetes IP address> を使用して静的ルーティングを構成します
   例えば：
   route add -net 192.168.0.0/24 101.xx.xx.112
   route add -net 192.168.1.0/24 101.xx.xx.111
   route add -net 192.168.2.0/24 101.xx.xx.110
3. netstat -rn を使用して構成を確認します
   
4. これらのルートコマンドを /mpsconfig/svm.conf ファイルに追記します。
   1. NetScaler ADM で、次のコマンドを使用して svm.conf ファイルにアクセスします。
      vim /mpsconfig/svm.conf
   2. svm.conf ファイルに静的ルートを追加します。
      例えば、route add -net 192.168.0.0/24 101.xx.xx.112。

GitHub からサンプル展開ファイルをダウンロードする

1. マスターノードで GitHub リポジトリをクローンするには、コマンド git clone https://github.com/citrix/citrix-k8s-ingress-controller.git を使用します。
2. YAML にアクセスするには：
   cd citrix-k8s-ingress-controller/example/servicegraph-demo/

CPX YAMLファイルにパラメータを追加する

• NS_MGMT_SERVER – NetScaler ADMのIPアドレスを示します
  注
  ADMエージェントが使用されている場合、これはオンプレミスエージェントのIPアドレスを示します。

• NS_MGMT_FINGER_PRINT – NetScaler ADMにおけるCPXの認証を示します。フィンガープリントを取得するには：
  1. NetScaler ADMで、Settings > Administrationに移動します。
  2. System Configurationsの下で、View ADM Fingerprintをクリックします。
     
     注：
     オンプレミスエージェントを設定している場合は、Infrastructure > Instances > Agentsに移動し、エージェントを選択して、View Fingerprintをクリックします。
     
• NS_HTTP_PORT – 通信用のHTTPポートを示します
• NS_HTTPS_PORT – 通信用のHTTPSポートを示します
• NS_MGMT_USER - ユーザー名を示します
• NS_MGMT_PASS - パスワードを示します。任意のパスワードを指定してください
• LOGSTREAM_COLLECTOR_IP – CPXからADMにログデータを転送するためにLogstreamプロトコルを有効にする必要があるNetScalerエージェントのIPアドレスを示します

NetScaler ADMにVPX、SDX、MPX、またはBLXインスタンスを追加する

1. Infrastructure > Instances > NetScalerに移動します
2. インスタンスを追加するには、追加オプションをクリックします。詳細については、NetScaler ADMでのインスタンスの追加を参照してください
3. インスタンスを追加した後、仮想サーバーを選択し、Web Insightを有効にします。詳細については、仮想サーバーでのライセンス管理と分析の有効化を参照してください

NetScaler ADMにKubernetesクラスターを追加する

1. 管理者資格情報を使用してNetScaler ADMにログオンします。
2. Orchestration > Kubernetes > Clusterに移動します。 クラスターページが表示されます。
3. 追加をクリックします。
4. クラスターの追加ページで、次のパラメーターを指定します。
   1. 名前 - 任意の名前を指定します。
   2. APIサーバーURL - KubernetesマスターノードからAPIサーバーURLの詳細を取得できます。
      1. Kubernetesマスターノードで、コマンドkubectl cluster-infoを実行します。
         
      2. **「Kubernetes master is running at.」**に表示されるURLを入力します。
   3. 認証トークン - 認証トークンを指定します。認証トークンは、KubernetesクラスターとNetScaler ADM間の通信のアクセスを検証するために必要です。認証トークンを生成するには、次の手順を実行します。
      Kubernetesマスターノードで、:
      1. 次のYAMLを使用してサービスアカウントを作成します。
         apiVersion: v1
kind: ServiceAccount
metadata:
  name: <name>
  namespace: <namespace>
      2. kubectl create -f <yaml file>を実行します。
         サービスアカウントが作成されます。
      3. kubectl create clusterrolebinding <name> --clusterrole=cluster-admin --serviceaccount=<namespace>:<name>を実行して、クラスターロールをサービスアカウントにバインドします。
         サービスアカウントは、クラスター全体のアクセス権を持つようになります。
         サービスアカウントの作成中にトークンが自動的に生成されます。
      4. kubectl describe sa <name>を実行してトークンを表示します。
      5. シークレット文字列を取得するには、kubectl describe secret <token-name>を実行します。
         トークンを生成(/en-us/netscaler-application-delivery-management-software/media/sg-generate-token.png)
   4. リストからエージェントを選択します。
      注
      オンプレミスエージェントを使用している場合は、CPX YAMLに追加したのと同じエージェントを選択してください。

   5. 作成をクリックします。
      クラスターを追加(/en-us/netscaler-application-delivery-management-software/media/add-cluster.png)

サンプルマイクロサービスアプリケーションの展開

1. 名前空間を作成するには、kubectl create -f namespace.yamlを実行します。
2. 次のコマンドを使用して、hotdrinkマイクロサービス、イングレス、およびシークレットを展開します。
   kubectl create -f team_hotdrink.yaml -n sg-demo
   kubectl create -f hotdrink-secret.yaml -n sg-demo

CPXを展開し、ADMにCPXを登録する

1. クラスターロールとクラスターバインディングを展開するには、kubectl create -f rbac.yamlを実行します。
2. CPXを展開するには、kubectl create -f cpx.yaml -n sg-demoを実行します。

ライセンス付与のために仮想サーバーの自動選択を有効にする

1. 設定 > ライセンスと分析の構成に移動します。
2. 仮想サーバーライセンスの概要で、仮想サーバーの自動選択とアドレス指定不可能な仮想サーバーの自動選択を有効にします。
   

WebトランザクションとTCPトランザクションの設定を有効にする

1. 設定 > 分析設定に移動します。
   分析設定ページが表示されます。
2. 分析機能の有効化をクリックします。
3. Webトランザクション設定で、すべてを選択します。
4. TCPトランザクション設定で、すべてを選択します。
   TCP(/en-us/netscaler-application-delivery-management-software/media/tcp-setting-citrix.png)
5. OKをクリックします。

マイクロサービスにトラフィックを送信する

1. NodePort経由でCPXを公開するために、kubectl get svc -n sg-demoを実行します。
   NodePort(/en-us/netscaler-application-delivery-management-software/media/sg-nodeport.png)
2. etc/hostファイルを編集し、hotdrink.beverages.comのドメインIPエントリを作成します。
   これで、https://hotdrink.beverages.comを使用してマイクロサービスにアクセスできます。