Helm Charts の入門 (Scalar Manager)

注記

このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。

Scalar Manager は、Kubernetes クラスタ環境内の ScalarDB および ScalarDL の集中管理および監視ソリューションであり、次のことができます：

• ScalarDB または ScalarDL の可用性を確認します。
• ScalarDB または ScalarDL が使用するデータベースにおいて、トランザクションが一貫した期間を作成するジョブのスケジュールや実行を行います。
• Grafana ダッシュボードを通じて、ScalarDB または ScalarDL の時系列メトリクスやログを確認します。

Scalar Manager の詳細については、Scalar Manager 概要ページを参照してください。

このガイドでは、Kubernetes クラスターに Scalar Manager を展開し、アクセスする方法を説明します。

予測

このガイドでは、モニタリングおよびロギングツールを使用して ScalarDB または ScalarDL を Kubernetes クラスターにデプロイする方法を理解していることを前提としています。

要件

• [GitHub Packages]GitHub Packages から Scalar Manager コンテナ (scalar-manager) をプルするには権限が必要です。
• 上記のコンテナをプルするには、GitHub ドキュメント に従って read:packages スコープの Github Personal Access Token (PAT) を作成する必要があります。
• Helm Charts の入門 (Prometheus Operator を使用したモニタリング)の指示に従って kube-prometheus-stack をデプロイする必要があります。
• Helm Charts の入門 (Loki スタックを使用したロギング)の指示に従って loki-stack をデプロイする必要があります。

私たちが作るもの

次のように、次のコンポーネントを Kubernetes クラスターにデプロイします。

+--------------------------------------------------------------------------------------------------+
| +----------------------+                                                                         |
| |    scalar-manager    |                                                                         |
| |                      |                                                                         |
| | +------------------+ | --------------------------(管理)--------------------------+           |
| | |  Scalar Manager  | |                                                             |           |
| | +------------------+ |                                                             |           |
| +--+-------------------+                                                             |           |
|    |                                                                                 |           |
| +------------------------------------+                                               |           |
| |             loki-stack             |                                               V           |
| |                                    |                                       +-----------------+ |
| | +--------------+  +--------------+ | <----------------(ログ)--------------- | Scalar 製品 | |
| | |     Loki     |  |   Promtail   | |                                       |                 | |
| | +--------------+  +--------------+ |                                       |  +-----------+  | |
| +------------------------------------+                                       |  | ScalarDB  |  | |
|    |                                                                         |  +-----------+  | |
| +------------------------------------------------------+                     |                 | |
| |                kube-prometheus-stack                 |                     |  +-----------+  | |
| |                                                      |                     |  | ScalarDL  |  | |
| | +--------------+  +--------------+  +--------------+ | -----(監視)----> |  +-----------+  | |
| | |  Prometheus  |  | Alertmanager |  |   Grafana    | |                     +-----------------+ |
| | +-------+------+  +------+-------+  +------+-------+ |                                         |
| |         |                |                 |         |                                         |
| |         +----------------+-----------------+         |                                         |
| |                          |                           |                                         |
| +--------------------------+---------------------------+                                         |
|    |                       |                                                                     |
|    |                       |         Kubernetes                                                  |
+----+-----------------------+---------------------------------------------------------------------+
     |                       |
  localhost (127.0.0.1) に公開するか、ロードバランサーなどを使用してアクセスします
     |                       |
  (HTTP経由でダッシュボードにアクセス)
     |                       |
+----+----+             +----+----+
| ブラウザ | <-(埋め込む)-- + ブラウザ |
+---------+             +---------+

ステップ 1. Grafana を埋め込めるように kube-prometheus-stack をアップグレードします。

1. この値を kube-prometheus-stack のカスタム値ファイル (scalar-prometheus-custom-values.yaml など) に追加または修正します。

   kubeStateMetrics:
     enabled: true
   nodeExporter:
     enabled: true
   kubelet:
     enabled: true
   grafana:
     grafana.ini:
       users:
         default_theme: light
       security:
         allow_embedding: true
       auth.anonymous:
         enabled: true
         org_name: "Main Org."
         org_role: Editor

2. Helm インストールをアップグレードします。

   helm upgrade scalar-monitoring prometheus-community/kube-prometheus-stack -n monitoring -f scalar-prometheus-custom-values.yaml

ステップ 2. Scalar Manager のカスタム値ファイルを準備する

1. scalar-manager 用に scalar-manager-custom-values.yaml という名前の空の .yaml ファイルを作成します。

2. Scalar Manager にアクセスするためのサービス タイプを設定します。 デフォルト値は ClusterIP ですが、minikube tunnel コマンドや何らかのロードバランサを使ってアクセスする場合は、LoadBalancer として設定することができます。

   service:
     type: LoadBalancer
     port: 8000

ステップ 3. scalar-manager をデプロイする

1. scalar-manager Helm Chart をデプロイします。

   helm install scalar-manager scalar-labs/scalar-manager -f scalar-manager-custom-values.yaml

ステップ 4. Scalar Manager にアクセスする

minikubeを使用する場合

1. Scalar Manager のサービス リソースを localhost (127.0.0.1) として公開するには、別のターミナルを開き、minikube tunnel コマンドを実行します。

   minikube tunnel

2. URL http://localhost:8000 でブラウザを開きます。

minikube 以外の Kubernetes を使用する場合

Minikube 以外の Kubernetes クラスターを使用している場合は、各 Kubernetes クラスターの方法に従って LoadBalancer サービスにアクセスする必要があります。 例えば、クラウドサービスプロバイダーが提供するロードバランサーを使用するか、kubectl port-forward コマンドを使用する必要があります。

注記

Scalar Manager は Grafana の外部IPを検出して、そのIPに基づいて Grafana を埋め込もうとします。 そのため、Grafana のサービスタイプを LoadBalancer に設定し、外部 IP がブラウザからアクセス可能でなければなりません。

ステップ 5. Scalar Manager を削除する

1. scalar-manager をアンインストールします。

   helm uninstall scalar-manager