title: tiup mirror rotate

tiup mirror rotate

TiUP 的镜像中有一个非常重要的文件:root.json,里面记录了整个系统需要使用的公钥,是 TiUP 信任链的基础,它的内容主要包含几个部分:

  • N 个管理员的签名,对于官方镜像,N 为 5,默认初始化的镜像 N 为 3
  • 用于验证以下文件的公钥:
    • root.json
    • index.json
    • snapshot.json
    • timestamp.json
  • 过期时间,对于官方镜像,为 root.json 创建时间后延一年

关于镜像的详细介绍可以参考镜像说明

在某些情况下,用户需要更新 root.json:

  • 更换镜像的密钥
  • 更新证书过期时间

更新 root.json 内容之后,必须由管理员对其进行重新签名,否则客户端会拒绝,更新流程如下:

  1. 更新 root.json 的内容
  2. N 个管理员对新的 root.json 进行签名
  3. 更新 snapshot.json,记录新的 root.json 的 version
  4. 对新的 snapshot.json 进行签名
  5. 更新 timestamp.json,记录新的 snapshot.json 的 hash
  6. 对新的 timestamp.json 进行签名

TiUP 使用命令 tiup mirror rotate 来自动化以上流程。

注意:

  • 经测试,小于 TiUP v1.3.0 的版本无法正确获得新的 root.json #983
  • 使用此功能前请确保所有的 TiUP 客户端升级到了 v1.3.0 或以上版本。

语法

  1. tiup mirror rotate [flags]

该命令会启动一个编辑器,修改其内容为目标值(比如将 expires 字段的值向后推移),然后需要将 version 字段加一并保存。保存之后会启动一个临时的 http 服务器,等待 N 个不同的镜像管理员签名。

镜像管理员签名的方式参考 sign 命令

选项

—addr(string,默认 0.0.0.0:8080)

临时服务器的监听地址,需要确保该地址可以被其他镜像管理员访问,这样管理员才能使用 sign 命令签名。

输出

  • 各个镜像管理员当前的签名状态