docs: consolidate runnable examples and publish v0.1.1 guides

This commit is contained in:
2026-09-24 21:27:25 +08:00
parent e29dec717f
commit 81e56bd633
124 changed files with 1430 additions and 281 deletions

View File

@@ -21,10 +21,10 @@ docker image inspect registry.example/orbit:dev --format '{{.Id}}'
```sh
docker build --platform linux/amd64 \
--build-arg VERSION=1.0.0 \
--build-arg VERSION=v0.1.1 \
--build-arg REVISION="$(git rev-parse HEAD)" \
--build-arg BUILD_TIME="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
-t registry.example/orbit:1.0.0 .
-t registry.example/orbit:v0.1.1 .
```
镜像同时写入 OCI `org.opencontainers.image.version`、`org.opencontainers.image.revision` 和 `org.opencontainers.image.created` 标签;可以先核对标签,再在节点启动后通过 `GET /version` 核对进程实际使用的值。`registry.example` 只是占位符,不是平台依赖。
@@ -33,7 +33,7 @@ docker build --platform linux/amd64 \
```sh
docker run --rm --entrypoint /usr/local/bin/orbit-admin \
registry.example/orbit:1.0.0 release manifest > orbit-release-manifest.json
registry.example/orbit:v0.1.1 release manifest > orbit-release-manifest.json
```
清单把当前构建身份、协议版本和内置迁移校验和固定下来;部署前再用 `orbit-admin verify` 对目标数据库逐项核对。两者不一致时停止发布,不通过人工修改清单来“对齐”。
@@ -60,7 +60,7 @@ docker run --rm \
--env ORBIT_MYSQL_DSN \
--entrypoint /usr/local/bin/orbit-admin \
-v "$PWD/orbit-release-manifest.json:/run/orbit-release-manifest.json:ro" \
registry.example/orbit:1.0.0 verify --manifest /run/orbit-release-manifest.json
registry.example/orbit:v0.1.1 verify --manifest /run/orbit-release-manifest.json
docker run --rm \
--env ORBIT_MYSQL_DSN \