Citrix Application Delivery Management 13.0

サービスグラフの設定

ソフトウェア要件

Kubernetes配布 Kubernetesバージョン コンテナーネットワークインターフェイス (CNI) CPXバージョン CIC バージョン Citrix ADM バージョン Citrix ADM エージェントのバージョン
オープンソース v1.16.3 Flannel、CalicoまたはCanal 13.0–41.28 1.5.25 13.0–47.22 13.0–47.22

はじめに

次のシナリオを使用して、サービスグラフを表示できます。

  • 同じネットワーク上のCitrix ADM とKubernetesクラスタ(たとえば、同じCitrix HypervisorでホストされているCitrix ADMとKubernetesクラスタ)。

  • Citrix ADM およびKubernetesクラスタが別のネットワーク上にインストールされている。このシナリオでは、on-prem agentを構成し、Kubernetes クラスタがホストされているネットワーク上でエージェントを登録する必要があります。

Citrix ADM でサービスグラフを使用するには、次の項目があることを確認してください。

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

Kubernetes クラスター内では、コンテナー化されたすべての Pod はオーバーレイネットワークを使用します。これらのプライベート IP アドレスを直接使用して通信を確立することはできません。Citrix ADM からKubernetesクラスタへの通信を有効にするには、Citrix ADMで静的ルーティングを構成する必要があります。

オンプレミスエージェントを使用している場合は、エージェントにスタティックルートを設定してください。SSHクライアントを使用して、Citrix ADM エージェントにログオンし、静的ルートを構成します。

Kubernetes クラスターの次の IP アドレスがあるとします。

  • Kubernetes master – 10.106.157.112

  • Kubernetes worker 1 – 10.106.157.110

  • Kubernetes worker 2 – 10.106.157.111

  1. SSHクライアントを使用してCitrix ADM にログオンする

  2. コマンドroute add -net <public IP address range> <Kubernetes IP address>を使用して、静的ルーティングを設定します。

    次に例を示します:

    route add -net 192.168.0.0/24 10.106.157.112

    route add -net 192.168.1.0/24 10.106.157.111

    route add -net 192.168.2.0/24 10.106.157.110

  3. 設定を確認するには、 netstat -rn

    静的ルーティング

  4. これらのルートコマンドを /mpsconfig/svm.conf ファイルに追加します。

    1. Citrix ADM では、次のコマンドを使用して svm.conf ファイルにアクセスします。

      vim /mpsconfig/svm.conf

    2. 静的ルートを svm.conf ファイルに追加します。

      たとえば、route add -net 192.168.0.0/24 10.106.157.112のようになります。

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

  1. コマンド git clone https://github.com/citrix/citrix-k8s-ingress-controller.git を使用して、マスターノードでgitハブリポジトリをクローンします。

  2. YAMLにアクセスするには:

    cd citrix-k8s-ingress-controller/example/servicegraph-demo/

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

Citrix ADM でCPXを登録するには、CPX YAMLファイルに次のパラメータを含める必要があります。

- name: "NS_MGMT_SERVER"
  value: "10.106.150.72"
- name: "NS_MGMT_FINGER_PRINT"
  value: "E3:3A:2B:F7:CC:A6:3D:72:8F:3E:3E:4F:0D:C3"
- name: "NS_HTTP_PORT"
  value: "9080"
- name: "NS_HTTPS_PORT"
  value: 9443"
- name: "LOGSTREAM_COLLECTOR_IP"
  value: "10.106.150.72"

<!--NeedCopy-->

CPX YAML ファイル

  • NS_MGMT_SERVER :Citrix ADM IPアドレスを示します。

    ADM エージェントを使用する場合は、オンプレミスエージェントの IP アドレスを使用する必要があります。

  • NS_MGMT_FINGER_PRIN T:Citrix ADM におけるCPXの認証を示します。指紋を取得するには:

    1. Citrix ADM で、[ システム ]>[ 管理]に移動します。

    2. [ システム構成] で [ ADM フィンガープリントの表示] をクリックします。

      Fingerprint

      注:

      オンプレミスエージェントを構成している場合は、[ ネットワーク ] > [エージェント] に移動し、 エージェントを選択して [ フィンガープリントの表示] をクリックします。

      指紋エージェント

  • NS_HTTP_POR T:通信用のHTTPポートを示します。

  • NS_HTTPS_PORT :通信用のHTTPSポートを示します。

  • LOGSTREAM_COLLECTOR_IP — Citrix ADM エージェントのIPアドレスを示します。ログデータをCPXからADMに転送するには、ログストリームプロトコルを有効にする必要があります。

