製品ドキュメント
NetScaler Console サービス

OpenShiftコンソールを使用したNetScalerエージェントオペレーターのインストール

August 22, 2025
寄稿者: 
C

注:

OpenShiftエージェントはNetScaler Consoleサービスでのみサポートされています。

オペレーターは、Kubernetesアプリケーションを効果的、自動化され、スケーラブルな方法で展開および管理できるオープンソースのツールキットです。管理者として、NetScaler ADM Agent Operatorを使用してOpenShiftクラスターにエージェントを展開できます。

注:

OpenShiftクラスターで構成されたエージェントは、デフォルトでは自動的にアップグレードされません。

前提条件

展開する前に、以下を確認してください。

  • ポッドの権限を制御するための特権セキュリティコンテキスト制約があること。エージェントの場合、サービスアカウントに特権セキュリティコンテキスト制約を付与するには、次のコマンドを実行します。

    oc adm policy add-scc-to-user privileged -z adm-agent-serviceaccount

  • エージェントのログインシークレットを作成するには、次のコマンドを実行します。

    kubectl create secret generic admlogin --from-literal=username=nsroot --from-literal=password=<adm-agent-password> -n <namespace>

    注:

    • <adm-agent-password>はパスワードの例です。エージェントのパスワードを設定する必要があります。NetScaler CPXはこれらのクレデンシャルを使用してエージェントに登録します。
    • インスタンスの作成時に、エージェントYAMLのloginSecretにadmloginを指定します。

    NetScaler CPXとエージェントを異なるネームスペースに展開する場合は、以下を確認してください。

    • NetScaler CPXが展開されているネームスペースにcitrix-cpx=enabledというラベルを付けます。

    • エージェントオペレーターのインストール時にhelper.requiredをtrueまたはfalseに設定します。

      注:

      デフォルトでは、helper.requiredはfalseに設定されています。このパラメーターがfalseに設定されている場合、NetScaler CPXとエージェントが異なるネームスペースにある場合は、すべてのネームスペースにadmloginシークレットを作成する必要があります。

  • エージェントYAMLで必要なaccessSecretがあること。これらのクレデンシャルは、エージェントがNetScaler Consoleサービスに接続するために必要です。

    kubectl create secret generic <secretname> --from-literal=accessid=<ID> --from-literal=accesssecret=<Secret> -n namespace

    注:

    インスタンスの作成時に、エージェントYAMLのaccessSecretにシークレット名を指定します。

    NetScaler ConsoleにアクセスするためのアクセスIDとシークレットは、次の手順で取得できます。

    1. Citrix Cloud管理コンソールにログオンします。

    2. Citrix Cloudメニューから、Identity and Access Managementを選択します。

      Identity and access management

    3. API Accessタブで、安全なクライアント名を入力し、Create Clientをクリックします。

      API access

    4. IDとシークレットが生成されます。DownloadをクリックしてCSVファイルを保存します。

      ID and secret file

エージェントオペレーターのインストール

  1. OpenShiftクラスターコンソールにログオンします。

  2. Operators > OperatorHubに移動します。

  3. 検索バーにエージェント名を入力し、NetScaler ADM Agent Operatorを選択して、Installをクリックします。

    Agent operator

  4. Install Operatorページには、2つのオプションがあります。

    • All namespaces on the cluster (default) - エージェントオペレーターがクラスター内のすべてのネームスペースをサブスクライブできるようにし、クラスター内の任意のネームスペースからエージェントオペレーターのインスタンスを起動できるようにします。

    • A specific namespace on the cluster - エージェントオペレーターがクラスター上の選択されたネームスペースをサブスクライブできるようにし、選択されたネームスペースからのみエージェントオペレーターのインスタンスを起動できるようにします。

      この例では、エージェントオペレーターはDefaultというネームスペースに割り当てられています。Update approvalの下でAutomaticを選択し、Installをクリックします。

      Install

      エージェントオペレーターが正常にサブスクライブされるまで待ちます。

      Subscribed

  5. Workloads > Podsに移動し、netscaler-adm-agent-operator-controllerポッドが稼働していることを確認します。

  6. ポッドが稼働したら、Create Instanceをクリックします。

    Create instance

  7. パラメーターを更新するにはYAML viewを選択し、Createをクリックします。

    注:

    OpenShiftクラスターごとにエージェントのインスタンスは1つのみであることを確認してください。

    YAML view

  8. Workloads > Podsに移動し、エージェントポッドが稼働していることを確認します。

    Verify pod

エージェントインスタンスの削除

クラスターからエージェントのインスタンスを削除するには、Operators > Installed Operatorsに移動します。NetScaler ADM Agent Operatorタブでインスタンスを選択し、リストからDelete AdmAgentを選択します。

Delete

エージェントオペレーターのアンインストール

クラスターからエージェントオペレーターポッドをアンインストールする場合は、Operators > Installed Operatorsに移動し、リストからUninstall Operatorを選択します。

Uninstall operator

OpenShiftコンソールを使用したNetScalerエージェントオペレーターのインストール
August 22, 2025
寄稿者: 
C
August 22, 2025
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.