跳到主要内容

发布手册

本文介绍下发布新版本时，发布负责人需要做什么

发布周期​

Layotto 发布周期暂定为每季度发布一次。

发布 checklist​

Step1: 检查当前迭代的 Roadmap​

  1. 检查进行中的任务
  2. 检查未完成的任务
  3. 与负责人确认任务状态和发布内容

Step2: 创建发布 tag， push 至 github 并检查工作流​

  1. 规范：请按照 v{majorVersion}.{subVersion}.{latestVersion} 格式创建 tag。

  2. 等待 CI 结束，确认以下内容：

    • CI 测试 Jobs 全部通过：
      • Go 代码风格校验
      • Go 代码规范校验
      • Go 单元测试
      • Go 集成测试
    • CI 多平台 Artifacts 构建 Jobs 全部通过：
      • Linux/AMD64 Artifacts 成功 Build 并 Upload
      • Linux/ARM64 Artifacts 成功 Build 并 Upload
      • Darwin/AMD64 Artifacts 成功 Build 并 Upload
      • Darwin/ARM64 Artifacts 成功 Build 并 Upload
    • CI 多平台 Image 构建/发布 Jobs 全部通过：
      • Linux/AMD64 Image 成功 Build 并 Push DockerHub
      • Linux/ARM64 Image 成功 Build 并 Push DockerHub
        • Image Tag 规范：
          • AMD64/X86 架构的镜像：layotto/layotto:{tag}
          • ARM64 架构的镜像：layotto/layotto.arm64:{tag}

release.png

Step3: Draft a new release 并编写发布报告​

发布报告可以先用 github 的功能自动生成，再基于生成的内容做修改。

可以参考以前的 发版报告

img_1.png

Step4: 上传多平台架构的 Binaries​

2022/05/04更新：这一步可以忽略。打 tag 发布后，Layotto 的 Release Pipeline 会自动上传二进制文件，无需手动上传。PR 见 https://github.com/mosn/layotto/pull/566

如果没有自动上传，可以手动将 步骤 2 中构建的多平台 Artifacts 下载、上传

img.png

Step5: 确认发布​

  1. 点击发布
  2. 社区周知
  3. 检查 Roadmap，修改上个版本未完成的任务，把 milestone 改为下个版本
  4. 如果有 SDK 发布，需在 SDK 仓库做发布，并上传中央仓库 (比如 Java SDK 需要上传到 Maven 中央仓库)。