第4章 distributed tracing platform (Jaeger)
4.1. インストール
Red Hat OpenShift distributed tracing platform (Jaeger) は、非推奨の機能です。非推奨の機能は依然として OpenShift Container Platform に含まれており、引き続きサポートされますが、この製品の今後のリリースで削除されるため、新規デプロイメントでの使用は推奨されません。
Red Hat OpenShift distributed tracing platform Operator (Jaeger) は、今後のリリースで redhat-operators
カタログから削除される予定です。詳細は、Red Hat ナレッジベースソリューション Jaeger Deprecation and Removal in OpenShift を参照してください。
分散トレーシングの収集と保存を行うには、Red Hat build of OpenTelemetry Operator と Tempo Operator に移行する必要があります。詳細は、Red Hat build of OpenTelemetry ドキュメントの「移行」、Red Hat build of OpenTelemetry ドキュメントの「インストール」、および distributed tracing platform (Tempo) ドキュメントの「インストール」を参照してください。
OpenShift Container Platform で非推奨となったか、削除された主な機能の最新の一覧は、OpenShift Container Platform リリースノートの 非推奨および削除された機能セクションを参照してください。
Red Hat OpenShift distributed tracing platform を OpenShift Container Platform にインストールするには、以下のいずれかの方法を使用できます。
-
Red Hat OpenShift distributed tracing platform は、Red Hat OpenShift Service Mesh の一部としてインストールできます。分散トレースは、デフォルトでサービスメッシュインストールに含まれています。サービスメッシュの一部として Red Hat OpenShift distributed tracing platform をインストールするには、Red Hat Service Mesh のインストール の手順に従います。Red Hat OpenShift distributed tracing platform はサービスメッシュと同じ namespace にインストールする必要があります。つまり、
ServiceMeshControlPlane
と Red Hat OpenShift distributed tracing platform リソースが同じ namespace にある必要があります。 - サービスメッシュをインストールする必要がない場合は、Red Hat OpenShift distributed tracing platform Operator を使用して distributed tracing platform をインストールできます。サービスメッシュなしで Red Hat OpenShift distributed tracing platform をインストールするには、以下の手順を実行します。
4.1.1. 前提条件
Red Hat OpenShift distributed tracing platform をインストールする前に、インストールアクティビティーで前提条件を満たしていることを確認してください。
- お使いの Red Hat アカウントに有効な OpenShift Container Platform サブスクリプションを用意します。サブスクリプションをお持ちでない場合は、営業担当者にお問い合わせください。
- OpenShift Container Platform 4.17 の概要 を確認します。
OpenShift Container Platform 4.17 をインストールします。
-
OpenShift Container Platform バージョンに一致する
oc
CLI ツールのバージョンをインストールし、これをパスに追加します。 -
cluster-admin
ロールを持つアカウントがある。
4.1.2. Red Hat OpenShift distributed tracing platform のインストール概要
Red Hat OpenShift distributed tracing platform は、次の手順でインストールできます。
- ドキュメントを確認し、デプロイメントストラテジーを確認します。
- デプロイメントストラテジーに永続ストレージが必要な場合は、OperatorHub を使用して OpenShift Elasticsearch Operator をインストールします。
- OperatorHub を使用して Red Hat OpenShift distributed tracing platform (Jaeger) Operator をインストールします。
- デプロイメントストラテジーをサポートするよう、カスタムリソース YAML ファイルを変更します。
- Red Hat OpenShift distributed tracing platform (Jaeger) の 1 つ以上のインスタンスを OpenShift Container Platform 環境にデプロイします。
4.1.3. OpenShift Elasticsearch Operator のインストール
デフォルトの Red Hat OpenShift 分散トレースプラットフォーム (Jaeger) のデプロイメントでは、インメモリーのストレージが使用されます。これは、Red Hat OpenShift 分散トレースの評価、デモの提供、またはテスト環境での Red Hat OpenShift 分散トレースプラットフォームの使用を希望するユーザー用に、迅速にインストール行うために設計されているためです。実稼働環境で Red Hat OpenShift 分散トレースプラットフォーム (Jaeger) を使用する予定がある場合、永続ストレージのオプション (この場合は Elasticsearch) をインストールし、設定する必要があります。
前提条件
- OpenShift Container Platform Web コンソールにアクセスできる。
-
cluster-admin
ロールを持つユーザーとしてクラスターにアクセスできる。(Red Hat OpenShift Dedicated を使用する場合)dedicated-admin
ロールがあるアカウント。
Operator のコミュニティーバージョンはインストールしないでください。コミュニティー Operator はサポートされていません。
OpenShift Logging の一部として OpenShift Elasticsearch Operator がすでにインストールされている場合は、OpenShift Elasticsearch Operator を再びインストールする必要はありません。Red Hat OpenShift 分散トレースプラットフォーム (Jaeger) Operator はインストールされた OpenShift Elasticsearch Operator を使用して Elasticsearch インスタンスを作成します。
手順
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform Web コンソールにログインします。(Red Hat OpenShift Dedicated を使用する場合)dedicated-admin
ロールがあるアカウント。 -
Operators
OperatorHub に移動します。 - Elasticsearch とフィルターボックスに入力して、OpenShift Elasticsearch Operator を検索します。
- Red Hat が提供する OpenShift Elasticsearch Operator をクリックし、Operator に関する情報を表示します。
- Install をクリックします。
- Install Operator ページで、stable 更新チャネルを選択します。これにより、新しいバージョンがリリースされると Operator が自動的に更新されます。
デフォルトの All namespaces on the cluster (default) を受け入れます。これにより、Operator がデフォルトの
openshift-operators-redhat
プロジェクトにインストールされ、Operator はクラスター内のすべてのプロジェクトで利用可能になります。注記Elasticsearch のインストールには、OpenShift Elasticsearch Operator 用の openshift-operators-redhat namespace が必要です。他の Red Hat OpenShift distributed tracing platform Operators は、
openshift-operators
namespace にインストールされます。デフォルトの Automatic 承認ストラテジーを受け入れます。デフォルトを受け入れることで、Operator の新規バージョンが利用可能になると、Operator Lifecycle Manager (OLM) は人の介入なしに、Operator の実行中のインスタンスを自動的にアップグレードします。手動 更新を選択する場合は、Operator の新規バージョンが利用可能になると、OLM は更新要求を作成します。クラスター管理者は、Operator が新規バージョンに更新されるように更新要求を手動で承認する必要があります。
注記手動 の承認ストラテジーには、Operator のインストールおよびサブスクリプションプロセスを承認するための適切な認証情報を持つユーザーが必要です。
- Install をクリックします。
-
Installed Operators ページで、
openshift-operators-redhat
プロジェクトを選択します。OpenShift Elasticsearch Operator が InstallSucceeded ステータスになるまで待機してから続行します。
4.1.4. Red Hat OpenShift 分散トレースプラットフォーム Operator のインストール
OperatorHub を使用して Red Hat OpenShift 分散トレーシング Platform Operator をインストールできます。
デフォルトでは、Operator は openshift-operators
プロジェクトにインストールされます。
前提条件
- OpenShift Container Platform Web コンソールにアクセスできる。
-
cluster-admin
ロールを持つユーザーとしてクラスターにアクセスできる。(Red Hat OpenShift Dedicated を使用する場合)dedicated-admin
ロールがあるアカウント。 - 永続ストレージが必要な場合は、Red Hat OpenShift 分散トレーシング Platform Operator をインストールする前に OpenShift Elasticsearch Operator をインストールする必要があります。
手順
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform Web コンソールにログインします。(Red Hat OpenShift Dedicated を使用する場合)dedicated-admin
ロールがあるアカウント。 -
Operators
OperatorHub に移動します。 - 検索フィールドに distributed tracing platform と入力して、Red Hat OpenShift 分散トレーシング Platform Operator を検索します。
- Red Hat が提供 する Red Hat OpenShift distributed tracing platform Operator を選択し、Operator に関する情報を表示します。
- Install をクリックします。
- Install Operator ページの Update channel で stable を選択すると、新しいバージョンがリリースされたときに Operator が自動的に更新されます。
-
デフォルトの All namespaces on the cluster (default) を受け入れます。これにより、Operator がデフォルトの
openshift-operators
プロジェクトにインストールされ、Operator はクラスター内のすべてのプロジェクトで利用可能になります。 デフォルトの Automatic 承認ストラテジーを受け入れます。
注記このデフォルトを受け入れると、Operator の新しいバージョンが利用可能になったときに、Operator Lifecycle Manager (OLM) が、この Operator の実行中のインスタンスを自動的にアップグレードします。
Manual 更新を選択した場合、新しいバージョンの Operator が利用可能になると、OLM は更新リクエストを作成します。Operator を新しいバージョンに更新するには、クラスター管理者として更新リクエストを手動で承認する必要があります。Manual 承認ストラテジーでは、クラスター管理者が Operator のインストールとサブスクリプションを手動で承認する必要があります。
- Install をクリックします。
-
Operators
Installed Operators に移動します。 -
Installed Operators ページで、
openshift-operators
プロジェクトを選択します。Red Hat OpenShift 分散トレーシング Platform Operator のステータスが Succeeded になるまで待機してから続行します。