Instanaバックエンドのインストール

オンライン編集

Self-Hosted Custom Edition ( Kubernetes または Red Hat OpenShift Container Platform ) をインストールするには、以下の手順を参照してください：

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

前提条件

オンライン編集

Instana Enterprise Operator の要件を確認してください。詳細については、 Instana Enterprise オペレーターを参照してください。
セルフホスト型カスタムエディション（ Kubernetes または Red HatOpenShift Container Platform ）のインストール要件、およびセルフホスト型Instanaデプロイメントのアウトバウンドネットワークアクセス要件を確認してください。 Instana バックエンドをインストールする前に、要件が満たされていることを確認してください。
必要なデータストアを設定し、構成する。詳細については、「データストアの設定」を参照してください。
config.yaml ファイルが作成されていることを確認してください。このファイルはバックエンドコンポーネントの設定に必要です。バックエンドコンポーネントの詳細については、 Instana バックエンドコンポーネントを参照してください。

インストール手順

オンライン編集

kubectl プラグインをインストールします。詳細については、「Instana kubectl プラグインのインストール」を参照してください。
Kubernetes または Red Hat OpenShift クラスタに Instana Enterprise Operator をインストールして構成します：
1. アドミッションウェブフックのTLSシークレットを作成する。次のオプションのいずれかを選択してください。
  - cert-manager の使用
  - カスタム証明書の使用
2. イメージ・プル・シークレットを作成する。詳しくは、画像のプルシークレットの作成を参照してください。
  
  注 : ' artifact-public.instana.io ' をミラーする独自の Docker レジストリがなく、プルシークレットを必要としない場合は、イメージのプルシークレットを作成してください。
3. 値ファイルを作成し、設定する。詳細については、「値ファイルの作成と設定」を参照してください。
  
  注: Instana Enterprise Operator をインストールする前に、 values ファイルの imagePullSecrets フィールドを更新する必要があります。
4. Instana Enterprise Operator をインストールします。詳細については、 Instana Enterprise オペレータのインストールを参照してください。
5. オプション：高度なオペレータ設定を使用する。詳細については、高度なオペレーター設定を使用するを参照してください。
  
  注: Instana Enterprise Operator をインストールした後、値ファイルを使用して必要に応じて設定できます。
Instana バックエンドのコンポーネントをインストールします：
1. CoreオブジェクトとUnitオブジェクトの名前空間を作成する。詳細については、ネームスペースの作成を参照してください。
2. コア・オブジェクトとユニット・オブジェクトのイメージ・プル・シークレットを作成する。詳しくは、画像のプルシークレットの作成を参照してください。
3. ライセンスファイルをダウンロードしてください。詳しくは、ライセンスファイルのダウンロードをご覧ください。
4. 秘密を作る：
5. Coreオブジェクトを作成する：
  1. 基本的な設定を含むCoreオブジェクトファイルを作成する。詳しくは基本設定をご覧ください。
  2. オプション：CPU/メモリリソースを設定する。詳細は CPU/メモリリソースを参照。
  3. エージェントアクセプターを設定する。詳細については、エージェント・アクセプターを参照のこと。
  4. Rawスパン・データ・ストレージを設定する。詳しくは Raw spans storageを参照のこと。
  5. データストアを構成する。詳細はデータストアを参照。
  6. オプション：データ保持のデフォルトを設定する。詳細については、データ保持のデフォルトを上書きするを参照してください。
  7. コア・オブジェクトの設定を適用する。詳細については、 Coreコンフィギュレーションの適用を参照してください。
6. ユニットオブジェクトを作成する。詳細については、ユニットの作成を参照してください。
Acceptorと Gateway サービスのロードバランサーとDNSをセットアップする。詳細については、「ロードバランサーとDNSの設定」を参照してください。
オプション：セルフホストデプロイメントではデフォルトで有効になっていない機能を有効にする。詳細については、「カスタムエディションのオプション機能の有効化」を参照してください
オプション：FIPS要件に準拠すること。詳細については、「FIPS要件への準拠」を参照してください。

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

オンライン編集

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

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

cores.instana.io

オンライン編集

コアは、Instana インストールで共有されるすべてのコンポーネントを表します。各Coreは、Core自身と、Coreのメンバーとして作成されたそれぞれのテナントユニットを持つすべてのテナントによって使用される、関連データベースのセットを持っています。

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

units.instana.io

オンライン編集

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

例えば、eコマースとイントラネットという2つの部門が存在する。

eコマースには3つの環境がある：開発、準備、生産。イントラネットには、開発環境と生産環境の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 コードなど、優れたエディターを使用することによりコマンドを補完できます。

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

利用可能