メインコンテンツまでスキップ

Deploy StarRocks with Helm

Helmを使用してStarRocksをデプロイする

HelmはKubernetes用のパッケージ管理ツールです。Helm ChartはHelmパッケージで、Kubernetesクラスター上でアプリケーションを実行するために必要なすべてのリソース定義を含んでいます。このトピックでは、Helmを使用してStarRocksクラスターをKubernetesクラスター上に自動的にデプロイする方法について説明します。

開始する前に

手順

  1. StarRocksのHelm Chartリポジトリを追加します。Helm Chartには、StarRocks OperatorとカスタムリソースであるStarRocksClusterの定義が含まれています。

    1. Helm Chartリポジトリを追加します。

      helm repo add starrocks-community https://starrocks.github.io/starrocks-kubernetes-operator
    2. Helm Chartリポジトリを最新バージョンに更新します。

      helm repo update
    3. 追加したHelm Chartリポジトリを表示します。

      $ helm search repo starrocks-community
      NAME CHART VERSION APP VERSION DESCRIPTION
      starrocks-community/kube-starrocks 1.8.0 3.1-latest kube-starrocks includes two subcharts, starrock...
      starrocks-community/operator 1.8.0 1.8.0 A Helm chart for StarRocks operator
      starrocks-community/starrocks 1.8.0 3.1-latest A Helm chart for StarRocks cluster
  2. デフォルトの values.yaml を使用してStarRocks OperatorとStarRocksクラスターをデプロイするか、YAMLファイルを作成してデプロイの設定をカスタマイズします。デプロイには時間がかかります。この期間中、デプロイコマンドの結果でプロンプトコマンドを使用してデプロイのステータスを確認できます。デフォルトのプロンプトコマンドは次のようになります。

    $ kubectl --namespace default get starrockscluster -l "cluster=kube-starrocks"
    # 以下の結果が返された場合、デプロイが正常に完了しています。
    NAME FESTATUS CNSTATUS BESTATUS
    kube-starrocks running running

    デプロイのステータスを確認するには、kubectl get podsを実行することもできます。すべてのPodがRunningの状態にあり、Pod内のすべてのコンテナがREADYであれば、デプロイが正常に完了しています。

    $ kubectl get pods
    NAME READY STATUS RESTARTS AGE
    kube-starrocks-be-0 1/1 Running 0 2m50s
    kube-starrocks-fe-0 1/1 Running 0 4m31s
    kube-starrocks-operator-69c5c64595-pc7fv 1/1 Running 0 4m50s
    1. デフォルトの設定でデプロイする以下のコマンドを実行して、StarRocks Operatorと1つのFEと1つのBEから構成されるStarRocksクラスターをデプロイします。

      $ helm install starrocks starrocks-community/kube-starrocks
      # 以下の結果が返された場合、StarRocks OperatorとStarRocksクラスターがデプロイされています。
      NAME: starrocks
      LAST DEPLOYED: Tue Aug 15 15:12:00 2023
      NAMESPACE: starrocks
      STATUS: deployed
      REVISION: 1
      TEST SUITE: None
    2. カスタム設定でデプロイする

      • 例えば、my-values.yamlという名前のYAMLファイルを作成し、YAMLファイルでStarRocks OperatorとStarRocksクラスターの設定をカスタマイズします。サポートされているパラメータとその説明については、Helm Chartのデフォルトの values.yaml のコメントを参照してください。
      • 以下のコマンドを実行して、my-values.yamlのカスタム設定を使用してStarRocks OperatorとStarRocksクラスターをデプロイします。
        helm install -f my-values.yaml starrocks starrocks-community/kube-starrocks

次のステップ

  • StarRocksクラスターへのアクセスStarRocksクラスターにはKubernetesクラスター内外からアクセスできます。詳細な手順については、StarRocksクラスターへのアクセスを参照してください。
  • StarRocks OperatorとStarRocksクラスターの管理
    • StarRocks OperatorとStarRocksクラスターの設定を更新する必要がある場合は、Helm Upgradeを参照してください。
    • StarRocks OperatorとStarRocksクラスターをアンインストールするには、次のコマンドを実行します。
      helm uninstall starrocks
  • StarRocksがメンテナンスしているHelm Chartの検索kube-starrocksを参照してください。