📣
TiDB Cloud Essential はパブリックプレビュー中です。このページは自動翻訳されたものです。原文はこちらからご覧ください。
TiDB Cloud
TiDB Self-Managed
Learning Center
お問い合わせ

TiUPコマンドを使用してTiUPコンポーネントを管理する

次のTiUPコマンドを使用して、 TiUPエコシステム内のコンポーネントを管理できます。

  • list:コンポーネントリストを照会します。このTiUPコマンドを使用すると、インストールするすべてのオプションコンポーネントと、各コンポーネントのすべてのオプションバージョンを確認できます。
  • install:コンポーネントの特定のバージョンをインストールします。
  • update:コンポーネントを最新バージョンに更新します。
  • uninstall:コンポーネントをアンインストールします。
  • status: 実行中のコンポーネントのステータスを確認します。
  • clean:コンポーネントがデプロイされているインスタンスをクリーンアップします。
  • help: ヘルプ情報を出力します。このコマンドに別のTiUPコマンドを追加すると、追加したコマンドの使用方法が表示されます。
  • link:コンポーネントのバイナリを実行可能ディレクトリ（ $TIUP_HOME/bin/ ）にリンクします。
  • unlink: tiup linkコマンドによって生成されたソフト リンクを削除します。

このドキュメントでは、一般的なコンポーネント管理操作と対応するTiUPコマンドについて説明します。

コンポーネントリストを照会する

tiup listコマンドを使用してコンポーネントリストを照会できます。このコマンドの使用方法は以下のとおりです。

  • tiup list : インストールできるコンポーネントを確認します。
  • tiup list ${component} : 特定のコンポーネントのどのバージョンをインストールできるかを確認します。

上記のコマンドでは次のフラグを使用することもできます。

  • --installed : ローカルにインストールされているコンポーネントまたは特定のコンポーネントのどのバージョンかを確認します。 - --all : 非表示のコンポーネントも含め、すべてのコンポーネントを表示します - --verbose : すべての列を表示します (インストールされているバージョンとサポートされているプラットフォームを含む)

例 1: 現在インストールされているすべてのコンポーネントをビュー。

tiup list --installed

例 2:サーバーからインストール可能なすべてのバージョンの TiKVコンポーネントのリストを取得します。

tiup list tikv

コンポーネントをインストールする

tiup installコマンドを使用してコンポーネントリストを照会できます。このコマンドの使用方法は以下のとおりです。

  • tiup install <component> : 指定されたコンポーネントの最新の安定バージョンをインストールします。
  • tiup install <component>:[version] : 指定されたコンポーネントの指定されたバージョンをインストールします。

例 1: TiUPを使用して、TiDB の最新の安定バージョンをインストールします。

tiup install tidb

例 2: TiUPを使用して、TiDB のナイトリー バージョンをインストールします。

tiup install tidb:nightly

例 3: TiUPを使用して TiKV v8.5.3 をインストールします。

tiup install tikv:v8.5.3

アップグレードコンポーネント

コンポーネントの新しいバージョンが公開された後、 tiup updateコマンドを使用してこのコンポーネントをアップグレードできます。このコマンドの使用方法は、以下のフラグを除いて、基本的にtiup installコマンドと同じです。

  • --all : すべてのコンポーネントをアップグレードします。
  • --nightly : ナイトリーバージョンにアップグレードします。
  • --self : TiUP自体を最新バージョンにアップグレードします。
  • --force : 強制的に最新バージョンにアップグレードします。

例 1: すべてのコンポーネントを最新バージョンにアップグレードします。

tiup update --all

例 2: すべてのコンポーネントをナイトリー バージョンにアップグレードします。

tiup update --all --nightly

例 3: TiUP を最新バージョンにアップグレードします。

tiup update --self

コンポーネントを操作する

インストールが完了したら、 tiup <component>コマンドを使用して対応するコンポーネントを起動できます。

tiup [flags] <component>[:version] [args...]

Flags:
  -T, --tag string                     Specifies the tag for the component instance.

このコマンドを使用するには、コンポーネント名とオプションのバージョンを指定する必要があります。バージョンを指定しない場合は、このコンポーネントの最新の安定バージョン（インストール済み）が使用されます。

コンポーネントが起動する前に、 TiUP はコンポーネント用のディレクトリを作成し、そのディレクトリにコンポーネントを配置して操作を行います。コンポーネントはこのディレクトリ内にすべてのデータを生成し、このディレクトリの名前はコンポーネント操作時に指定されたタグ名になります。タグが指定されていない場合は、ランダムにタグ名が生成されます。この作業ディレクトリは、インスタンスの終了時に自動的に削除されます。

同じコンポーネントを複数回起動し、前回の作業ディレクトリを再利用したい場合は、コンポーネント起動時に同じ名前のタグ--tag指定することで、タグを1つ指定できます。タグを指定すると、インスタンス終了時に作業ディレクトリが自動的に削除されなくなり、作業ディレクトリの再利用が容易になります。

