製品ドキュメント
Citrix Application Delivery Management
Current Release 13.0 12.1
PDFを表示

Citrix ADM でKubernetes入力構成を管理する

February 14, 2022
寄稿者: 
C

Kubernetes (K8s) は、クラウドネイティブアプリケーションのデプロイ、スケーリング、管理を自動化する、オープンソースのコンテナーオーケストレーションプラットフォームです。

Kubernetes は Ingress 機能を提供し、クラスタ外のクライアントトラフィックが Kubernetes クラスタ内で実行されているアプリケーションのマイクロサービスにアクセスできるようにします。ADC インスタンスは、Kubernetes クラスタ内で実行されているアプリケーションへの入力として機能できます。ADC インスタンスは、クライアントから Kubernetes クラスター内の任意のマイクロサービスに南北トラフィックをロードバランシングし、コンテンツでルーティングできます。

注

  • Citrix ADM は、Kubernetesバージョン1.14以降のクラスタで入力機能をサポートしています。
  • Citrix ADM は、入力デバイスとしてCitrix ADC VPX およびMPXアプライアンスをサポートしています。
  • Kubernetes環境では、Citrix ADCインスタンスは「nodePort」サービスタイプのみを負荷分散します。

複数の ADC インスタンスを、同じクラスタまたは異なるクラスタまたは名前空間上で入力デバイスとして動作するように設定できます。インスタンスを設定したら、Ingress ポリシーに基づいて各インスタンスを異なるアプリケーションに割り当てることができます。

Kubernetes kubectl または API を使用して、入力設定を作成してデプロイできます。また、Citrix ADM からの入力を構成して展開することもできます。

ADM で Kubernetes 統合の次の側面を指定できます。

  • クラスタ — ADM が入力設定をデプロイできる Kubernetes クラスタを登録または登録解除できます。Citrix ADM にクラスターを登録する場合は、Kubernetes APIサーバー情報を指定します。次に、Kubernetes クラスタに到達できる ADM エージェントを選択し、Ingress 構成を展開します。

  • ポリシー — Ingress ポリシーは、Ingress 設定をデプロイするクラスタまたは名前空間に基づいて ADC インスタンスを選択するために使用されます。ポリシーを追加するときに、クラスタ、サイト、およびインスタンスの情報を指定します。

  • 入力設定：この設定 は Kubernetes 入力設定です。この設定には、コンテンツスイッチングルールと、マイクロサービスとそのポートの対応する URL パスが含まれます。また、Kubernetes シークレットリソースを使用して SSL/TLS 証明書を指定することもできます（ADC インスタンスで SSL 処理をオフロードするため）。

Citrix ADM は、入力ポリシーを使用して、入力構成をADCインスタンスに自動的にマッピングします。

入力構成が成功するたびに、Citrix ADM はスタイルブック構成パックを生成します。ConfigPack は、入力設定に対応する ADC インスタンスに適用される ADC 設定を表します。ConfigPack を表示するには、[ アプリケーション] > [StyleBook] > [構成] に移動します。

はじめに

Citrix ADC インスタンスをKubernetesクラスターの入力デバイスとして使用するには、以下の機能があることを確認してください。

  • Kubernetesクラスターが存在する。

  • Citrix ADM に登録された Kubernetes クラスター。

秘密トークンを使用してCitrix ADM を構成し、Kubernetesクラスタを管理する

Citrix ADM がKubernetesからイベントを受信できるようにするには、KubernetesでCitrix ADM 用のサービスアカウントを作成する必要があります。また、クラスタで必要な RBAC アクセス許可を使用してサービスアカウントを構成します。

  1. Citrix ADM サービスアカウントを作成します。たとえば、サービスアカウント名はcitrixadm-saになります。サービスアカウントを作成するには、「 複数のサービスアカウントを使用する」を参照してください。

  2. cluster-admin ロールを使用して、Citrix ADM サービスアカウントをバインドします。このバインディングは、クラスタ全体でClusterRoleをサービスアカウントに付与します。次に、 cluster-admin ロールをサービスアカウントにバインドするコマンドの例を示します。

    kubectl create clusterrolebinding citrixadm-sa-admin --clusterrole=cluster-admin --serviceaccount=default:citrixadm-sa
