运行日常 TiDB Cloud CLI 工作流
本示例展示了一个跨 TiDB Cloud Starter 和 TiDB Cloud Filesystem 的典型运维工作流。
前提条件
- 安装
ti并运行ti configure。 - 确保你的组织具有一个 TiDB Cloud Starter 实例和一个 Filesystem 的容量。
步骤 1：检查当前资源
ti db list-db-clusters --db-cluster-type starter --output text
ti fs list-file-systems --output text
步骤 2：创建一个 TiDB Cloud Starter 实例
ti db create-db-cluster \
--db-cluster-type starter \
--db-cluster-name daily-demo \
--dry-run
export DB_CLUSTER_ID="$(ti db create-db-cluster \
--db-cluster-type starter \
--db-cluster-name daily-demo \
--wait \
--query id \
--output text)"
该命令会将返回的集群 ID 保存到 DB_CLUSTER_ID 中。由于设置了 --wait，创建命令会在集群变为活动状态后才返回。你也可以稍后再次查看它：
ti db describe-db-cluster \
--db-cluster-id "$DB_CLUSTER_ID" \
--output text
步骤 3：验证 SQL 访问
ti db create-db-sql-users --db-cluster-id "$DB_CLUSTER_ID"
ti db execute-sql-statement \
--db-cluster-id "$DB_CLUSTER_ID" \
--read-only \
--sql "SELECT CURRENT_TIMESTAMP AS checked_at" \
--output text
步骤 4：创建并使用 Filesystem
export TI_FS_FILE_SYSTEM_ID="$(ti fs create-file-system \
--wait \
--query file_system_id \
--output text)"
printf 'daily workflow\n' | ti fs copy-file \
--from-stdin \
--to-remote /notes/today.txt
ti fs list-files \
--path /notes \
--output text
/notes/today.txt 中的文件可用于验证显式选择的资源是否可用。
步骤 5：检查更新
在不更改已安装版本的情况下，检查是否有可用的新版本：
ti update --check
预览更新：
ti update --dry-run
如果另一个工作流存在活动中的 Filesystem 或 Vault 挂载，请在应用更新前先停止写入端并卸载它，以便 ti 和 Filesystem 运行时一起更新。有关说明，请参见更新 TiDB Cloud CLI。
在适当的时候应用更新：
ti update
清理
ti fs delete-file-system \
--file-system-id "$TI_FS_FILE_SYSTEM_ID"
ti db delete-db-cluster \
--db-cluster-id "$DB_CLUSTER_ID"
安全说明
- 不要回显 FS token 或格式化后的数据库连接字符串。
- 使用唯一的自动化前缀，并且只删除该次运行创建的资源。
- 使用
--dry-run预览破坏性操作。