小谈 ng deploy 的实现

Angular CLI 在 8.3.0 发布过一个新命令 ng deploy，可以将 Angular 应用部署到远程服务器或云存储上面，例如：Firebase hosting、Azure、GitHub pages 等等，这也是算是 Angular CLI 最后一个将 Angular 应用从开发到部署打通全能选手工具了。

快速入门

这里我以 ng-deploy-oss 为示例，演示如何将 Angular 应用部署到七牛云。

1、创建一个新项目

ng new hello-world --defaults

2、添加 ng-deploy-oss

ng add ng-deploy-oss

命令行会让你输入几个参数：

? 请选择云类型？ 七牛云
? 请输入 AccessKey： test
? 请输入 SecretKey： test
? 所在机房支持： qiniu.zone.Zone_z0 - 华东
? 请输入 Bucket： ng-test
? 请输入路径前缀，如果不指定表示放在根目录下： 
? 请输入构建生产环境的 NPM 命令行（例如：npm run build），若为空表示自动根据 angular.json 构建生成环境 
UPDATE angular.json (3925 bytes)
UPDATE package.json (1511 bytes)

3、部署

ng deploy

最后直接打开浏览器，就能直接访问 ng build --prod 后的效果。

原理

事实上，ng deploy 如同其他 Angular schematics 指令 ng add、ng g 等类同，我曾经在 浅谈 Angular Cli Schematics 针对 Schematics 做过介绍。要自定义一个 ng deploy 只需要完成两个部分：

• 编写 ng-add 来修改 angular.json 来告知使用哪个 Angular Libary 来部署；
• 编写上传动作 createBuilder。

ng-add

给 angular.json 增加 deploy 节点：

{
    "serve": {},
+    "deploy": {
+        "builder": "ng-deploy-oss:deploy",
+        "options": {}
+    }
}

以及 package.json 的 devDependencies 增加依赖包：

+ "ng-deploy-oss": "~1.0.0",

有兴趣可以参考 ng-deploy-oss 的 ng-add 的完整写法。

createBuilder

它是一个固定的方法：

export default createBuilder<any>(async (schema: {}, context: BuilderContext): Promise<BuilderOutput> => {
    return { success: true };
});

将所有上传相关的动作写至该方法内；它返回的是一个 Promise<BuilderOutput>，要告知 ng deploy 结束务必返回：return { success: true };。

如何部署至不同目标上

目前 ng deploy 只支持单个目标部署，有时多个远程部署也是刚需，比如像当你在做一个开源时总需要照顾国内、国外时，总是希望一份 gh-pages 和 七牛云（免费额度），我们只需要修改 angular.json：

{
    "serve": {},
+    "deploy-qiniu": {
+        "builder": "ng-deploy-oss:deploy",
+        "options": {}
+    },
+    "deploy-gh-pages": {
+        "builder": "angular-cli-ghpages:deploy",
+        "options": {}
+    }
}

注意：angular-cli-ghpages:deploy 引用的是 angular-cli-ghpages 依赖包。

然后使用 ng run 来调用这两种不同目标：

ng run <project name>:deploy-qiniu
ng run <project name>:deploy-gh-pages

结论

Angular 在国内有些小窘境，ng deploy 发布这么久，一直都没见到对国内一些云存储进行适配；事实上，直接利用 ng deploy 来部署应用至远程服务器上，可能在越来越多 Docker 应用后变得没那么重要，但对于常写开源的人来说，能够快速将 Angular 应用部署至国内常见的几个云存储上还是挺有意义的。

（完）