优维低代码：定制构件的打包及部署

优维低代码技术专栏， 是一个全新的、技术为主的专栏，由优维技术委员会成员执笔，基于优维7年低代码技术研发及运维成果，主要介绍低代码相关的技术原理及架构逻辑，目的是给广大运维人提供一个技术交流与学习的平台。

• • -

    连载第四十五期

    《现场定制： 定制构件的打包及部署 》

    ▽

    # 打包

    对于用 create-next-repo 脚手架生成的仓库，我们提供了一个简单的命令去打包对应的构件库。在项目根目录下直接运行l erna run pack:tar --scope=YOUR-BRICKS-OR-MICRO-APPS , 执行后会在对应的库目录下生成最终的 tar 包。如：

• 打包 micro-apps/hello-world： lerna run pack:tar --scope=@micro-apps/hello-world ，生成的 tar 包在 micro-apps/hello-world/hello-world-NA.tar.gz

• 打包 bricks/hello-world： lerna run pack:tar --scope=@bricks/hello-world ，生成的 tar 包在 bricks/hello-world/hello-world-NB.tar.gz

  但在执行打包命令之前，建议你先排查依赖是否声明准确，brick_next 对依赖的管理相当严格，不然会是一堆的报错。详细见下文

  # 包的命名及部署规范

• micro-apps 打出来的包后缀是叫 -NA ，部署路径在 /usr/local/easyops/applications/xxxx
• bricks 打出来的包后缀是叫 -NB ，部署路径在 /usr/local/easyops/bricks/xxxx

• templates 打出来的包后缀叫 -NT ，部署路径在 /usr/local/easyops/templates/xxxx

  # 可能出现的错误

  micro-apps 打包报依赖错误

请检查：

1. storyboard.json 的一级字段 imports 有没都加入相关的构件依赖声明
2. 在 micro-apps/you-micro-app-name/package.json 中的 peerDependencies 也需要加上对应构件的版本依赖，如果不知道构件版本，可写成 >1.0.0

3. 在项目的顶级 package.json 中的 devDependencies 也需要加上对应的字段，如果不知道构件版本，可写成 >1.0.0

   最终效果见

# 部署

# 手工部署

将打好的包上传到机器，如上传到 /tmp/hello-world-NA.tgz

如果是 -NA 包（micro-apps）：

cd /usr/local/easyops/applications && mkdir hello-world-NA
# 由于 npm 打包原因，注意第一层目录是叫 package，故要忽略第一级目录
tar -zxvf /tmp/hello-world-NA.tgz --strip-components 1 -C hello-world-NA
chown -R easyops:easyops hello-world-NA
cd hello-world-NA && bash deploy/install_postscript.sh

如果是 -NB 包（bricks）

cd /usr/local/easyops/bricks && mkdir hello-world-NB
# 由于 npm 打包原因，注意第一层目录是叫 package，故要忽略第一级目录
tar -zxvf /tmp/hello-world-NB.tgz --strip-components 1 -C hello-world-NB
chown -R easyops:easyops hello-world-NB
cd hello-world-NB && bash deploy/install_postscript.sh

如果是 -NT 包（templates）

cd /usr/local/easyops/templates && mkdir hello-world-NT
# 由于 npm 打包原因，注意第一层目录是叫 package，故要忽略第一级目录
tar -zxvf /tmp/hello-world-NT.tgz --strip-components 1 -C hello-world-NT
chown -R easyops:easyops hello-world-NT
cd hello-world-NT && bash deploy/install_postscript.sh

# 平台部署

1. 将包上传到平台的程序包，注意要包名和部署路径要遵循 包的命名及部署规范
2. 建立对应的应用，并绑定第 1 步的程序包（建议应用名与包名一致）
3. 在应用设置里面，新建集群及关联平台的相关主机（如果是集群部署，将部署了 brick_next 组件的 ip 都勾选上，一般是 2~3 台）
4. 执行主机部署