- 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 健康检查
65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
# 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
|
||
```
|
||
|
||
### 构建与部署
|
||
|
||
```shell
|
||
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
|
||
```
|
||
|
||
访问:
|
||
|
||
```shell
|
||
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 可直接终止进程,无额外清理逻辑。
|
||
|
||
### 停止
|
||
|
||
```shell
|
||
sh shutdown.sh
|
||
```
|