FQDN

この記事では、FQDN（Fully Qualified Domain Name）に基づくApache Dorisの使用を有効にする方法を紹介します。FQDNは、インターネット上の特定のコンピューターまたはホストの完全なドメイン名です。

DorisがFQDNをサポートした後、ノード間の通信は完全にFQDNに基づいて行われます。さまざまなタイプのノードを追加する際は、FQDNを直接指定する必要があります。例えば、BEノードを追加するコマンドはALTER SYSTEM ADD BACKEND "be_host:heartbeat_service_port"で、be_hostは以前はBEノードのIPアドレスでした。FQDNを開始した後、be_hostはBEノードのFQDNを指定する必要があります。

前提条件

fe.confファイルでenable_fqdn_mode = trueを設定する。
クラスター内のすべてのマシンにホスト名を設定する必要がある。
クラスター内の各マシンの/etc/hostsファイルに、クラスター内の他のマシンに対応するIPアドレスとFQDNを指定する必要がある。
/etc/hostsファイルに重複するIPアドレスがあってはならない。

ベストプラクティス

新しいクラスターでFQDNを有効にする

マシンを準備します。例えば、3FE 3BEのクラスターをデプロイしたい場合は、6台のマシンを準備できます。
各マシンでhostを実行した時に一意の結果が返されるようにします。6台のマシンの実行結果がそれぞれfe1、fe2、fe3、be1、be2、be3であると仮定します。
6台のマシンの/etc/hostsに6つのFQDNに対応する実際のIPを設定します。例えば：
```
172.22.0.1 fe1
172.22.0.2 fe2
172.22.0.3 fe3
172.22.0.4 be1
172.22.0.5 be2
172.22.0.6 be3
```
検証: FE1で 'ping fe2' を実行でき、正しいIPアドレスを解決してpingできることで、ネットワーク環境が利用可能であることを示しています。
各FEノードのfe.conf設定 enable_ fqdn_ mode = true。
Standard deploymentを参照してください
必要に応じて6台のマシンにbrokerをデプロイするために複数のマシンを選択し、ALTER SYSTEM ADD BROKER broker_name "fe1:8000","be1:8000",...;を実行します。

K8S用Dorisのデプロイメント

Podの予期しない再起動後、K8sはPodのIPが変更されないことを保証できませんが、ドメイン名が変更されないことは保証できます。この機能に基づいて、DorisがFQDNを有効にすると、予期しない再起動後もPodが正常にサービスを提供できることを保証できます。

K8sでDorisをデプロイする方法についてはKubernetes Deploymentを参照してください

サーバーのIP変更

'新しいクラスターでFQDNを有効にする'に従ってクラスターをデプロイした後、マシンのIPを変更したい場合は、ネットワークカードの切り替えやマシンの交換に関係なく、各マシンの'/etc/hosts'を変更するだけです。

既存クラスターでFQDNを有効にする

前提条件: 現在のプログラムがALTER SYSTEM MODIFY FRONTEND "<fe_ip>:<edit_log_port>" HOSTNAME "<fe_hostname>"構文をサポートしている。サポートしていない場合は、この構文をサポートするバージョンにアップグレードしてください

注意してください。

以下の操作を実行するには少なくとも3つのfollowerが必要です。そうでなければクラスターが正常に起動しない可能性があります

次に、以下の手順に従ってください：

FollowerとObserverノードで順番に以下の操作を実行します（最後にMasterノードで実行）：
1. ノードを停止します。
2. ノードが停止したことを確認します。MySQLクライアント経由で'show frontends'を実行してFEノードのAliveステータスがfalseになるまで確認します
3. ノードにFQDNを設定します: ALTER SYSTEM MODIFY FRONTEND "<fe_ip>:<edit_log_port>" HOSTNAME "<fe_hostname>"（masterを停止した後、新しいmasterノードが選択されてSQL文の実行に使用されます）
4. ノード設定を変更します。FEルートディレクトリの'conf/fe.conf'ファイルを変更し、設定を追加します: enable_fqdn_mode = true。対応するfe.configに設定を追加した後、新しく停止したノードが正常に起動できない場合は、停止したfeノードを起動する前に、すべてのfe.configに設定'enable_fqdn_mode=true'を追加してください。
5. ノードを起動します。
BEノードでFQDNを有効にするには、MySQL経由で以下のコマンドを実行するだけで、BEを再起動する必要はありません。

ALTER SYSTEM MODIFY BACKEND "<backend_ip>:<HeartbeatPort>" HOSTNAME "<be_hostname>"、HeartbeatPortの番号がわからない場合は、show backendsコマンドを使用してこのポートを見つけてください。

よくある問題

設定項目enable_ fqdn_ modeは自由に変更できますか？

任意に変更することはできません。この設定を変更するには、'既存クラスターでFQDNを有効にする'手順に従ってください。

前提条件​

ベストプラクティス​

新しいクラスターでFQDNを有効にする​

K8S用Dorisのデプロイメント​

サーバーのIP変更​

既存クラスターでFQDNを有効にする​

よくある問題​