tiup mirror genkey
TiUP 鏡には、その定義によると、ユーザーの 3 つの役割があります。
- ミラー管理者:
root.json、index.json、snapshot.json、およびtimestamp.jsonを変更する権限があります。 - コンポーネントの所有者: 対応するコンポーネントを変更する権限があります。
- 通常のユーザー: コンポーネントをダウンロードして使用できます。
TiUP は、ファイルを変更するために対応する所有者/管理者の署名を必要とするため、所有者/管理者は自分の秘密鍵を持っている必要があります。コマンドtiup mirror genkeyは、秘密鍵を生成するために使用されます。
構文
tiup mirror genkey [flags]
オプション
-n, --name
- 最終的に生成されるファイルの名前も決定するキーの名前を指定します。生成された秘密鍵ファイルのパスは
${TIUP_HOME}/keys/{name}.jsonです。TIUP_HOMEは TiUP のホーム ディレクトリを指し、デフォルトでは$HOME/.tiupです。nameは、-n/--nameが指定する秘密鍵の名前を指します。 - データ型:
STRING - デフォルト: 「非公開」
-p, --public
- オプション
-n/--nameで指定された秘密鍵に対応する公開鍵を示します。 -p/--publicを指定すると、TiUP は新しい秘密鍵を作成しません。-n/--nameで指定した秘密鍵が存在しない場合、TiUPはエラーを返します。- データ型:
BOOLEAN - このオプションはデフォルトで無効になっており、デフォルト値は
falseです。このオプションを有効にするには、このオプションをコマンドに追加して、値trueを渡すか、値を何も渡さないようにします。
- 保存
- 公開鍵の情報をカレントディレクトリにファイルとして保存します。ファイル名は
{hash-prefix}-public.jsonです。hash-prefixはキー ID の最初の 16 ビットです。 - データ型:
BOOLEAN - このオプションはデフォルトで無効になっており、デフォルト値は
falseです。このオプションを有効にするには、このオプションをコマンドに追加して、値trueを渡すか、値を何も渡さないようにします。
出力
-p/--publicが指定されていない場合:-n/--nameで指定した秘密鍵が存在する場合: TiUP はKey already exists, skippedを出力します。-n/--nameで指定した秘密鍵が存在しない場合: TiUP はprivate key have been write to ${TIUP_HOME}/keys/{name}.jsonを出力します。
-p/--publicを指定した場合:-n/--nameで指定した秘密鍵が存在しない場合: TiUP はエラーError: open ${TIUP_HOME}/keys/{name}.json: no such file or directoryを報告します。-n/--nameで指定した秘密鍵が存在する場合：TiUPは対応する公開鍵の内容を出力します。