Launcher サービスのインストール設定¶
製品概要¶
Guance をデプロイしてインストールするための WEB アプリケーションです。Launcher サービスのガイド手順に従って、Guance のインストールとアップグレードを実行します。
キーワード¶
| 用語 | 説明 |
|---|---|
| Launcher | Guance をデプロイしてインストールするための WEB アプリケーションです。Launcher サービスのガイド手順に従って、Guance のインストールとアップグレードを実行します。 |
| オペレーション用マシン | kubectl がインストールされており、対象の Kubernetes クラスターと同じネットワーク上にある運用マシンです。 |
| インストール用マシン | ブラウザで launcher サービスにアクセスし、Guance のガイド付きインストールを実行するマシンです。 |
| hosts ファイル | hosts ファイルは拡張子を持たないシステムファイルです。主にドメイン名と IP のマッピング関係を保存する役割を持ちます。 |
前提条件¶
インフラストラクチャのデプロイ が完了していること。
1. Launcher のインストール¶
注意
Launcher をデプロイする際は、RBAC 権限が cluster-admin であることを確認してください。そうでない場合、Launcher のデプロイ中にエラーが発生します。
オフラインネットワーク環境の場合は、Guance オフラインパッケージのダウンロードとインポート を参照してデプロイしてください。
GuanceDB エンジンは、GuanceDB 2.0 または GuanceDB 3.0 と GuanceDB for Mertics への同時書き込みをサポートしています。
- インストール
helm install launcher launcher --repo https://pubrepo.guance.com/chartrepo/launcher -n launcher \
--create-namespace \
--set ingress.hostName=<Hostname>,storageClassName=<Stroageclass>
注意
<Hostname> は Launcher ingress のドメイン名、<Stroageclass> はストレージクラス名です。kubectl get sc を実行して取得できます。
- Launcher のアンインストール
注意
Launcher が正常にインストールされた後は、異常時以外はアンインストールしないでください。
- YAML インストール
Launcher YAML のダウンロード:https://static.guance.com/launcher/launcher.yaml
上記の YAML の内容を launcher.yaml ファイルとして保存し、オペレーション用マシンに配置します。その後、ドキュメント内の変数部分を置き換えます:
- {{ launcher_image }} は最新版の Launcher アプリケーションのイメージアドレスに置き換えます。最新バージョンの Launcher インストールイメージアドレスは デプロイイメージ のドキュメントから取得できます。
- {{ domain }} はメインドメインに置き換えます。例: dataflux.cn
- {{ storageClassName }} はストレージクラス名に置き換えます。例: alicloud-nas
デフォルトの storageclass を設定したリソースには defalut と表示されます。下図を参照してください:
オペレーション用マシンで以下の kubectl コマンドを実行し、Launcher サービスをインポートします:
- YAML アンインストール
注意
Launcher が正常にインストールされた後は、異常時以外はアンインストールしないでください。
2. launcher ドメインを launcher サービスに解決する¶
launcher サービスは Guance のデプロイとアップグレードに使用するため、ユーザーに公開する必要はありません。そのため、ドメインをパブリックネットワーク上で解決せず、インストール用マシンで hosts をバインドしてドメイン解決をシミュレートできます。/etc/hosts に poc-launcher.dataflux.cn のドメインバインドを追加してください。
3. アプリケーションのインストールガイド手順¶
インストール用マシンのブラウザで poc-launcher.dataflux.cn にアクセスし、ガイド手順に従ってインストール設定を進めてください。
3.1 データベース設定¶
- データベース接続アドレスは必ずプライベートネットワークアドレスを使用してください。
- 複数の子アプリケーションのデータベースとデータベースアクセスアカウントを初期化するためにこのアカウントが必要なため、必ず管理者アカウントを使用してください。
3.2 キャッシュサービスの設定¶
- 有効にしないこともできます。有効にしない場合は、デフォルトのキャッシュサービスが使用されます。
- 有効にする場合は、Redis 接続アドレスを入力してください。スタンドアロンモード、プロキシモード、およびマスタースレーブモードの Redis クラスターバージョンをサポートしています。
3.3 時系列エンジンの設定¶
- GuanceDB の insert と select を入力します。
3.4 ログエンジンの設定¶
3.5 その他の設定¶
- Guance 管理バックエンドの管理者アカウントの初期アカウント名とメールアドレス
- クラスターノードのプライベートネットワーク IP(自動取得されます。正しいか確認してください)
- メインドメインと各子アプリケーションのサブドメイン設定。デフォルトのサブドメインは以下のとおりです。必要に応じて変更できます:
- dataflux 【ユーザーフロントエンド】
- df-api 【ユーザーフロントエンド API】
- df-management 【管理バックエンド】
- df-management-api 【管理バックエンド API】
- df-websocket 【Websocket サービス】
- df-func 【Func プラットフォーム】
- df-openapi 【API サービス】
- df-external-api 設定 API】
- df-urls ドメイン一覧サービス】
- df-static-res 【静的リソースサイト】
- df-kodo 【kodo】(DataWay をホストにデプロイする場合に使用します。コンテナで DataWay をデプロイする場合は解決しないでください)
3.6 インストール情報¶
直前に入力した情報がまとめて表示されます。入力内容に誤りがある場合は、前の手順に戻って修正できます。
3.7 アプリケーション設定ファイル¶
インストーラーは、前の手順で入力したインストール情報に基づいてアプリケーション設定テンプレートを自動的に初期化しますが、すべてのアプリケーションテンプレートを個別に確認し、アプリケーションごとの設定を変更する必要があります。具体的な設定の説明はインストール画面を参照してください。
問題がなければ、設定ファイルの作成を送信します。
3.8 アプリケーションイメージ¶
- 正しい共有ストレージ、つまり前の手順で作成した ストレージクラス 名を選択してください。
- アプリケーションイメージは選択した Launcher バージョンに基づいて自動的に入力されるため、変更は不要です。問題がなければ アプリケーションの作成 を開始します。
3.9 アプリケーションの状態¶
ここには、すべてのアプリケーションサービスの起動状態が一覧表示されます。このプロセスではすべてのイメージをダウンロードする必要があるため、数分から十数分かかる場合があります。すべてのサービスが正常に起動したら、インストール成功です。
注意:サービスの起動中は、このページを閉じずにそのままにしてください。最後に「バージョン情報の書き込みに成功しました」というメッセージが表示され、エラーウィンドウが表示されなければ、インストール成功です。
3.10 ドメイン解決¶
df-kodo.dataflux.cn 以外のすべてのサブドメインを、SLB のパブリック IP アドレスまたはエッジノードの ingress アドレスに解決します:
- dataflux.dataflux.cn
- df-api.dataflux.cn
- df-management.dataflux.cn
- df-management-api.dataflux.cn
- df-openapi.dataflux.cn
- df-func.dataflux.cn
- df-external-api.dataflux.cn
- df-static-res.dataflux.cn
4. DataWay のインストール(オプション)¶
デプロイが成功したら、DataWay をインストールできます。右上隅の「設定」をクリックし、【データゲートウェイのインストール】を選択してください。
DataWay 名とバインドアドレスを入力し、【ワンクリックインストール】をクリックします。インストールが成功すると、プロンプトが表示されます。
他の方法で DataWay をインストール することもできます。
5. インストール完了後¶
デプロイが成功したら、アクティベーションが必要です。マニュアル 使用を開始する を参照してください。
インストール中に問題が発生し、再インストールが必要な場合は、マニュアル メンテナンスマニュアル を参照してください。
6. 非常に重要な手順!!!¶
上記の手順により、Guance のインストールが完了し、検証できます。検証に問題がないことを確認した後の非常に重要な手順として、誤ってアクセスされてアプリケーション設定が壊れないよう、launcher サービスを停止してください。オペレーション用マシンで以下のコマンドを実行し、launcher サービスの pod レプリカ数を 0 に設定します:















