重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

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コマンドを実行します。詳細な手順は次のとおりです。

編集モードでクラスターの構成ファイルを開きます。
```
tiup cluster edit-config ${cluster-name}
```
パラメータを設定します。
- 構成がコンポーネントに対してグローバルに有効な場合は、 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.example 、 TiKV config.toml.example 、およびPD config.toml.exampleを参照してください。
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}