Kubernetes ヴィジビリティエージェント展開の準備

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：8分

    • Kubernetes ヴィジビリティエージェント展開のためにServiceNowインスタンスとKubernetesクラスターを準備します。

    始める前に

    • 次のアプリケーションがインストールされてアクティブ化されていることを確認します。
      • Discovery and Service Mapping Patterns (ディスカバリーとサービスマッピングパターン)
      • の最新バージョン ヴィジビリティ対応エージェントクライアントコレクター - コンテンツ
    • Kubernetes コマンドラインツールである kubectl がインストールされ、クラスターと通信するように構成されていることを確認します。詳細については、kubectl に関するドキュメントを参照してください。
    • インストールに Helm チャートを使用する場合は、Helm ツールが使用可能であることを確認します。詳細については、Helm に関するドキュメントを参照してください。

    必要なロール：admin (ServiceNow インスタンスで手順を実行する場合)。

    手順

    1. ServiceNowインスタンスで、 All (すべて) > ユーザー管理 (User Administration) > ユーザー.
    2. 少なくとも discovery_admin ロールを持つユーザーを選択または作成します。
      インスタンスに新しいユーザーを追加する方法については、「Create a user」を参照してください。ユーザーにロールを付与する方法については、「Assign a role to a user」を参照してください。
    3. Kubernetesクラスターで、Kubernetes ヴィジビリティエージェントを展開する名前空間を選択または作成します。
      名前空間を作成するには、次の手順を実行します。
      1. kubectl コマンドラインツールを開きます。
      2. NAMESPACE を関連する値に置き換えた後、次のコマンドを実行します。

        kubectl create namespace NAMESPACE

    4. ServiceNow インスタンスにアクセスするための ServiceNow 認証情報を含む Kubernetes シークレットを作成します。
      注:
      認証情報が、前の手順で作成または特定したユーザーに対応していることを確認します。
      1. kubectl コマンドラインツールを開きます。
      2. INSTANCE_NAME、USERNAME、PASSWORD、NAMESPACE の値を関連する値に置き換えた後、次のコマンドを実行します。
        kubectl create secret generic k8s-informer-cred-INSTANCE_NAME --from-literal=.user=USERNAME --from-literal=.password=PASSWORD -n NAMESPACE
      注:
    5. オプション: 組織のポリシーで必要な場合は、組織のイメージリポジトリに Informer Docker イメージを配置します。
      注:
      2024 年 11 月にリリースされた Kubernetes ヴィジビリティエージェント バージョン 3.9.0 (Informer バージョン 2.3.0) 以降、Docker イメージは arm64 アーキテクチャと amd64 アーキテクチャの両方をサポートしています。以前のイメージから新しいイメージにアップグレードしても、中断は発生しません。ただし、新しいイメージでは、イメージリポジトリに以前のイメージよりも多くのストレージ領域が必要になります。
      1. Docker Hub からイメージをプルし、組織のリポジトリにプッシュします。

        VERSION を、Now Support ナレッジベース記事の「CNO for Visibility Helm Chart and Kubernetes YAML file releases (CNO の可視化の Helm チャートおよび Kubernetes YAML ファイルリリース) [KB1564347]」で提供されている最新のリリース番号に置き換えます。

        Docker pull docker.io/servicenowdocker/informer:VERSION
 Docker tag docker.io/servicenowdocker/informer:VERSION COMPANY_REPO:VERSION
 Docker push COMPANY_REPO:VERSION
      2. イメージリポジトリで認証が必要な場合は、指定された名前空間に k8s-informer-repo-cred という名前のシークレットを作成します。
        例：
        kubectl create secret docker-registry k8s-informer-repo-cred --docker-server https://index.docker.io/v2/ --docker-username DOCKER_USERNAME --docker-password DOCKER_TOKEN --docker-email=user@servicenow.com -n NAMESPACE
    6. オプション: クラスターからの送信トラフィックがプロキシ経由である場合は、クラスターで使用されているプロキシのホスト名とポートを特定します。
      注:
      この情報については、組織の Kubernetes チームにお問い合わせください。これは、インストールプロセスで指定する必要があります。
    7. オプション: Kubernetes ヴィジビリティエージェント がより多くのデータを同時に処理できるようにします。
      デフォルトでは、Informer のバックエンド側は、約 300 のクラスターからのデータを同時に処理できます。クラスターの数が多い場合、またはクラスターが頻繁に変更される場合は、データの処理に使用される同時ワーカースレッドの数を増やすことができます。詳細については、Now Support ナレッジベース記事の「Controlling the number of CNO for Visibility concurrent worker threads (CNO の可視化の同時ワーカースレッド数の制御) [KB1580241]」を参照してください。

    タスクの結果

    ServiceNowインスタンスとKubernetesクラスターをKubernetes ヴィジビリティエージェント展開する準備ができました。

    次のタスク

    Kubernetes ヴィジビリティエージェント のインストール.