CI/CD / 系统课时

生成应用制品

生成应用制品

这一课把“构建成功”落到一个可发布文件上:流水线不仅要编译源码,还要把版本、提交号和构建编号写入元数据,并输出可校验、可存档、可独立部署的应用制品。

学习目标

  • 在流水线中完成最小的编译与打包流程
  • 为制品写入可追踪的版本和提交元数据
  • 用文件清单和摘要验证产物是否可发布

明确制品应包含什么

一个可发布制品至少要回答三个问题:它运行什么代码、来自哪个版本、文件是否完整。语言和框架不同,载体可以是 JAR、ZIP、二进制文件或容器镜像,但这些信息都不应只存在于流水线日志里。

下面用一个最小 Java 应用演示完整过程。脚本会创建源码、编译 class、生成 release.properties,再打成可执行 JAR;BUILD_VERSION、GIT_COMMIT 和 BUILD_ID 在真实流水线中通常由 CI 系统注入。

编译、写入元数据并打包

bash
set -euo pipefail

BUILD_VERSION="${BUILD_VERSION:-1.0.0}"
GIT_COMMIT="${GIT_COMMIT:-<ID>}"
BUILD_ID="${BUILD_ID:-<ID>}"

rm -rf build dist src
mkdir -p src build/classes build/meta dist

cat > src/Main.java <<'JAVA'
public class Main {
    public static void main(String[] args) {
        System.out.println("CI/CD artifact is runnable");
    }
}
JAVA

javac -d build/classes src/Main.java

cat > build/meta/release.properties <<META
version=$BUILD_VERSION
commit=$GIT_COMMIT
buildId=$BUILD_ID
META

jar --create \
  --file "dist/app-$BUILD_VERSION.jar" \
  --main-class Main \
  -C build/classes . \
  -C build/meta release.properties

sha256sum "dist/app-$BUILD_VERSION.jar" > "dist/app-$BUILD_VERSION.jar.sha256"

java -jar "dist/app-$BUILD_VERSION.jar"
jar --list --file "dist/app-$BUILD_VERSION.jar"

预期输出

text
CI/CD artifact is runnable
META-INF/
META-INF/MANIFEST.MF
Main.class
release.properties

文件顺序可能因 JDK 版本略有不同,但必须能看到 Main.class 和 release.properties,且 java -jar 正常退出。<ID> 在真实流水线中会被实际提交号和构建编号替换。

验证元数据和摘要

打包完成后还要确认元数据确实进入制品,而不是只在工作目录里存在。可以直接从 JAR 中读取文件,再验证 SHA-256 校验文件。

bash
set -euo pipefail

BUILD_VERSION="${BUILD_VERSION:-1.0.0}"

unzip -p "dist/app-$BUILD_VERSION.jar" release.properties
sha256sum -c "dist/app-$BUILD_VERSION.jar.sha256"

预期输出

text
version=1.0.0
commit=<ID>
buildId=<ID>
dist/app-1.0.0.jar: OK

如果流水线显式传入了其他 BUILD_VERSION、GIT_COMMIT 或 BUILD_ID,对应值会不同;关键是元数据与本次构建上下文一致,并且摘要校验返回 OK。

把临时目录与发布目录分开

build/ 适合存放编译中间文件,dist/ 才应该作为流水线的发布出口。这样上传制品仓库时只需要收集 dist/,不会把源码、缓存或编译临时文件一起发布。

让制品具备可追踪性

制品名称中的版本号解决“这是哪个发布版本”,内部元数据解决“它来自哪个提交和哪次构建”,摘要解决“文件内容是否被替换”。三者组合起来,流水线才能在部署前做确定性校验。

后续把 dist/app-<version>.jar 和对应 .sha256 上传到制品仓库时,不需要再次编译;部署阶段只需按版本或摘要取回这份已验证的文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

生成应用制品

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通