第3章 Jaeger のインストール
3.1. Jaeger のインストール
Jaeger を OpenShift Container Platform にインストールするには、以下のいずれかの方法を使用できます。
- Jaeger は、Red Hat OpenShift Service Mesh の一部としてインストールできます。Jaeger はデフォルトでサービスメッシュインストールに含まれています。サービスメッシュの一部として Jaeger をインストールするには、Red Hat Service Mesh のインストール の手順に従います。
- サービスメッシュをインストールする必要がない場合は、Jaeger Operator を使用して Jaeger の Red Hat ビルド自体をインストールできます。サービスメッシュなしで Jaeger をインストールするには、以下の手順を実行します。
3.1.1. 前提条件
OpenShift Jaeger をインストールするには、インストールアクティビティーを確認し、前提条件を満たしていることを確認してください。
- お使いの Red Hat アカウントに有効な OpenShift Container Platform サブスクリプションを用意します。サブスクリプションをお持ちでない場合は、営業担当者にお問い合わせください。
- OpenShift Container Platform 4.5 の概要 を確認します。
OpenShift Container Platform 4.5 をインストールします。
-
OpenShift Container Platform バージョンに一致する OpenShift Container Platform コマンドラインユーティリティーのバージョン (
oc
クライアントツール) をインストールし、これをパスに追加します。 -
cluster-admin
ロールを持つアカウントが必要です。
3.1.2. Jaeger インストールの概要
OpenShift Jaeger のインストール手順は以下のとおりです。
- 本書を確認し、デプロイメントストラテジーを確認します。
- デプロイメントストラテジーに永続ストレージが必要な場合は、OperatorHub を使用して Elasticsearch Operator をインストールします。
- OperatorHub を使用して Jaeger Operator をインストールします。
- Jaeger YAML ファイルをデプロイメントストラテジーをサポートするように変更します。
- Jaeger の 1 つ以上のインスタンスを OpenShift Container Platform 環境にデプロイします。
3.1.3. Elasticsearch Operator のインストール
デフォルトの Jaeger デプロイメントはインメモリーストレージを使用します。それは、Jaeger の評価、デモの提供、またはテスト環境での Jaeger の使用を目的としてすぐにインストールできるように設計されているためです。実稼働環境で Jaeger を使用する予定がある場合、永続ストレージのオプション (この場合は Elasticsearch) をインストールする必要があります。
前提条件
- OpenShift Container Platform Web コンソールにアクセスします。
-
cluster-admin
ロールを持つアカウントが必要です。
Operator のコミュニティーバージョンはインストールしないでください。コミュニティー Operator はサポートされていません。
OpenShift クラスターロギングの一部として Elasticsearch Operator がすでにインストールされている場合、Elasticsearch Operator を再びインストールする必要はありません。Jaeger Operator はインストールされた Elasticsearch Operator を使用して Elasticsearch インスタンスを作成します。
手順
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform Web コンソールにログインします。 -
Operators
OperatorHub に移動します。 - Elasticsearch とフィルターボックスに入力して、Elasticsearch Operator を検索します。
- Red Hat が提供する Elasticsearch Operator をクリックし、Operator についての情報を表示します。
- Install をクリックします。
Install Operator ページで A specific namespace on the cluster オプションを選択し、メニューから openshift-operators-redhat を選択します。
注記Elasticsearch インストールガイドによると、OpenShift Jaeger の Elasticsearch Operator の openshift-operators-redhat namespace を指定する必要があります。
- OpenShift Container Platform インストールに一致する Update Channel を選択します。たとえば、OpenShift Container Platform バージョン 4.6 にインストールしている場合は、4.6 更新チャネルを選択します。
Automatic Approval Strategy を選択します。
注記手動の承認ストラテジーには、Operator のインストールおよびサブスクリプションプロセスを承認するための適切な認証情報を持つユーザーが必要です。
- Install をクリックします。
-
Installed Operators ページで、
openshift-operators-redhat
プロジェクトを選択します。Elasticsearch Operator が InstallSucceeded のステータスを表示するまで待機してから続行します。
3.1.4. Jaeger Operator のインストール
Jaeger をインストールするには、OperatorHub を使用して Jaeger Operator をインストールします。
デフォルトで、Operator は openshift-operators
プロジェクトにインストールされます。
前提条件
- OpenShift Container Platform Web コンソールにアクセスします。
-
cluster-admin
ロールを持つアカウントが必要です。 - 永続ストレージが必要な場合、Jaeger Operator をインストールする前に Elasticsearch Operator もインストールする必要があります。
Operator のコミュニティーバージョンはインストールしないでください。コミュニティー Operator はサポートされていません。
手順
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform Web コンソールにログインします。 -
Operators
OperatorHub に移動します。 - Jaeger とフィルターに入力して、Jaeger Operator を検索します。
- Red Hat が提供する Jaeger Operator をクリックし、Operator についての情報を表示します。
- Install をクリックします。
-
Install Operator ページで、All namespaces on the cluster (default) を選択します。これにより、Operator がデフォルトの
openshift-operators
プロジェクトにインストールされ、Operator はクラスター内のすべてのプロジェクトで利用可能になります。 stable Update Channel を選択します。これにより、新しいバージョンがリリースされると Jaeger が自動的に更新されます。1.17-stable などのメンテナーンスチャネルを選択すると、そのバージョンのサポートサイクルの期間、バグ修正およびセキュリティーパッチが送信されます。
Approval Strategy を選択します。Automatic または Manual の更新を選択できます。インストールされた Operator について自動更新を選択する場合、Operator の新規バージョンが利用可能になると、Operator Lifecycle Manager (OLM) は人の介入なしに、Operator の実行中のインスタンスを自動的にアップグレードします。手動更新を選択する場合、Operator の新規バージョンが利用可能になると、OLM は更新要求を作成します。クラスター管理者は、Operator が新規バージョンに更新されるように更新要求を手動で承認する必要があります。
注記手動の承認ストラテジーには、Operator のインストールおよびサブスクリプションプロセスを承認するための適切な認証情報を持つユーザーが必要です。
- Install をクリックします。
-
Subscription Overview ページで、
openshift-operators
プロジェクトを選択します。Jaeger Operator に InstallSucceeded のステータスが表示されるまで待機してから続行します。