第3章 Distributed Tracing Platform のインストール
非推奨の Distributed Tracing Platform (Jaeger) のインストールについては、Distributed Tracing Platform (Jaeger) ドキュメントの インストール を参照してください。
Distributed Tracing Platform をインストールするには、次の手順を実行します。
- Tempo Operator をインストールします。
- サポートされているオブジェクトストアを設定し、オブジェクトストアの認証情報のシークレットを作成します。
- 権限とテナントを設定します。
ユースケースに応じて次のデプロイメントを選択してインストールします。
-
マイクロサービスモードの
TempoStack
インスタンス -
モノリシックモードの
TempoMonolithic
インスタンス
-
マイクロサービスモードの
3.1. Tempo Operator のインストール
Tempo Operator は、Web コンソールまたはコマンドラインを使用してインストールできます。
3.1.1. Web コンソールを使用した Tempo Operator のインストール
Tempo Operator は、Web コンソールの Administrator ビューからインストールできます。
前提条件
-
cluster-admin
ロールを持つクラスター管理者として、OpenShift Container Platform Web コンソールにログインしている。 -
Red Hat OpenShift Dedicated の場合、
dedicated-admin
ロールを持つアカウントを使用してログインしている。 サポートされているプロバイダーによる必要なオブジェクトストレージ Red Hat OpenShift Data Foundation、MinIO、Amazon S3、Azure Blob Storage、Google Cloud Storage の設定が完了している。詳細は、「オブジェクトストレージのセットアップ」を参照してください。
警告オブジェクトストレージは必須ですが、Distributed Tracing Platform には含まれていません。Distributed Tracing Platform をインストールする前に、サポートされているプロバイダーによるオブジェクトストレージを選択して設定する必要があります。
手順
-
Operators
OperatorHub に移動し、 Tempo Operator
を検索します。 Red Hat が提供 する Tempo Operator を選択します。
重要次の選択は、この Operator のデフォルトのプリセットです。
-
Update channel
stable -
Installation mode
All namespaces on the cluster -
Installed Namespace
openshift-tempo-operator -
Update approval
Automatic
-
Update channel
- Enable Operator recommended cluster monitoring on this Namespace チェックボックスを選択します。
-
Install
Install View Operator を選択します。
検証
- インストール済み Operator ページの Details タブの ClusterServiceVersion details で、インストールの Status が Succeeded であることを確認します。
3.1.2. CLI を使用した Tempo Operator のインストール
Tempo Operator はコマンドラインからインストールできます。
前提条件
cluster-admin
ロールを持つクラスター管理者によるアクティブな OpenShift CLI (oc
) セッション。ヒント-
OpenShift CLI (
oc
) のバージョンが最新であり、OpenShift Container Platform バージョンと一致していることを確認してください。 oc login
を実行します。oc login --username=<your_username>
$ oc login --username=<your_username>
Copy to Clipboard Copied!
-
OpenShift CLI (
サポートされているプロバイダーによる必要なオブジェクトストレージ Red Hat OpenShift Data Foundation、MinIO、Amazon S3、Azure Blob Storage、Google Cloud Storage の設定が完了している。詳細は、「オブジェクトストレージのセットアップ」を参照してください。
警告オブジェクトストレージは必須ですが、Distributed Tracing Platform には含まれていません。Distributed Tracing Platform をインストールする前に、サポートされているプロバイダーによるオブジェクトストレージを選択して設定する必要があります。
手順
以下のコマンドを実行して、Tempo Operator のプロジェクトを作成します。
oc apply -f - << EOF apiVersion: project.openshift.io/v1 kind: Project metadata: labels: kubernetes.io/metadata.name: openshift-tempo-operator openshift.io/cluster-monitoring: "true" name: openshift-tempo-operator EOF
$ oc apply -f - << EOF apiVersion: project.openshift.io/v1 kind: Project metadata: labels: kubernetes.io/metadata.name: openshift-tempo-operator openshift.io/cluster-monitoring: "true" name: openshift-tempo-operator EOF
Copy to Clipboard Copied! 以下のコマンドを実行して、Operator グループを作成します。
oc apply -f - << EOF apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: openshift-tempo-operator namespace: openshift-tempo-operator spec: upgradeStrategy: Default EOF
$ oc apply -f - << EOF apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: openshift-tempo-operator namespace: openshift-tempo-operator spec: upgradeStrategy: Default EOF
Copy to Clipboard Copied! 以下のコマンドを実行して、サブスクリプションを作成します。
oc apply -f - << EOF apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: tempo-product namespace: openshift-tempo-operator spec: channel: stable installPlanApproval: Automatic name: tempo-product source: redhat-operators sourceNamespace: openshift-marketplace EOF
$ oc apply -f - << EOF apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: tempo-product namespace: openshift-tempo-operator spec: channel: stable installPlanApproval: Automatic name: tempo-product source: redhat-operators sourceNamespace: openshift-marketplace EOF
Copy to Clipboard Copied!
検証
次のコマンドを実行して、Operator のステータスを確認します。
oc get csv -n openshift-tempo-operator
$ oc get csv -n openshift-tempo-operator
Copy to Clipboard Copied!