目次
この記事では主に、MySQL HA (High Availability) データベースの高可用性ツール Orchestrator をローカルにインストールする方法を紹介します。
1. インストールパッケージをダウンロードする
ダウンロードアドレス
次に、インストールパッケージを解凍します
たとえば、オーケストレーターをディレクトリ /usr/local/orchestrator にインストールします。
mkdir -p /usr/local
cd /usr/local
tar xzfv orchestrator-1.0.tar.gz
2. バックエンド MySQL サーバーをインストールする
オーケストレーターはバックエンド データベースを使用して、検出されるインスタンス、クラスター名などのメタ情報を保存します。
この記事では、MySQL サーバーをバックエンドとして使用します。
まず MySQL サーバーをインストールします。公式ドキュメントを参照してください。
インストールが完了したら、バックエンドにアクセスするためのユーザーを作成します。
CREATE DATABASE IF NOT EXISTS orchestrator;
CREATE USER 'orchestrator'@'127.0.0.1' IDENTIFIED BY 'orch_backend_password';
GRANT ALL PRIVILEGES ON `orchestrator`.* TO 'orchestrator'@'127.0.0.1';
Orchestrator使用される構成ファイルは /etc/orchestrator.conf.json、実行可能ファイルのディレクトリconf/orchestrator.conf.jsonまたはorchestrator.conf.json
インストール パッケージに付属しておりorchestrator.conf.json.sample、次のパスにあります。/usr/local/orchestrator/orchestrator-sample.conf.json
このファイルを参照して、構成ファイルの内容をカスタマイズできます。公式ウェブサイトのリンクも参照できます。
設定内容を次のように変更します。
...
"MySQLOrchestratorHost": "127.0.0.1",
"MySQLOrchestratorPort": 3306,
"MySQLOrchestratorDatabase": "orchestrator",
"MySQLOrchestratorUser": "orchestrator",
"MySQLOrchestratorPassword": "orch_backend_password",
...
3. MySQL インスタンスでの承認
Orchestrator は MySQL インスタンスのレプリケーション トポロジを検出し、いくつかの権限を必要とします。
CREATE USER 'orchestrator'@'orch_host' IDENTIFIED BY 'orch_topology_password';
GRANT SUPER, PROCESS, REPLICATION SLAVE, RELOAD ON *.* TO 'orchestrator'@'orch_host';
GRANT SELECT ON mysql.slave_master_info TO 'orchestrator'@'orch_host';
GRANT SELECT ON ndbinfo.processes TO 'orchestrator'@'orch_host'; -- Only for NDB Cluster
必要に応じて、 、などのorch_host適切なマシンに置き換えます。%10.%xx.xx.xx.xx
そしてorchestrator.conf.json、ファイル内で以下を変更します。
"MySQLTopologyUser": "orchestrator",
"MySQLTopologyPassword": "orch_topology_password",
4. オーケストレーター サービスを開始します
オーケストレーターのインストール ディレクトリが存在する場合は/usr/local/orchestrator、次のコマンドを実行します。
cd /usr/local/orchestrator && ./orchestrator http
オーケストレーター サービスが開始されると、ポート 3000 でリッスンします。
ブラウザでページを開くhttp://your.host:3000/
サービスをローカルで開始する場合は、次を使用できますhttp://127.0.0.1:3000/
デバッグ情報が必要な場合は、次を実行できます。
cd /usr/local/orchestrator && ./orchestrator --debug http
さらに詳しいデバッグ情報を得るには、次のコマンドを実行できます。
cd /usr/local/orchestrator && ./orchestrator --debug --stack http
上記の起動方法で、パラメータに設定ファイルが指定されていない場合、設定ファイルは次の場所にあります:
/etc/orchestrator.conf.json、conf/orchestrator.conf.json、orchestrator.conf.json。
特定の構成ファイルを指定することもできます。
cd /usr/local/orchestrator && ./orchestrator --debug --config=/path/to/config.file http
ローカル コードに基づいてデバッグしている場合は、次を実行できます。
go run go/cmd/orchestrator/main.go http
以上、この記事ではOrchestratorをローカルにインストールして使用する方法を中心に紹介しましたが、本番環境へのインストールについては、後ほど時間があるときに紹介したいと思います。