プライベートミラーを作成する
プライベート クラウドを作成する場合、通常は、 TiUPの公式ミラーにアクセスできない、隔離されたネットワーク環境を使用する必要があります。したがって、プライベート ミラーを作成できます。これは主にmirror
コマンドによって実装されます。オフライン展開にはmirror
コマンドを使用することもできます。プライベート ミラーを使用すると、自分で構築およびパッケージ化したコンポーネントを使用することもできます。
TiUP mirror
概要
次のコマンドを実行して、 mirror
コマンドのヘルプ情報を取得します。
tiup mirror --help
The `mirror` command is used to manage a component repository for TiUP, you can use
it to create a private repository, or to add new component to an existing repository.
The repository can be used either online or offline.
It also provides some useful utilities to help manage keys, users, and versions
of components or the repository itself.
Usage:
tiup mirror <command> [flags]
Available Commands:
init Initialize an empty repository
sign Add signatures to a manifest file
genkey Generate a new key pair
clone Clone a local mirror from a remote mirror and download all selected components
merge Merge two or more offline mirrors
publish Publish a component
show Show the mirror address
set Set mirror address
modify Modify published component
renew Renew the manifest of a published component.
grant grant a new owner
rotate Rotate root.json
Global Flags:
--help Help for this command
Use "tiup mirror [command] --help" for more information about a command.
ミラーのクローンを作成する
tiup mirror clone
コマンドを実行してローカル ミラーを構築できます。
tiup mirror clone <target-dir> [global-version] [flags]
target-dir
: クローンデータが保存されるディレクトリを指定するために使用されます。global-version
: すべてのコンポーネントのグローバル バージョンを迅速に設定するために使用されます。
tiup mirror clone
コマンドは、多くのオプションのフラグを提供します (将来的にはさらに多くのフラグが提供される可能性があります)。これらのフラグは、使用目的に応じて次のカテゴリに分類できます。
クローン作成時にバージョンを一致させるためにプレフィックス マッチングを使用するかどうかを決定します。
--prefix
フラグが指定されている場合、バージョン番号はクローンのプレフィックスによって照合されます。たとえば、「v5.0.0」として--prefix
指定すると、「v5.0.0-rc」と「v5.0.0」が一致します。完全なクローンを使用するかどうかを決定します
--full
フラグを指定すると、公式ミラーを完全に複製できます。注記:
--full
、global-version
フラグ、およびコンポーネントのバージョンが指定されていない場合は、一部のメタ情報のみが複製されます。特定のプラットフォームからパッケージを複製するかどうかを決定します
特定のプラットフォームに対してのみパッケージのクローンを作成する場合は、
-os
と-arch
を使用してプラットフォームを指定します。例えば:tiup mirror clone <target-dir> [global-version] --os=linux
コマンドを実行して、Linux のクローンを作成します。tiup mirror clone <target-dir> [global-version] --arch=amd64
コマンドを実行して amd64 のクローンを作成します。tiup mirror clone <target-dir> [global-version] --os=linux --arch=amd64
コマンドを実行して、linux/amd64 のクローンを作成します。
パッケージの特定のバージョンのクローンを作成するかどうかを決定します
コンポーネントの 1 つのバージョン (すべてのバージョンではない) のみを複製する場合は、
--<component>=<version>
を使用してこのバージョンを指定します。例えば:tiup mirror clone <target-dir> --tidb v7.1.3
コマンドを実行して、TiDBコンポーネントの v7.1.3 バージョンのクローンを作成します。tiup mirror clone <target-dir> --tidb v7.1.3 --tikv all
コマンドを実行して、v7.1.3 バージョンの TiDBコンポーネントとすべてのバージョンの TiKVコンポーネントのクローンを作成します。tiup mirror clone <target-dir> v7.1.3
コマンドを実行して、クラスター内のすべてのコンポーネントの v7.1.3 バージョンのクローンを作成します。
クローン作成後、署名キーが自動的に設定されます。
プライベートリポジトリを管理する
tiup mirror clone
を使用して複製されたリポジトリは、SCP、NFS 経由でファイルを共有するか、HTTP または HTTPS プロトコル経由でリポジトリを利用できるようにすることで、ホスト間で共有できます。リポジトリの場所を指定するには、 tiup mirror set <location>
使用します。
tiup mirror set /shared_data/tiup
tiup mirror set https://tiup-mirror.example.com/
注記:
tiup mirror clone
実行しているマシンでtiup mirror set...
を実行すると、次回tiup mirror clone...
を実行するときに、マシンはリモート ミラーではなくローカル ミラーからクローンを作成します。したがって、プライベート ミラーを更新する前に、tiup mirror set --reset
を実行してミラーをリセットする必要があります。
ミラーを使用する別の方法は、 TIUP_MIRRORS
環境変数を使用することです。以下はプライベート リポジトリでtiup list
を実行する例です。
export TIUP_MIRRORS=/shared_data/tiup
tiup list
TIUP_MIRRORS
設定では、ミラー構成を永続的に変更できます (例: tiup mirror set
。詳細はティアップ号 #651を参照してください。
プライベートリポジトリを更新する
同じtarget-dir
を指定してtiup mirror clone
コマンドを再度実行すると、マシンは新しいマニフェストを作成し、利用可能なコンポーネントの最新バージョンをダウンロードします。
注記:
マニフェストを再作成する前に、すべてのコンポーネントとバージョン (以前にダウンロードした以前のものを含む) が含まれていることを確認してください。
カスタムリポジトリ
カスタム リポジトリを作成して、自分で構築した TiDB、TiKV、PD などの TiDB コンポーネントを操作できます。独自の tiup コンポーネントを作成することもできます。
独自のコンポーネントを作成するには、 tiup package
コマンドを実行し、 コンポーネントの梱包の指示に従って実行します。
カスタムリポジトリを作成する
/data/mirror
で空のリポジトリを作成するには:
tiup mirror init /data/mirror
リポジトリの作成の一環として、キーは/data/mirror/keys
に書き込まれます。
~/.tiup/keys/private.json
で新しい秘密キーを作成するには:
tiup mirror genkey
秘密鍵~/.tiup/keys/private.json
持つjdoe
に/data/mirror
の所有権を付与します。
tiup mirror set /data/mirror
tiup mirror grant jdoe
カスタムコンポーネントの操作
hello という名前のカスタムコンポーネントを作成します。
$ cat > hello.c << END > #include <stdio.h> int main() { printf("hello\n"); return (0); } END $ gcc hello.c -o hello $ tiup package hello --entry hello --name hello --release v0.0.1package/hello-v0.0.1-linux-amd64.tar.gz
が作成されます。リポジトリと秘密キーを作成し、リポジトリに所有権を付与します。
$ tiup mirror init /tmp/m $ tiup mirror genkey $ tiup mirror set /tmp/m $ tiup mirror grant $USERtiup mirror publish hello v0.0.1 package/hello-v0.0.1-linux-amd64.tar.gz helloコンポーネントを実行します。まだインストールされていない場合は、最初にダウンロードされます。
$ tiup helloThe component `hello` version is not installed; downloading from repository. Starting component `hello`: /home/dvaneeden/.tiup/components/hello/v0.0.1/hello hellotiup mirror merge
を使用すると、カスタム コンポーネントを含むリポジトリを別のリポジトリにマージできます。これは、/data/my_custom_components
のすべてのコンポーネントが現在の$USER
によって署名されていることを前提としています。$ tiup mirror set /data/my_mirror $ tiup mirror grant $USER $ tiup mirror merge /data/my_custom_components