tdc から TiDB Cloud CLI への移行
この移行は、以前に tdc v0.1.x を使用していた場合にのみ適用されます。新規の TiDB Cloud CLI インストールでは、この作業は不要です。
開始前に
tdcによって開始されたすべての Filesystem マウントおよび Vault マウントをアンマウントし、書き込みプロセスを停止します。古いマウントがまだアクティブな場合、実行中の FUSE または WebDAV プロセスを移行できないため、移行は停止します。アクティブな各マウントに対応するコマンドを実行してください。FUSE Filesystem マウントの場合は、まず
drain-file-systemを実行して保留中の書き込みをフラッシュし、その後unmount-file-systemを実行してマウントを切り離します。WebDAV Filesystem マウントの場合は、書き込みプロセスを停止し、unmount-file-systemのみを実行します。Vault マウントではunmount-vaultのみが必要です。# FUSE Filesystem mount tdc fs drain-file-system --mount-path <filesystem-mount-path> tdc fs unmount-file-system --mount-path <filesystem-mount-path> # WebDAV Filesystem mount tdc fs unmount-file-system --mount-path <filesystem-mount-path> # Vault mount tdc fs-vault unmount-vault --mount-path <vault-mount-path>ディレクトリの競合を解決する前に、
~/.tdc/と既存の~/.ti/ディレクトリをバックアップしてください。
ti をインストールしてローカル状態を移行する
古い tdc update コマンドでは、名前が変更された ti 実行ファイルをインストールできず、ti も tdc コマンドエイリアスを提供しません。TiDB Cloud CLI をインストールする に従って、ti を直接インストールしてください。
~/.tdc/ が存在し、~/.ti/ が存在しない場合、インストーラーおよび最初の update 以外の ti コマンドは、サポートされているローカル状態を自動的に移行します。移行では、ロールバック用コピーとして ~/.tdc/ を保持し、移行完了を記録するための所有者専用マーカーを ~/.ti/ 配下に作成します。
次の表は、どの状態が移行されるかをまとめたものです。
インストール後、新しい実行ファイルを確認し、使用しているリソースに対して読み取り専用コマンドを実行してください。例:
ti --version
# For TiDB Cloud Starter
ti db list-db-clusters --db-cluster-type starter --output text
# For TiDB Cloud Filesystem
ti fs list-file-systems --output text
移行を確認した後、ロールバック用コピーが不要になれば、古い tdc バイナリとローカル状態を削除できます。
ローカル状態の競合を解決する
~/.tdc/ と ~/.ti/ がそれぞれ独立して作成されていた場合、または移行マーカーが存在しない、無効である、あるいは別のソースを参照している場合、ti はどちらのディレクトリもマージまたは上書きせずに停止します。
どちらのディレクトリを正しいソースオブトゥルースとするかを判断し、もう一方のディレクトリをバックアップ場所へ移動してください。その後、インストーラーまたは ti コマンドを再度実行します。認証情報や Filesystem レジストリディレクトリを手動で結合しないでください。
環境変数を更新する
自動化で使用する環境変数名を、次のように更新してください。
v0.2.x の移行期間中、ti は対応する新しい変数が設定されていない場合にのみ、従来の TDC_* 環境変数を受け入れます。両方の形式が異なる値で設定されている場合、コマンドはローカルまたはリモートの状態を変更する前に失敗します。従来の TDC_* 変数のサポートは v0.3.0 で削除されます。