TiUP共通操作

このドキュメントでは、 TiUP を使用して TiDB クラスターを運用および保守する場合の次の一般的な操作について説明します。

  • クラスターリストをビュー
  • クラスターを開始する
  • クラスターのステータスをビュー
  • 構成を変更する
  • クラスターを停止する
  • クラスターを破壊する

クラスターリストをビュー

TiUPクラスターコンポーネントを使用して、複数の TiDB クラスターを管理できます。 TiDB クラスターがデプロイされると、クラスターはTiUPクラスター リストに表示されます。

リストを表示するには、次のコマンドを実行します。

tiup cluster list

クラスターを開始する

TiDB クラスター内のコンポーネントは次の順序で開始されます。

PD > TiKV >Pump> TiDB > TiFlash >Drainer> TiCDC > Prometheus > Grafana > Alertmanager

クラスターを開始するには、次のコマンドを実行します。

tiup cluster start ${cluster-name}

注記:

${cluster-name}クラスターの名前に置き換えます。クラスター名を忘れた場合は、 tiup cluster listを実行して確認してください。

コマンドに-Rまたは-Nパラメータを追加することで、一部のコンポーネントのみを起動できます。例えば:

  • このコマンドは PDコンポーネントのみを開始します。

    tiup cluster start ${cluster-name} -R pd
  • このコマンドは、ホスト1.2.3.4とホスト1.2.3.5上の PD コンポーネントのみを起動します。

    tiup cluster start ${cluster-name} -N 1.2.3.4:2379,1.2.3.5:2379

注記:

-Rまたは-Nパラメータを使用して指定したコンポーネントを起動する場合は、起動順序が正しいことを確認してください。たとえば、TiKVコンポーネントの前に PDコンポーネントを開始します。そうしないと、起動に失敗する可能性があります。

クラスターのステータスをビュー

クラスターを起動した後、各コンポーネントのステータスをチェックして、それらが正常に動作していることを確認します。 TiUP はdisplayコマンドを提供するため、コンポーネントのステータスを表示するためにすべてのマシンにログインする必要はありません。

tiup cluster display ${cluster-name}

構成を変更する

クラスターの動作中にコンポーネントのパラメーターを変更する必要がある場合は、 edit-configコマンドを実行します。詳細な手順は次のとおりです。

  1. 編集モードでクラスターの構成ファイルを開きます。

    tiup cluster edit-config ${cluster-name}
  2. パラメータを設定します。

    • 構成がコンポーネントに対してグローバルに有効な場合は、 server_configsを編集します。

      server_configs: tidb: log.slow-threshold: 300
    • 構成が特定のノードで有効になる場合は、ノードのconfigで構成を編集します。

      tidb_servers: - host: 10.0.1.11 port: 4000 config: log.slow-threshold: 300

    パラメータの形式については、 TiUPパラメータテンプレートを参照してください。

    使用.構成アイテムの階層を表します

    コンポーネントの構成パラメータの詳細については、 TiDB config.toml.exampleTiKV config.toml.example 、およびPD config.toml.exampleを参照してください。

  3. reloadコマンドを実行して、構成をローリング更新し、対応するコンポーネントを再起動します。

    tiup cluster reload ${cluster-name} [-N <nodes>] [-R <roles>]

tidb-server でトランザクション サイズ制限パラメーター ( パフォーマンスモジュールのtxn-total-size-limit ) を1Gに設定する場合は、次のように構成を編集します。

server_configs: tidb: performance.txn-total-size-limit: 1073741824

次に、 tiup cluster reload ${cluster-name} -R tidbコマンドを実行して TiDBコンポーネントをローリング再起動します。

修正プログラムパッケージに置き換えます

通常のアップグレードについては、 TiUPを使用して TiDB をアップグレードするを参照してください。ただし、デバッグなどの一部のシナリオでは、現在実行中のコンポーネントを一時パッケージに置き換える必要がある場合があります。これを実現するには、 patchコマンドを使用します。

