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