tiup: add offline update tiup

TOC.md

@@ -53,7 +53,8 @@
   + [从 SQL 文件迁移到 TiDB](/migrate-from-mysql-mydumper-files.md)
 + 运维操作
   + 升级 TiDB 版本
-    + [使用 TiUP（推荐）](/upgrade-tidb-using-tiup.md)
+    + [使用 TiUP 升级（推荐）](/upgrade-tidb-using-tiup.md)
+    + [使用 TiUP 离线升级（推荐）](/upgrade-tidb-using-tiup-offline.md)
     + [使用 TiDB Operator](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/upgrade-a-tidb-cluster/)
     + [使用 TiDB Ansible](/upgrade-tidb-using-ansible.md)
   + 扩缩容

export-or-backup-using-dumpling.md

@@ -92,7 +92,7 @@ Dumpling 可以通过 `--filter` 指定 table-filter 来筛选特定的库表。
   -P 4000 \
   -h 127.0.0.1 \
   -o /tmp/test \
-  --filter "employees.*"
+  --filter "employees.*" \
   --filter "*.WorkOrder"
 ```
 

quick-start-with-tidb.md

@@ -246,7 +246,7 @@ TiDB-Wasm 是运行在浏览器中的 TiDB 数据库，打开网页即可使用
     {{< copyable "shell-regular" >}}
 
     ```shell
-    tiup cluster deploy <cluster-name> <tidb-version> ./topo.yaml --user root 
+    tiup cluster deploy <cluster-name> <tidb-version> ./topo.yaml --user root -p
     ```
 
     - 参数 `<cluster-name>` 表示设置集群名称

upgrade-tidb-using-tiup-offline.md

@@ -0,0 +1,27 @@
+---
+title: 使用 TiUP 离线镜像升级 TiDB
+category: how-to
+---
+
+# 使用 TiUP 离线镜像升级 TiDB
+
+本文档适用于通过升级 TiUP 离线镜像升级 TiDB 集群，升级步骤如下。
+
+## 1. 更新 TiUP 离线镜像
+
+如果用户希望升级更新本地的 TiUP 离线镜像，可以参考[使用 TiUP 离线部署 TiDB 集群](/production-offline-deployment-using-tiup.md)的步骤 1 与步骤 2 下载部署新版本的 TiUP 离线镜像。在执行 `local_install.sh` 后，TiUP 会完成覆盖升级。
+
+随后，需要按照 `local_install.sh` 执行的结果，重新声明全局环境变量，并将 TIUP_MIRRORS 指向执行 `local_install.sh` 命令时输出的离线镜像包的位置 `/path/to/mirror`。
+
+{{< copyable "shell-regular" >}}
+
+```bash
+source .bash_profile
+export TIUP_MIRRORS=/path/to/mirror
+```
+
+此时离线镜像已经更新成功。如果覆盖后发现 TiUP 运行报错，可能是 manifest 未更新导致，可尝试 `rm -rf ~/.tiup/manifests` 后再使用 TiUP。
+
+## 2. 升级 TiDB 集群
+
+在更新本地镜像后，可参考[使用 TiUP 升级 TiDB](/upgrade-tidb-using-tiup.md#使用-tiup-升级-tidb)升级 TiDB 集群。