バージョン: 3.4 (サポート外)

Helm Charts の入門 (Scalar Manager)

注記

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

Scalar Manager は、ユーザーに次のことを可能にする Web ベースのダッシュボードです。

Scalar 製品の健全性をチェックします
Scalar 製品を一時停止および一時停止解除して、基礎となるデータベースをバックアップまたは復元します
Grafana ダッシュボードを通じて Scalar 製品のメトリクスとログを確認します

ユーザーは、Scalar Manager を通じて Scalar 製品を一時停止または一時停止解除して、基礎となるデータベースをバックアップまたは復元できます。 Scalar Manager には、ユーザーが Scalar 製品のメトリクスやログを確認できる Grafana エクスプローラーも組み込まれています。

予測

このガイドは、ユーザーがモニタリングおよびロギングツールを備えた Scalar 製品を Kubernetes クラスターにデプロイする方法を理解していることを前提としています。まだの場合は、このガイドの前に Scalar Helm Charts の入門から始めてください。

要件

[GitHub Packages]GitHub Packages から Scalar Manager コンテナ (scalar-manager) をプルするには権限が必要です。
上記のコンテナをプルするには、GitHub ドキュメントに従って read:packages スコープの Github Personal Access Token (PAT) を作成する必要があります。

私たちが作るもの

次のように、次のコンポーネントを 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` をアップグレードします。

この値を kube-prometheus-stack のカスタム値ファイル (scalar-prometheus-custom-values.yaml など) に追加または修正します。
```
grafana:
  grafana.ini:
    security:
      allow_embedding: true
      cookie_samesite: disabled
```

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

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

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

scalar-manager のサンプルファイル scalar-manager-custom-values.yaml を取得します。
管理するターゲットを追加します。たとえば、台帳クラスターを管理する場合は、次のように値を追加できます。
```
scalarManager:
  targets:
    - name: my-ledgers-cluster
      adminSrv: _scalardl-admin._tcp.scalardl-headless.default.svc.cluster.local
      databaseType: cassandra
```
注記： adminSrv は、ポッドの SRV レコードを返す DNS サービス URL です。 Kubernetes は、Scalar 製品のヘッドレスサービスの名前付きポートに対してこの URL を作成します。形式は _{port name}._{protocol}.{service name}.{namespace}.svc.{cluster domain name} です。
Grafana URL を設定します。たとえば、kube-prometheus-stack の Grafana が localhost:3000 で公開されている場合、次のように設定できます。
```
scalarManager:
  grafanaUrl: "http://localhost:3000"
```
Scalar Manager が製品のステータスをチェックする更新間隔を設定します。デフォルト値は 30 秒ですが、次のように変更できます。
```
scalarManager:
  refreshInterval: 60 # one minute
```
Scalar Manager にアクセスするためのサービスタイプを設定します。デフォルト値は ClusterIP ですが、minikubetunnel コマンドや何らかのロードバランサを使ってアクセスする場合は、LoadBalancer として設定することができます。
```
service:
  type: LoadBalancer
```

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

GitHub パッケージから Scalar Manager コンテナイメージをプルするためのシークレットリソース reg-docker-secrets を作成します。

kubectl create secret docker-registry reg-docker-secrets --docker-server=ghcr.io --docker-username=<github-username> --docker-password=<github-personal-access-token>

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

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

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

minikubeを使用する場合

Scalar Manager のサービスリソースを localhost (127.0.0.1) として公開するには、別のターミナルを開き、minikube tunnel コマンドを実行します。
```
minikube tunnel
```
URL http://localhost:8000 でブラウザを開きます。

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

minikube 以外の Kubernetes クラスターを使用する場合は、各 Kubernetes クラスターの方式に従って LoadBalancer サービスにアクセスする必要があります。たとえば、クラウドサービスによって提供されるロードバランサーや kubectl port-forward コマンドを使用します。

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

scalar-manager をアンインストールします。
```
helm uninstall scalar-manager
```

予測​

要件​

私たちが作るもの​

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

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

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

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

minikubeを使用する場合​

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

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

予測

要件