<!--NeedCopy-->

    Citrix ADM サービスアカウントを cluster-admin ロールにバインドすると、そのサービスアカウントはクラスター全体にアクセスできるようになります。詳細については、[kubectl create clusterrolebinding] (https://kubernetes.io/docs/reference/access-authn-authz/rbac/#kubectl-create-clusterrolebinding) を参照してください。

  3. 作成したサービスアカウントからトークンを取得します。

    たとえば、次のコマンドを実行して、 citrixadm-sa サービスアカウントのトークンを表示します。

    kubectl describe sa citrixadm-sa
<!--NeedCopy-->

  4. 次のコマンドを実行して、トークンのシークレット文字列を取得します。

    kubectl describe secret <token-name>
<!--NeedCopy-->

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

Citrix ADM エージェントを構成して静的ルートを構成したら、Citrix ADMにKubernetesクラスターを登録する必要があります。

Kubernetesクラスタを登録するには：

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

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

  3. ［追加］ をクリックします。

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

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

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

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

        API サーバーの URL

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

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

      1. Kubernetes メインノードで、次のコマンドを実行します。

        kubectl describe secret <token-name>
<!--NeedCopy-->

      2. 生成されたトークンをコピーし、認証トークンとして貼り付けます。

        詳細については、 Kubernetes ドキュメントを参照してください。

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

    5. ［Create］ をクリックします。

      クラスタの追加

入力ポリシーの定義

Ingressポリシーは、Ingressクラスタまたは名前空間に基づいて、Ingress構成の展開に使用するCitrix ADC を決定します。

  1. [ オーケストレーション] > [Kubernetes] > [ポリシー]に移動します。

  2. [ Add ] をクリックしてポリシーを作成します。

    1. ポリシー名を指定します。

    2. 入力設定を Kubernetes クラスターにデプロイするための 条件 を定義します。これらの条件は、通常、入力クラスタと名前空間に基づいています。

    3. [インフラストラクチャ] パネルでは、

      • サイト -リストからサイトを選択します。

      • インスタンス -リストからADCインスタンスを選択します。

      [ サイト ] リストと [ インスタンス ] リストには、[ 条件 ] パネルのクラスタ選択に基づいてオプションが表示されます。

      これらのリストには、Kubernetesクラスターで構成されたCitrix ADM エージェントに関連付けられているサイトまたはインスタンスが表示されます。

    4. [ Choose Network] で、ADM が仮想 IP アドレスを入力構成に自動的に割り当てるネットワークを選択します。

      このリストには、[ネットワーク ] > [IPAM] で作成したネットワークが表示されます。

    5. ［作成］ をクリックします。

入力構成のデプロイ

kubectlを使用してKubernetes から入力設定をデプロイするには、Kubernetes API、またはその他のツールを使用します。入力構成は、Citrix ADM から直接展開することもできます。

  1. オーケストレーション > Kubernetes > Ingresses に移動します。

  2. ［追加］ をクリックします。

  3. [ 入力の作成 ] フィールドで、次の詳細を指定します。

    1. 入力の名前を指定します。

    2. [ クラスタ] で、入力をデプロイする Kubernetes クラスタを選択します。

    3. リストから [ クラスタネームスペース ] を選択します。このフィールドには、指定した Kubernetes クラスターに存在する名前空間が一覧表示されます。

    4. 必要に応じて、[ フロントエンド IP アドレスの自動割り当て] を選択します。

    5. リストから [ 入力プロトコル ] を選択します。[ HTTPS] を選択した場合は、 TLS シークレットを指定します。

      このシークレットは、HTTPS 証明書と秘密キーを埋めている Kubernetes シークレットリソースを埋め込みます。

      HTTPS 入力には、Kubernetes クラスタで設定された TLS ベースのシークレットが必要です。サーバ証明書と証明書キーをそれぞれ含めるtls.crtフィールドとtls.keyフィールドを指定します。

    6. コンテンツルーティングの場合は、次の詳細を指定します。

      • URL パス -Kubernetes サービスおよびポートに関連付けられているパスを指定します。

      • Kubernetesサービス -目的のサービスを指定します。

      • ポート -サービスポートを指定します。

      • LB メソッド -選択した Kubernetes サービスに対する優先ロードバランシング方式を選択します。

        選択したメソッドは、入力仕様を適切な注釈で更新します。たとえば、 ROUNDROBIN メソッドを選択すると、Citrix の注釈は次のように表示されます。

         "lbmethod":"ROUNDROBIN"
 <!--NeedCopy-->

      • 持続性タイプ -選択した Kubernetes サービスに対して優先する負荷分散持続性タイプを選択します。

        選択した永続性タイプによって、入力スペシフィケーションが適切な注釈で更新されます。たとえば、「 COOKEEINSERT」を選択すると、Citrix アノテーションは次のように表示されます。

         "persistenceType":"COOKIEINSERT"
 <!--NeedCopy-->

      [ Add ] をクリックして、入力設定に URL パスとポートを追加します。

      コンテンツルーティングルールの追加

      展開後、Ingress 設定は、次の内容に基づいてクライアントトラフィックを特定のサービスにリダイレクトします。

      • 要求されたURLパスとポート。
      • 定義された LB メソッドと永続性タイプ。

      注：

      入力構成で使用されるKubernetes サービスは、NodePort タイプであることが予想されます。

    7. オプションで、 入力の説明を指定します。

    8. [ デプロイ] をクリックします。

      展開する前に構成を確認する場合は、[ 入力スペックの生成] をクリックします。指定された入力設定が YAML 形式で表示されます。構成を確認したら、[ Deploy] をクリックします。

注： Ingress 構成を使用して作成された仮想サーバーにライセンスを適用します。ライセンスを適用するには、次の手順に従います。

  1. [ システム] > [ライセンスと分析] の順に選択します。
  2. [ 仮想サーバーライセンスの概要] で、 [仮想サーバーの自動選択]を有効にします。
Citrix ADM でKubernetes入力構成を管理する
February 14, 2022
寄稿者: 
C
February 14, 2022
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | プライバシーと法令 | Cookieの設定 | 同意設定
© 1999- Citrix Systems, Inc. All rights reserved.