Citrix ADM で Kubernetes クラスターを追加する

静的ルートを構成したら、Citrix ADM でKubernetesクラスターを追加する必要があります。

Kubernetesクラスタを追加するには、次の手順に従います。

  1. 管理者の資格情報を使用してCitrix ADM にログオンします。

  2. [ オーケストレーション ] > [ Kubernetes ] > [ クラスタ] に移動します。 「 クラスタ 」ページが表示されます。

  3. [追加] をクリックします。

  4. [ クラスタの追加 ] ページで、次のパラメータを指定します。

    -  オンプレミスエージェントを構成している場合は、CPX YAML に追加したものと同じエージェント IP アドレスを選択してください。
    
    -  エージェントが設定されていない場合は、\[ **Ag** ent\] フィールドを空白のままにできます。
    

    クラスタの追加

    1. [名前 ]: 任意の名前を指定します。

    2. API サーバー URL -Kubernetes マスターノードから API サーバー URL の詳細を取得できます。

      1. Kubernetes マスターノードで、コマンドkubectl cluster-infoを実行します。

        API サーバーの URL

      2. 「Kubernetes マスターが実行中です」と表示される URL を入力します。

    3. 認証トークン -認証トークンを指定します。認証トークンは、KubernetesクラスタとCitrix ADM 間の通信へのアクセスを検証するために必要です。認証トークンを生成する手順は、次のとおりです。

      Kubernetes マスターノードで、次の操作を行います。

      1. YAML を使用してサービスアカウントを作成します。

        kubectl create -f adm_svc_account.yaml

        サービスアカウントが作成されます。

      2. kubectl create clusterrolebinding citrixadm-sa-admin --clusterrole=cluster-admin --serviceaccount=default:citrixadm-saを実行して、クラスターの役割をサービスアカウントにバインドします。

        これで、サービスアカウントはクラスタ全体にアクセスできるようになります。

        トークンは、サービスアカウントの作成中に自動的に生成されます。

      3. kubectl describe sa citrixadm-saを実行してトークンを表示します。

      4. シークレット文字列を取得するには、kubectl describe secret <token-name>を実行します。

        トークンの生成

    4. リストからエージェントを選択します。

    5. [作成] をクリックします。

      ライセンスの自動選択仮想サーバーを有効にした後、サービスグラフでデータを表示できます。

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

マスターノードで、次の操作を行います。

  1. kubectl create -f namespace.yamlを実行して名前空間を作成します。

  2. 次のコマンドを使用して、ホットドリンクマイクロサービス、入力、シークレットを配置します。

    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. kubectl create -f cpx.yaml -n sg-demoを実行してCPXをデプロイします。

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

Citrix ADM でKubernetesクラスタを追加した後、ライセンス取得のために仮想サーバーを自動的に選択する必要があります。サービスグラフにデータを表示するには、仮想サーバのライセンスが必要です。仮想サーバを自動選択するには、次の手順で行います。

  1. [ システム ] > [ ライセンスと分析] に移動します。

  2. [ 仮想サーバーライセンスの概要] で、 [仮想サーバーの自動選択][アドレス指定できない仮想サーバーの自動選択] を有効にします。

    仮想サーバを自動選択

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

Kubernetes クラスターを追加し、自動選択仮想サーバーを有効にしたら、 Web トランザクション設定 を [ すべて] に変更します。この設定を有効にするには、次の手順に従います。

  1. [ Analytics ] > [ 設定]に移動します。

    [ 設定] ページが表示されます。

  2. [ 分析機能の有効化] をクリックします。

  3. 「Webトランザクションの設定」で「 すべて 」を選択し、「 OK」をクリックします。

    web-transaction-settings

マイクロサービスへのトラフィックの送信

次に、トラフィックをマイクロサービスに送信して、Citrix ADM に表示されるサービスグラフを取得する必要があります。

  1. NodePortを介してCPXを公開するためにkubectl get svc -n sg-demoを実行します。

    ノードポート

  2. etc/host ファイルを編集し、hotdrink.beverages.comのドメインIPエントリを作成します。

    https://hotdrink.beverages.comを使用してマイクロサービスに アクセスできるようになりました。