カスタムエディションの手動インストール

「Self-Hosted Custom Edition」( Kubernetes または Red Hat OpenShift Container Platform ) を手動でインストールできます。

Custom Edition をデプロイするには、クラスタ管理者の権限が必要です。

前提条件

  1. 「 Instana Enterprise Operator」の要件を確認してください。 詳細については、 「 Instana Enterprise オペレーター」 を参照してください。

  2. セルフホスト型カスタムエディション( Kubernetes または Red Hat OpenShift Container Platform ) 」のインストール要件、 およびセルフホスト型 Instana の展開におけるアウトバウンドネットワークアクセス要件を確認してください。 Instana バックエンドをインストールする前に、要件が満たされていることを確認してください。

  3. 必要なデータ・ストアをセットアップして構成します。 詳細については、 「データストアの設定」 を参照してください。

  4. ファイル config.yaml が作成されていることを確認してください。 このファイルは、バックエンドコンポーネントの設定に必要です。 バックエンドコンポーネントの詳細については、 Instana の「バックエンドコンポーネント」 を参照してください。

インストール手順

  1. プラグイン kubectl をインストールしてください。 詳細については、 「 Instana kubectl プラグインのインストール」 を参照してください。

  2. Kubernetes または Red Hat OpenShift クラスタに Instana Enterprise Operatorをインストールして設定します:

    1. Admission Webhook用の TLS シークレットを作成します。 次のオプションのいずれかを選択してください。

    2. イメージのプル用シークレットを作成します。 詳細については、 「イメージのプルシークレットの作成」 を参照してください。

      注: 「 artifact-public.instana.io 」をミラーリングする独自の Docker レジストリをお持ちでなく、プルシークレットも不要な場合は、イメージのプルシークレットを作成してください。
    3. 値ファイルを作成し、設定を行います。 詳細については、 「値ファイルの作成と設定」 を参照してください。

      注:Instana Enterprise Operator をインストールする前に、ファイル values 内の「 imagePullSecrets 」フィールドを更新する必要があります。
    4. Instana Enterprise Operator をインストールします。 詳細については、 「 Instana Enterpriseオペレーターのインストール」 を参照してください。

    5. オプション:詳細な演算子設定を使用します。 詳細については、 「高度な演算子設定の使用」 を参照してください。

      注:Instana Enterprise Operator をインストールした後、values ファイルを使用して必要に応じて設定を行うことができます。
  3. Instana バックエンドのコンポーネントをインストールします:

    1. Core オブジェクトと Unit オブジェクト用の名前空間を作成します。 詳細については、 「名前空間の作成」 を参照してください。

    2. CoreオブジェクトおよびUnitオブジェクト用のイメージプルシークレットを作成します。 詳細については、 「イメージのプルシークレットの作成」 を参照してください。

    3. ライセンスファイルをダウンロードしてください。 詳細については、 「ライセンスファイルのダウンロード」 を参照してください。

    4. シークレットを作成する:

      1. 秘密のインスタナ-TLS

      2. 核心の秘密

      3. ユニットの秘密

    5. Coreオブジェクトを作成する:

      1. 基本的な設定でCoreオブジェクトファイルを作成します。 詳細については、「 基本設定 」を参照してください。

      2. (任意):CPU/メモリリソースを設定します。 詳細については、 「CPU/メモリリソース」 を参照してください。

      3. エージェント・アクセプタを設定します。 詳細については、 「エージェント・アクセプター」 を参照してください。

      4. Rawのデータストレージを設定します。 詳細については、 「Raw spansの保存」 を参照してください。

      5. データストアを設定します。 詳細については、 「データストア」 を参照してください。

      6. オプション:データ保持の既定値を設定します。 詳細については、 「データ保持の既定値の上書き」 を参照してください。

      7. Coreオブジェクトの設定を適用します。 詳細については、 「コア構成の適用」 を参照してください。

    6. Unitオブジェクトを作成します。 詳細については、 「ユニットの作成」 を参照してください。

  4. Acceptor および Gateway サービス用に、ロードバランサーと DNS を設定します。 詳細については、 「ロードバランサーの設定」および DNS を参照してください。

  5. オプション:セルフホスト型環境ではデフォルトで有効になっていない機能を有効にします。 詳細については、 「カスタムエディションのオプション機能の有効化」 を参照してください

  6. (任意):FIPS要件に準拠する。 詳細については、 「FIPS要件への準拠」 を参照してください。

必要なリソース:カスタムリソース定義

カスタム・リソース定義 (CRD) は、Kubernetes API の拡張です。

Instana のバックエンド展開時には、以下の2つのCRDが必要です。 これらは、 Instana のバックエンドと同じクラスタにインストールする必要があります。

cores.instana.io

「Core」とは、 Instana のインストール環境で共有されるすべてのコンポーネントを指します。 各コアには、関連付けられたデータベースのセットがあります。これらのデータベースは、コア自体と、コアのメンバーとして作成されたそれぞれのテナント・ユニットを持つすべてのテナントによって使用されます。

詳細については、 『 API リファレンス』 を参照してください。

units.instana.io

ユニットは、Instana 内の個々のデータ・プールを表します。 内部的には、Instana には、単なる論理構成であるテナントがあります。 各テナントには、少なくとも 1 つ、または複数のテナント・ユニットがあります。 構成に関する限り、常にユニット CRD を使用してテナント・ユニットを構成します。 テナントは、部門 (SRE、Dev、QA など) またはその他の論理グループを表すことができます。 テナント内で、必要に応じて個々のユニットを作成できます。 1 つのユニットのデータは、他のユニットには表示されません。

例えば、eコマース部門とイントラネット部門の2つの部門があります。

e-コマースには、dev、preprod、prod の 3 つの環境があります。 イントラネットには、dev と prod の 2 つの環境があります。 この場合、テナント・ユニット dev、preprod、および prod を使用してテナント e-コマースを作成し、テナント・ユニット dev および prod を使用してテナント・イントラネットを作成することができます。

テナント・ユニットは分離され、関連付けられているエージェントからのみデータを受信します。

詳細については、 『 API リファレンス』 を参照してください。

ヒント

ヒント1

また、 kubectl explain コマンドを実行すると、 API のリファレンスを確認できます。

使用方法の詳細については、 kubectl explain --help を実行してください。

以下の例を参照してください。

kubectl explain core.spec.serviceProviderConfig
KIND:     Core
VERSION:  instana.io/v1beta2

RESOURCE: serviceProviderConfig <Object>

DESCRIPTION:
     Service provider configuration for SAML or OIDC.

FIELDS:
   basePath     <string> -required-
     Base URL (defaults to "/auth").

   maxAuthenticationLifetimeSeconds     <integer> -required-
     The maximum authentication lifetime (defaults to 604.800).

   maxIDPMetadataSizeInBytes    <integer> -required-
     The maximum IDP metadata size (defaults to 200.000).
 

ヒント 2

CRD がクラスターにインストールされている場合に、Kubernetes 拡張機能を備えた VS コードなど、優れたエディターを使用することによりコマンドを補完できます。

以下の例を参照してください。

利用可能