tiup cluster patch --help
Replace the remote package with a specified package and restart the service Usage: cluster patch <cluster-name> <package-path> [flags] Flags: -h, --help help for patch -N, --node strings Specify the nodes --overwrite Use this package in the future scale-out operations -R, --role strings Specify the role --transfer-timeout int Timeout in seconds when transferring PD and TiKV store leaders (default 600) Global Flags: --native-ssh Use the system's native SSH client --wait-timeout int Timeout of waiting the operation --ssh-timeout int Timeout in seconds to connect host via SSH, ignored for operations that don't need an SSH connection. (default 5) -y, --yes Skip all confirmations and assumes 'yes'

TiDB ホットフィックス パッケージが/tmp/tidb-hotfix.tar.gzにあり、クラスター内のすべての TiDB パッケージを置き換える場合は、次のコマンドを実行します。

tiup cluster patch test-cluster /tmp/tidb-hotfix.tar.gz -R tidb

クラスター内の TiDB パッケージを 1 つだけ置き換えることもできます。

tiup cluster patch test-cluster /tmp/tidb-hotfix.tar.gz -N 172.16.4.5:4000

クラスターの名前を変更する

クラスターをデプロイして開始した後、 tiup cluster renameコマンドを使用してクラスターの名前を変更できます。

tiup cluster rename ${cluster-name} ${new-name}

注記:

  • クラスターの名前を変更する操作により、監視システム (Prometheus および Grafana) が再起動されます。
  • クラスターの名前が変更された後、古いクラスター名の一部のパネルが Grafana 上に残る場合があります。手動で削除する必要があります。

クラスターを停止する

TiDB クラスター内のコンポーネントは次の順序で停止します (モニタリングコンポーネントも停止します)。

アラートマネージャー > Grafana > Prometheus > TiCDC >Drainer> TiFlash > TiDB >Pump> TiKV > PD

クラスターを停止するには、次のコマンドを実行します。

tiup cluster stop ${cluster-name}

startコマンドと同様に、 stopコマンドは-Rまたは-Nパラメータを追加することで一部のコンポーネントの停止をサポートします。例えば:

  • このコマンドは、TiDBコンポーネントのみを停止します。

    tiup cluster stop ${cluster-name} -R tidb
  • このコマンドは、ホスト1.2.3.4とホスト1.2.3.5上の TiDB コンポーネントのみを停止します。

    tiup cluster stop ${cluster-name} -N 1.2.3.4:4000,1.2.3.5:4000

クラスターデータのクリーンアップ

クラスター データのクリーンアップ操作では、すべてのサービスが停止され、データ ディレクトリまたはログ ディレクトリ、あるいはその両方がクリーンアップされます。操作を元に戻すことはできないため、注意して続行してください。

  • クラスター内のすべてのサービスのデータをクリーンアップしますが、ログは保持します。

    tiup cluster clean ${cluster-name} --data
  • クラスター内のすべてのサービスのログをクリーンアップしますが、データは保持します。

    tiup cluster clean ${cluster-name} --log
  • クラスター内のすべてのサービスのデータとログをクリーンアップします。

    tiup cluster clean ${cluster-name} --all
  • Prometheus を除くすべてのサービスのログとデータをクリーンアップします。

    tiup cluster clean ${cluster-name} --all --ignore-role prometheus
  • 172.16.13.11:9000インスタンスを除くすべてのサービスのログとデータをクリーンアップします。

    tiup cluster clean ${cluster-name} --all --ignore-node 172.16.13.11:9000
  • 172.16.13.12ノードを除くすべてのサービスのログとデータをクリーンアップします。

    tiup cluster clean ${cluster-name} --all --ignore-node 172.16.13.12

クラスターを破壊する

破棄操作によりサービスが停止され、データ ディレクトリとデプロイメント ディレクトリがクリアされます。操作を元に戻すことはできないため、注意して続行してください。

tiup cluster destroy ${cluster-name}

このページは役に立ちましたか?