Files
kenaito-lab/demo/app/rust
odboy 15d7eae1e0 feat: 新增 rust 示例(标准库 TcpListener Web 服务,compile-rust / runtime-rust 两阶段构建)
- src/main.rs:零第三方依赖的 HTTP/1.1 服务,提供 /、/api/info、/health、
  /api/hello、/page;App 用 Arc 共享后 clone 进 thread::spawn,保证 'static
- Dockerfile:依赖预热层的桩产物放到 /tmp/deps-target,避免与正式编译
  共用 /src/target 时被判定 up-to-date、把桩二进制拷进运行镜像;运行阶段
  增加 grep 启动日志的构建期自检
- docker-compose.yml:固定 IP 172.31.2.20,端口 8088,netstat 健康检查
2026-11-15 12:10:59 +08:00
..

rust 示例

演示如何用 compile-rust + runtime-rust 两阶段构建一个 Rust 1.100 Web 服务。只用标准库 TcpListener 手写 HTTP/1.1, 无第三方 crate,因此示例构建不依赖 crates.io,离线也能编译。

阶段 镜像 说明
编译 registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-rust rustc/cargo + gcc/make,crates 源走阿里云镜像
运行 registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-rust rustc/cargo 运行时;示例只跑二进制,不需要工具链

示例内容

rust/
├── Cargo.toml          # edition 2021,无依赖;release 开 LTO / strip / panic=abort 减小体积
├── src/main.rs         # 标准库 TcpListener:/、/api/info、/health、/api/hello、/page
├── Dockerfile          # 两阶段:compile-rust -> runtime-rust
├── build.sh            # 构建镜像(PUSH=1 时同时推送)
├── docker-compose.yml  # 部署编排(端口 8088,固定 IP 172.31.2.20)
├── startup.sh          # docker-compose up -d
└── shutdown.sh         # docker-compose down

构建与部署

sh build.sh            # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-rust .
PUSH=1 sh build.sh     # 构建并推送
sh startup.sh          # docker-compose -f docker-compose.yml -p rust-demo up -d

访问:

curl http://127.0.0.1:8088/                # {"message":"rust demo is running",...}
curl http://127.0.0.1:8088/health          # ok
curl http://127.0.0.1:8088/api/hello?name=demo

浏览器打开 http://127.0.0.1:8088/page 可看到 HTML 页面。

关键点

无第三方依赖:示例只用了 std,构建时不需要访问 crates.io。要用 axum / actix-web 时, 在 Cargo.toml 加依赖即可,compile-rust 里已经把 crates 源换成阿里云稀疏索引,Dockerfile 不用改。

依赖层缓存:先 COPY Cargo.toml 并用一个空 main.rs 跑一次 cargo build --release, 再 COPY src 正式编译;只有 Cargo.toml 变化时才会重新编译依赖。

桩产物放在 --target-dir /tmp/deps-target,不落到 /src/target,避免正式编译看到“产物比源码新” 而跳过重编、把桩程序拷进运行镜像;运行阶段还会 grep 二进制里的启动日志做构建期自检。

时间换算不引 chrono:标准库里没有日期格式化,示例用 Howard Hinnant 的 civil_from_days 算法把 UTC 秒数 换成 YYYY-MM-DD HH:MM:SS +08:00,保持零依赖。

线程模型:App 用 Arc 共享,每个连接 Arc::clone 后 thread::spawn,只适合示例;生产用 tokio/axum 异步处理。

停止:ENTRYPOINT ["/home/admin/rust-demo"] 为 exec 形式,SIGTERM 可直接终止进程,无额外清理逻辑。

停止

sh shutdown.sh