使用 Zadig 实现小程序自动发布

麦小轮
Jenkins 云计算运维
2022-11-17
433
0

引言

自动化已经常态化，99% 的公司或多或少都实现了部分自动化功能，比如应用的打包部署、服务器的批量维护、自动化测试等。

在实际工作中，我基本完成了前端、后端、移动端的自动化，但是一直没有涉及到小程序，主要原因在于：

小程序的开发受限平台的开发工具。
在开发小程序过程中，编译以及部署，都是开发通过可视化开发工具实现。
小程序应用比较少，容易忽略。

这就导致在开发小程序过程中，构建发布程序到生产或测试环境的时候，都是开发人员手动操作，发布不同的环境可能需要切换不同的分支，这样不仅增加了重复性工作，也大大增加了出错的概率。

鉴于此，我们决定将小程序实现自动化，减少开发的工作量，提升工作效率。

工具介绍

要实现小程序的自动发布并不难，我们可以借助 miniprogram-ci 工具实现，在改工具之前，大佬们大都是自己开发各种自动化脚本，现在我们就不用那么麻烦了。

miniprogram-ci 是从微信开发工具中抽离的关于小程序/小游戏项目代码的编译模块，开发者可以不使用一些开发者工具，独立使用它就可以完成小程序代码的上传、预览等操作。其主要提供以下功能：

1. 上传代码，对应小程序开发者工具的上传。

2. 预览代码，对应小程序开发者工具的预览。

3. 构建 npm，对应小程序开发者工具的：菜单 - 工具 - 构建 npm。

4. 上传云开发云函数代码，对应小程序开发者工具的上传云函数能力。

5. 上传云托管代码，对应小程序开发者工具的上传云托管能力。

6. 上传云存储/静态托管文件，对应小程序开发者工具 - 云开发 - 云存储和静态托管文件管理。

7. 代理，配置 miniprogram-ci 的网络请求代理方式。

8. 支持获取最近上传版本的 sourceMap。

9. 支持 node 脚本调用方式和命令行调用方式。

前置工作

申请 APP ID

APP ID 是在微信后台申请，开发一般会提供。

制作构建镜像

要使用 miniprogram-ci ，需要我们安装该模块，安装命令如下：

npm install miniprogram-ci --save

为此，我们准备好具有 miniprogram-ci 命令的镜像。

FROM node:14.20.0-buster-slim
RUN apt update && \
    apt install curl  git -y && \
    npm install -g miniprogram-ci --registry=https://registry.npmmirror.com

然后制作镜像并推送到镜像仓库。

PS：根据实际情况选择 node 版本。

$ docker build -t registry.cn-hangzhou.aliyuncs.com/coolops/node:14.20.0-buster-slim .
$ docker push registry.cn-hangzhou.aliyuncs.com/coolops/node:14.20.0-buster-slim

Zadig 配置

前置条件

拥有可用的 Zadig 服务，版本>=1.15.0
已经关联好代码仓库

开始配置

1、添加构建镜像

在 Zadig 的系统配置 -> 构建镜像管理处添加上面制作出来的构建镜像，如下：

2、创建项目

在 Zadig 中，选择项目 -> 新建项目，添加一个小程序专属的项目，如下：

然后跳过向导，我们不需要环境，如下：

3、添加服务

添加服务的方式根据自己的情况来，不论是 YAML 项目还是 Helm Chart 项目，实际中我们都不会使用这些方式进行部署，随意选择就好，比如我这里选择的是 Helm Chart 项目。

之所以配置 Helm values，是为了让服务组件显示正常。

4、添加构建脚本

首先选择构建环境以及代码信息，如下：

我们选择的是自定义的构建镜像。

然后添加一个构建变量，该变量的作用是设定推送机器人编号，我定义为 ROBOT_NUM，如下：

我选择的是枚举类型，定义了三个机器人代码（机器人可选 1 ~ 30），如下：

最后，我们编写构建脚本，如下：


#!/bin/bash
set -e

cd ${SERVICE}
npm config set cache ${WORKSPACE}
npm install --registry=https://registry.npmmirror.com  && npm run build:weapp

APP_VERSION=$(grep -w 'version' dist/project.config.json | awk -F: '{print $2}' | grep -oP "[0-9].[0-9].[0-9]")
APP_DESC=$(grep -w 'description' dist/project.config.json | awk -F: '{print $2}'| sed 's/"//g' | sed 's/,//g')
WECHAT_APP_ID="xxxxx"

eval BRANCH=\${${REPO_0}_BRANCH}

echo "========================="
echo "version: ${APP_VERSION}"
echo "desc: ${APP_DESC}"
echo "branch: ${BRANCH}"
echo "robot: ${ROBOT_NUM}"
echo "========================="

# 推送
miniprogram-ci \
  upload \
  --pp ./dist \
  --pkp ./secret/private.${WECHAT_APP_ID}.key \
  --appid ${WECHAT_APP_ID} \
  -r ${ROBOT_NUM} \
  --enable-es6 true \
  --ud 发布分支:"${BRANCH}"发布描述:"${APP_DESC}" \
  --uv ${APP_VERSION}

注意：