feat(version): 构建身份四件套,为按版本发标准包打底
- 新增 build.rs 注入 version/gitSha/target/buildTime;`--version` 打印一行。 gitSha 带 `-dirty` 后缀,避免「sha 对得上但代码其实改过」的误判。 - 版本行同时拼成静态字符串(TDC_VERSION_LINE):armv7 产物在 x86 打包机上 跑不起来,打包脚本要靠 strings 捞同一行。 - /api/health 增 gitSha/target/buildTime(纯新增,既有字段一个不动)。 - 版本 0.1.0 → 0.2.0。 动机:设备上跑的到底是哪个构建,此前只能靠 md5 比对几十兆的 `.bak`; 排查 carol 上一个 1.27M 的 mpc 时就卡在无法自证来源。
This commit is contained in:
1 parent
22e6921fd3
commit
50911ea7d6
4 files changed
+141
-4
No files matched your search
+1
-1
@@ -1,6 +1,6 @@
|
||||
[package]
|
||||
name = "tdc-connector"
|
||||
version = "0.1.0"
|
||||
version = "0.2.0"
|
||||
edition = "2021"
|
||||
description = "TDC (数据接入连接器) MVP — Rust + 静态 HTML + PGlite 本地优先实现"
|
||||
|
||||
|
||||
@@ -0,0 +1,114 @@
|
||||
//! 构建期元信息注入:版本号之外,再钉住 **git sha / 构建时间 / 目标三元组**。
|
||||
//!
|
||||
//! 🔴 为什么需要:此前二进制里只有 `CARGO_PKG_VERSION`(恒为 `0.1.0`),
|
||||
//! 而版本一直没 bump ⇒ 三台设备上跑的到底是哪个构建,只能靠 md5 猜。
|
||||
//! 2026-11-14 排查 carol 上一个 1.27M 的 `mpc` 时,正因为无版本串而无法自证来源。
|
||||
//!
|
||||
//! 🔴 本仓 `[dependencies]` 为空(平台走预编译 rlib 闭包),所以 build.rs 只用 std。
|
||||
//!
|
||||
//! 🔴 **不注入 GLIBC 需求**:build.rs 跑的时候二进制还不存在,算不出来。
|
||||
//! 那个交给打包脚本对**产物**跑 `objdump -T` 得出并写进 manifest —— 以实物为准,
|
||||
//! 不以声明为准(声明会和实际脱钩,实物不会)。
|
||||
|
||||
use std::process::Command;
|
||||
|
||||
fn main() {
|
||||
// 🔴 构建期自检:`#[cfg(test)]` 在 build.rs 里**不会**被 `cargo test` 执行,
|
||||
// 所以日历换算只能这样验 —— 错了就让构建失败,而不是留个永不运行的测试。
|
||||
assert_eq!(fmt_utc(0), "1970-01-01T00:00:00Z");
|
||||
assert_eq!(fmt_utc(1_794_628_200), "2026-11-14T03:50:00Z");
|
||||
assert_eq!(fmt_utc(1_709_208_000), "2024-02-29T12:00:00Z"); // 闰日
|
||||
|
||||
// sha:允许构建脚本用环境变量覆盖(容器里没装 git 时也能钉版本),否则现场问 git。
|
||||
let sha = std::env::var("TDC_GIT_SHA")
|
||||
.ok()
|
||||
.filter(|s| !s.trim().is_empty())
|
||||
.or_else(git_sha)
|
||||
.unwrap_or_else(|| "unknown".to_string());
|
||||
|
||||
let epoch = std::time::SystemTime::now()
|
||||
.duration_since(std::time::UNIX_EPOCH)
|
||||
.map(|d| d.as_secs())
|
||||
.unwrap_or(0);
|
||||
|
||||
let target = std::env::var("TARGET").unwrap_or_else(|_| "unknown".to_string());
|
||||
let utc = fmt_utc(epoch);
|
||||
|
||||
// 🔴 版本行**只在这里拼一次**,`--version` 直接打印它。
|
||||
// 第二个用途:armv7 产物在 x86_64 打包机上**跑不了**,拿不到 `--version` 输出,
|
||||
// 打包脚本只能用 `strings` 从二进制里捞这一行 ⇒ 它必须是**完整的静态字符串**
|
||||
// (`println!` 的格式串加参数在二进制里是碎的,捞不出来)。
|
||||
let ver_line = format!(
|
||||
"tdc-connector {} ({sha} {target} {utc})",
|
||||
env!("CARGO_PKG_VERSION")
|
||||
);
|
||||
|
||||
println!("cargo:rustc-env=TDC_GIT_SHA={sha}");
|
||||
println!("cargo:rustc-env=TDC_BUILD_EPOCH={epoch}");
|
||||
println!("cargo:rustc-env=TDC_BUILD_UTC={utc}");
|
||||
println!("cargo:rustc-env=TDC_BUILD_TARGET={target}");
|
||||
println!("cargo:rustc-env=TDC_VERSION_LINE={ver_line}");
|
||||
|
||||
// 不设这个的话 sha 会永远停在第一次构建的值 —— git 换了也不重跑 build.rs。
|
||||
println!("cargo:rerun-if-changed=build.rs");
|
||||
println!("cargo:rerun-if-changed=.git/HEAD");
|
||||
println!("cargo:rerun-if-changed=.git/index");
|
||||
println!("cargo:rerun-if-env-changed=TDC_GIT_SHA");
|
||||
}
|
||||
|
||||
/// `git rev-parse --short HEAD`,工作区有未提交改动时追加 `-dirty`。
|
||||
///
|
||||
/// `-dirty` 很重要:否则「sha 对得上但代码其实改过」会造成误判,
|
||||
/// 而这正是本轮要消灭的那类问题(设备状态与源码无法对应)。
|
||||
fn git_sha() -> Option<String> {
|
||||
let out = Command::new("git")
|
||||
.args(["rev-parse", "--short", "HEAD"])
|
||||
.output()
|
||||
.ok()?;
|
||||
if !out.status.success() {
|
||||
return None;
|
||||
}
|
||||
let sha = String::from_utf8_lossy(&out.stdout).trim().to_string();
|
||||
if sha.is_empty() {
|
||||
return None;
|
||||
}
|
||||
|
||||
// --untracked-files=no:未跟踪的临时文件不算脏,避免每轮都标 -dirty。
|
||||
let dirty = Command::new("git")
|
||||
.args(["status", "--porcelain", "--untracked-files=no"])
|
||||
.output()
|
||||
.ok()
|
||||
.filter(|o| o.status.success())
|
||||
.map(|o| !o.stdout.is_empty())
|
||||
.unwrap_or(false);
|
||||
|
||||
Some(if dirty { format!("{sha}-dirty") } else { sha })
|
||||
}
|
||||
|
||||
/// epoch 秒 → `YYYY-MM-DDTHH:MM:SSZ`(UTC),手写以免引入 chrono 依赖。
|
||||
///
|
||||
/// 算法照 Howard Hinnant 的 `civil_from_days`(把 1970-01-01 起的日数转年月日)。
|
||||
fn fmt_utc(secs: u64) -> String {
|
||||
let days = (secs / 86_400) as i64;
|
||||
let rem = secs % 86_400;
|
||||
let (y, m, d) = civil_from_days(days);
|
||||
format!(
|
||||
"{y:04}-{m:02}-{d:02}T{:02}:{:02}:{:02}Z",
|
||||
rem / 3600,
|
||||
(rem % 3600) / 60,
|
||||
rem % 60
|
||||
)
|
||||
}
|
||||
|
||||
fn civil_from_days(z: i64) -> (i64, u32, u32) {
|
||||
let z = z + 719_468;
|
||||
let era = if z >= 0 { z } else { z - 146_096 } / 146_097;
|
||||
let doe = (z - era * 146_097) as u64; // [0, 146096]
|
||||
let yoe = (doe - doe / 1460 + doe / 36_524 - doe / 146_096) / 365; // [0, 399]
|
||||
let y = yoe as i64 + era * 400;
|
||||
let doy = doe - (365 * yoe + yoe / 4 - yoe / 100); // [0, 365]
|
||||
let mp = (5 * doy + 2) / 153; // [0, 11]
|
||||
let d = (doy - (153 * mp + 2) / 5 + 1) as u32; // [1, 31]
|
||||
let m = if mp < 10 { mp + 3 } else { mp - 9 } as u32; // [1, 12]
|
||||
(if m <= 2 { y + 1 } else { y }, m, d)
|
||||
}
|
||||
+14
-3
@@ -64,11 +64,22 @@ fn resolve_project_dir() -> PathBuf {
|
||||
|
||||
#[tokio::main]
|
||||
async fn main() {
|
||||
// 🔴 `--enc <明文>`:**自证**工具(v3 spec §2.4「cipher 用后端 `--enc` 之类的自证手段」)。
|
||||
// 用途:让 `scripts/smoke.sh` **零 node / 零 openssl 依赖**地造出上游前端同款的密文。
|
||||
// 🔴 纯 CLI 旁路,**不碰任何 HTTP 路由** ⇒ 对外契约零变化。
|
||||
// 🔴 纯 CLI 旁路(**不碰任何 HTTP 路由** ⇒ 对外契约零变化):
|
||||
//
|
||||
// `--enc <明文>`:**自证**工具(v3 spec §2.4「cipher 用后端 `--enc` 之类的自证手段」)。
|
||||
// 用途:让 `scripts/smoke.sh` **零 node / 零 openssl 依赖**地造出上游前端同款的密文。
|
||||
//
|
||||
// `--version`:打印构建身份四件套。存在的理由是「设备自查」——
|
||||
// 登到机器上跑一句就知道跑的是哪个 git 提交、哪个架构、什么时候编的,
|
||||
// 不必再靠 md5 去比对一堆 69M 的 `.bak`(那是 2026-11-14 之前的做法)。
|
||||
{
|
||||
let args: Vec<String> = std::env::args().collect();
|
||||
if args.len() >= 2 && (args[1] == "--version" || args[1] == "-V") {
|
||||
// 整行由 build.rs 拼好(`TDC_VERSION_LINE`):打包脚本要能从 armv7 二进制里
|
||||
// 用 strings 捞到同一行,所以这里不能再拆成 println! 的格式串 + 参数。
|
||||
println!("{}", env!("TDC_VERSION_LINE"));
|
||||
return;
|
||||
}
|
||||
if args.len() >= 3 && (args[1] == "--enc" || args[1] == "-e") {
|
||||
println!("{}", tdc_connector::platform::cipher::encrypt_login_password(&args[2]));
|
||||
return;
|
||||
|
||||
@@ -9,6 +9,15 @@
|
||||
//! |---|---|
|
||||
//! | `tables` | **业务表数** = `public` schema 下 `tdc_*` 表的条数(P0 验收口径:30) |
|
||||
//! | `baseTables` | 账号层表数 = `migrate.sql` **声明的** 3 张 `base_*` 表在库中的条数 |
|
||||
//! | `version` / `gitSha` / `target` / `buildTime` | 构建身份(见下) |
|
||||
//!
|
||||
//! 🔴 **构建身份四件套**(2026-11-14 新增):此前只有 `version` 且版本号长期停在 `0.1.0`,
|
||||
//! 于是「设备上跑的是哪个构建」只能靠 md5 猜 —— 排查 carol 上一个 1.27M 的 `mpc`
|
||||
//! 时就卡在这里,无法自证来源。四个字段由 `build.rs` 在编译期钉进二进制:
|
||||
//! `gitSha` 带 `-dirty` 后缀表示工作区有未提交改动;`target` 是三元组(能区分
|
||||
//! x86_64 / armv7);`buildTime` 是 UTC ISO 8601。
|
||||
//! ⚠️ GLIBC 需求**不在这里**:那是产物属性,由打包脚本对二进制跑 `objdump` 后写进
|
||||
//! `manifest.json` —— 以实物为准,声明会脱钩,实物不会。
|
||||
//!
|
||||
//! 两个计数都**真查库**(不是静态 JSON)⇒ 与 `schema/migrate.sql` 逐名对账由
|
||||
//! `scripts/smoke.sh` 守住。
|
||||
@@ -73,6 +82,9 @@ async fn health(State(state): State<TdcState>) -> axum::Json<serde_json::Value>
|
||||
"status": "UP",
|
||||
"service": "tdc-connector",
|
||||
"version": env!("CARGO_PKG_VERSION"),
|
||||
"gitSha": env!("TDC_GIT_SHA"),
|
||||
"target": env!("TDC_BUILD_TARGET"),
|
||||
"buildTime": env!("TDC_BUILD_UTC"),
|
||||
"protocolVersion": crate::platform::protocol::PROTOCOL_VERSION,
|
||||
"tdsMode": if state.config.tds_base_url.is_some() { "HTTP" } else { "NOOP" },
|
||||
"tdsBaseUrl": state.config.tds_base_url.clone().unwrap_or_default(),
|
||||
|
||||
Reference in new issue
Block a user