例 1: TiDB v8.5.3 を操作します。

tiup tidb:v8.5.3

例 2: TiKV が動作するタグを指定します。

tiup --tag=experiment tikv

コンポーネントの動作状態を照会する

tiup statusコマンドを使用して、コンポーネントの動作状態を確認できます。

tiup status

このコマンドを実行すると、インスタンスのリストが1行に1つずつ表示されます。リストには以下の列が含まれます。

  • Name : インスタンスのタグ名。
  • Component : インスタンスのコンポーネント名。
  • PID : 動作中のインスタンスのプロセス ID。
  • Status : インスタンスのステータス。2 RUNNINGインスタンスが動作中であることを意味します。4 TERMインスタンスが終了していることを意味します。
  • Created Time : インスタンスの開始時刻。
  • Directory : インスタンスの作業ディレクトリ--tagを使用して指定できます。
  • Binary : インスタンスの実行可能プログラム--binpathを使用して指定できます。
  • Args : 操作インスタンスの引数。

クリーンなコンポーネントインスタンス

tiup cleanコマンドを使用すると、コンポーネントインスタンスをクリーンアップし、作業ディレクトリを削除できます。クリーンアップ前にインスタンスがまだ動作している場合は、まず関連プロセスが強制終了されます。コマンドの使用方法は以下のとおりです。

tiup clean [tag] [flags]

次のフラグがサポートされています:

  • --all : すべてのインスタンス情報をクリーンアップします。

上記のコマンドでは、 tagクリーンアップするインスタンスタグです。3 --all使用すると、タグは渡されません。

例 1: experimentタグ名を持つコンポーネントインスタンスをクリーンアップします。

tiup clean experiment

例 2: すべてのコンポーネントインスタンスをクリーンアップします。

tiup clean --all

コンポーネントをアンインストールする

TiUPを使用してインストールされたコンポーネントは、ローカルディスクの容量を消費します。古いバージョンのコンポーネントをあまり多く残したくない場合は、現在インストールされているコンポーネントのバージョンを確認し、そのコンポーネントをアンインストールしてください。

tiup uninstallコマンドを使用すると、コンポーネントのすべてのバージョンまたは特定のバージョンをアンインストールできます。このコマンドは、すべてのコンポーネントのアンインストールもサポートしています。コマンドの使用方法は次のとおりです。

tiup uninstall [component][:version] [flags]

このコマンドでは次のフラグがサポートされています。

  • --all : すべてのコンポーネントまたはバージョンをアンインストールします。
  • --self : TiUP自体をアンインストールします。

componentはアンインストールするコンポーネントです。2 versionアンインストールするバージョンです。8 tiup uninstallでは、 componentとversionどちらも無視できます。どちらか一方を無視する場合は、 --allフラグを追加する必要があります。

  • バージョンを無視する場合、 --allを追加すると、このコンポーネントのすべてのバージョンがアンインストールされます。
  • バージョンとコンポーネントの両方が無視される場合、 --all追加すると、すべてのバージョンのすべてのコンポーネントがアンインストールされます。

例 1: TiDB v8.5.3 をアンインストールします。

tiup uninstall tidb:v8.5.3

例 2: すべてのバージョンの TiKV をアンインストールします。

tiup uninstall tikv --all

例 3: インストールされているすべてのコンポーネントをアンインストールします。

tiup uninstall --all

TiUP v1.13.0では、コンポーネントのバイナリを実行ディレクトリ（ $TIUP_HOME/bin/ ）にリンクし、リンクを解除する実験的コマンドlinkとunlink追加されました。この機能により、異なるバージョン間の切り替え機能を維持しながら、毎回TiUPを経由することなくコンポーネントを呼び出すことができます。ただし、この方法では自動更新チェックや特定の環境変数の設定といったプロセスが欠如しており、一部のコンポーネント（ctlなど）は使用できません。そのため、必要な場合にのみ使用することをお勧めします。

例1: クラスタコンポーネントの最新バージョンをインストールしてリンクする

tiup install cluster
tiup link cluster

例2: クラスターコンポーネントをバージョンv1.13.0に切り替える

tiup link cluster:v1.13.0

以下はコマンドtiup link clusterの出力です。

package cluster provides these executables: tiup-cluster

これは、クラスターコンポーネントのバイナリ名がtiup-clusterあることを示しています。リンクコマンドが完了したら、コマンドラインにtiup-cluster直接入力することで、クラスターコンポーネントを使用できます。

例3: クラスタコンポーネントのリンクを解除する

tiup unlink cluster

例4: TiUPのバージョンを管理する

v1.13.0より前は、 TiUPは~/.tiup/bin/にインストールされており、異なるバージョンは共存できません。v1.13.0以降では、他のコンポーネントと同様にTiUPをインストールしてリンクできます。

tiup update --self # update tiup itself to a version that supports link
tiup link tiup:v1.13.0

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