Deploy StarRocks with Docker
このクイックスタートチュートリアルでは、Docker を使用してローカルマシンに StarRocks をデプロイする手順を案内します。始める前に、StarRocks Architecture を読んで、概念的な詳細を確認することができます。
これらの手順に従うことで、1 つの FE ノードと 1 つの BE ノードを持つシンプルな StarRocks クラスターをデプロイできます。これにより、テーブルの作成 や データのロードとクエリ に関する今後のクイックスタートチュートリアルを完了し、StarRocks の基本操作に慣れることができます。
注意
このチュートリアルで使用されている Docker イメージを使用して StarRocks をデプロイするのは、小さなデータセットでデモを検証する必要がある場合にのみ適用されます。大規模なテストや本番環境には推奨されません。高可用性の StarRocks クラスターをデプロイするには、Deployment overview を参照して、あなたのシナリオに適した他のオプションを確認してください。
前提条件
Docker で StarRocks をデプロイする前に、以下の要件が満たされていることを確認してください。
-
ハードウェア
8 CPU コアと 16 GB 以上のメモリを持つマシンで StarRocks をデプロイすることを推奨します。
-
ソフトウェア
マシンに以下のソフトウェアがインストールされている必要があります。
- Docker Engine (17.06.0 以降)
- MySQL クライアント (5.5 以降)
ステップ 1: StarRocks Docker イメージをダウンロード
StarRocks Docker Hub から StarRocks Docker イメージをダウンロードします。イメージのタグに基づいて特定のバージョンを選択できます。
sudo docker run -p 9030:9030 -p 8030:8030 -p 8040:8040 \
-itd registry.starrocks.io/starrocks/allin1-ubuntu
トラブルシューティング
ホストマシン上の上記ポートのいずれかが占有されている場合、システムは "docker: Error response from daemon: driver failed programming external connectivity on endpoint tender_torvalds (): Bind for 0.0.0.0:xxxx failed: port is already allocated." と表示します。コマンド内のコロン (:) の前のポートを変更することで、ホストマシン上の利用可能なポートを割り当てることができます。
次のコマンドを実行して、コンテナが正しく作成され、実行されているかどうかを確認できます。
sudo docker ps
以下のように表示され、StarRocks コンテナの STATUS が Up であれば、Docker コンテナ内に StarRocks を正常にデプロイしたことになります。
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
8962368f9208 starrocks/allin1-ubuntu:branch-3.0-0afb97bbf "/bin/sh -c ./start_…" 4 minutes ago Up 4 minutes 0.0.0.0:8037->8030/tcp, :::8037->8030/tcp, 0.0.0.0:8047->8040/tcp, :::8047->8040/tcp, 0.0.0.0:9037->9030/tcp, :::9037->9030/tcp xxxxx
ステップ 2: StarRocks に接続
StarRocks が正常にデプロイされた後、MySQL クライアントを介して接続できます。
mysql -P9030 -h127.0.0.1 -uroot --prompt="StarRocks > "
注意
docker runコマンドで9030に異なるポートを割り当てた場合は、上記のコマンド内の9030を割り当てたポートに置き換える必要があります。
次の SQL を実行して、FE ノードのステータスを確認できます。
SHOW PROC '/frontends'\G
例:
StarRocks > SHOW PROC '/frontends'\G
*************************** 1. row ***************************
Name: 8962368f9208_9010_1681370634632
IP: 8962368f9208
EditLogPort: 9010
HttpPort: 8030
QueryPort: 9030
RpcPort: 9020
Role: LEADER
ClusterId: 555505802
Join: true
Alive: true
ReplayedJournalId: 99
LastHeartbeat: 2023-04-13 07:28:50
IsHelper: true
ErrMsg:
StartTime: 2023-04-13 07:24:11
Version: BRANCH-3.0-0afb97bbf
1 row in set (0.02 sec)
- フィールド
Aliveがtrueの場合、この FE ノードは正常に起動し、クラスターに追加されています。 - フィールド
RoleがFOLLOWERの場合、この FE ノードは Leader FE ノードとして選出される資格があります。 - フィールド
RoleがLEADERの場合、この FE ノードは Leader FE ノードです。
次の SQL を実行して、BE ノードのステータスを確認できます。
SHOW PROC '/backends'\G
例:
StarRocks > SHOW PROC '/backends'\G
*************************** 1. row ***************************
BackendId: 10004
IP: 8962368f9208
HeartbeatPort: 9050
BePort: 9060
HttpPort: 8040
BrpcPort: 8060
LastStartTime: 2023-04-13 07:24:25
LastHeartbeat: 2023-04-13 07:29:05
Alive: true
SystemDecommissioned: false
ClusterDecommissioned: false
TabletNum: 30
DataUsedCapacity: 0.000
AvailCapacity: 527.437 GB
TotalCapacity: 1.968 TB
UsedPct: 73.83 %
MaxDiskUsedPct: 73.83 %
ErrMsg:
Version: BRANCH-3.0-0afb97bbf
Status: {"lastSuccessReportTabletsTime":"2023-04-13 07:28:26"}
DataTotalCapacity: 527.437 GB
DataUsedPct: 0.00 %
CpuCores: 16
NumRunningQueries: 0
MemUsedPct: 0.02 %
CpuUsedPct: 0.1 %
1 row in set (0.00 sec)
フィールド Alive が true の場合、この BE ノードは正常に起動し、クラスターに追加されています。
Docker コンテナの停止と削除
クイックスタートチュートリアル全体を完了した後、StarRocks クラスターをホストしているコンテナをそのコンテナ ID で停止および削除できます。
注意
sudo docker psを実行して Docker コンテナのcontainer_idを取得できます。
次のコマンドを実行してコンテナを停止します。
# <container_id> を StarRocks クラスターのコンテナ ID に置き換えてください。
sudo docker stop <container_id>
コンテナが不要になった場合は、次のコマンドを実行して削除できます。
# <container_id> を StarRocks クラスターのコンテナ ID に置き換えてください。
sudo docker rm <container_id>
注意
コンテナの削除は不可逆です。削除する前に、コンテナ内の重要なデータのバックアップを確保してください。
次に行うこと
StarRocks をデプロイした後、テーブルの作成 や データのロードとクエリ に関するクイックスタートチュートリアルを続けることができます。
