已部署的原生Quarkus应用程序自更新：最优实现方案探讨

核心前提 #

原生镜像是单可执行二进制文件，直接替换运行中的自身会触发系统报错，所以核心是通过非主进程逻辑完成文件替换，同时保证更新的安全性和兼容性。

分步实现方案 #

1. 版本检测与可信下载 #

• 维护版本元数据：在后端/静态托管服务存放latest-version.json，包含最新版本号、对应平台的下载地址、SHA256哈希值（用于校验文件完整性）
• 版本号嵌入：编译时通过Quarkus的quarkus.application.version参数将版本号写入镜像，代码中直接读取BuildConfig.VERSION获取当前版本
• 触发检查：支持两种触发方式——应用启动时自动检查，或用户手动执行myapp update命令触发
• 哈希校验：下载新版本后，计算本地文件哈希并与元数据中的值对比，防止文件篡改或损坏

2. 安全替换可执行文件 #

根据操作系统差异，选择对应的替换逻辑：

• 类Unix系统（Linux/macOS）：
  1. 下载新版本到同目录临时文件（如myapp.new）
  2. 使用mv命令完成原子替换（Unix下mv是原子操作，不会影响当前运行的进程句柄）
  3. 提示用户重启应用即可加载新版本
• Windows系统：
  1. 下载新版本到临时文件
  2. 重命名原可执行文件为myapp.old，将临时文件改名为原程序名
  3. 下次启动时自动删除旧文件
• 通用兜底方案：启动独立子进程（可打包一个极小的辅助二进制或调用系统脚本），主进程退出后，由子进程完成文件替换操作

3. 回滚与异常处理 #

• 备份机制：替换前自动备份原可执行文件为myapp.bak
• 启动校验：新版本首次启动失败时，自动恢复备份文件
• 手动回滚：提供myapp rollback命令，让用户手动恢复到上一版本

4. 跨平台适配 #

• 编译多平台镜像：利用Quarkus的quarkus.native.platform参数，编译Windows、Linux、macOS等不同平台的原生镜像
• 版本元数据区分：在latest-version.json中按平台划分下载地址，CLI根据自身运行平台匹配对应版本

5. 集成Quarkus特性简化实现 #

• 用Quarkus REST客户端拉取版本元数据和下载文件，无需额外引入HTTP依赖
• 借助@Startup注解实现启动时自动检查更新（可通过配置开关关闭自动检查）

代码示例 #

版本检查逻辑 #

@ApplicationScoped
public class UpdateService {
    private static final String VERSION_META_URL = "https://your-host/latest-version.json";
    private final UpdateMetaClient metaClient;

    public UpdateService(RestClientBuilder restClientBuilder) {
        this.metaClient = restClientBuilder.build(UpdateMetaClient.class);
    }

    public Optional<UpdateMeta> checkForUpdates() {
        UpdateMeta latestMeta = metaClient.getLatestMeta();
        String currentVersion = BuildConfig.VERSION;
        if (new Version(currentVersion).compareTo(new Version(latestMeta.getVersion())) < 0) {
            return Optional.of(latestMeta);
        }
        return Optional.empty();
    }

    @RegisterRestClient(baseUri = VERSION_META_URL)
    public interface UpdateMetaClient {
        @GET
        UpdateMeta getLatestMeta();
    }

    public record UpdateMeta(String version, String downloadUrl, String sha256, String platform) {}
}

类Unix系统替换逻辑 #

public void executeUpdate(UpdateMeta meta) throws IOException, InterruptedException {
    Path tempPath = Paths.get("./myapp.new");
    // 下载文件
    try (InputStream in = new URL(meta.downloadUrl()).openStream()) {
        Files.copy(in, tempPath, StandardCopyOption.REPLACE_EXISTING);
    }
    // 校验哈希
    if (!verifyHash(tempPath, meta.sha256())) {
        Files.delete(tempPath);
        throw new RuntimeException("文件校验失败，已删除无效文件");
    }
    // 原子替换
    Process replaceProcess = new ProcessBuilder("mv", tempPath.toString(), "./myapp").inheritIO().start();
    int exitCode = replaceProcess.waitFor();
    if (exitCode != 0) {
        throw new RuntimeException("更新失败，请手动检查文件");
    }
    System.out.println("更新完成，请重启应用生效");
}

private boolean verifyHash(Path file, String expectedSha256) throws IOException {
    String actualSha256 = DigestUtils.sha256Hex(Files.newInputStream(file));
    return actualSha256.equalsIgnoreCase(expectedSha256);
}

内容的提问来源于stack exchange，提问作者col.panic