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