构建和发布

构建

当项目开发完毕，只需要运行一行命令就可以打包你的应用：

npm run build

NG-ALAIN 本身是一个 Angular CLI 项目，因此也可以参照 Build 完成更复杂的构建需求。构建打包成功之后，会在根目录生成 dist 文件夹，里面就是构建打包好的文件，包含若干 *.js、*.css、index.html 等静态文件。

JavaScript heap out of memory

避免执行 ng build 时抛出 JavaScript heap out of memory：

{
  "scripts": {
    "build": "node --max_old_space_size=5120 ./node_modules/@angular/cli/bin/ng build"
  }
}

环境变量

当你需要区别开发和部署以及测试环境的时候，可以通过 src/environments 文件夹根据不同环境配置相应的参数，配置项同时也可以在应用当中直接调用它们。同时，还需要配置 angular.json 内的配置项，最后你可以透过命令改变环境配置。

分析构建文件体积

如果构建文件很大，可以通过 analyze 命令构建并分析依赖模块的体积分布，从而优化你的代码。

npm run analyze

查看分析页：

npm run analyze:view

发布

对于发布来讲，只需要将最终生成的静态文件，也就是通常情况下 dist/browser 文件夹的静态文件发布到你的 cdn 或者静态服务器即可，需要注意的是其中的 index.html 通常会是你后台服务的入口页面，在确定了 js 和 css 的静态之后可能需要改变页面的引入路径。

如果你的静态资源是部署到其他域名（例如独立的 cdn 地址），你可以透过 --base-href 参数指定一个 cdn 地址。

ng build --base-href=https://cdn.ng-alain.com/

路由策略

Angular 前端路由有两种不同策略 HashLocationStrategy 和 PathLocationStrategy。前者是以 # 后面的路径进行路由处理，通过 HTML5 History 进行前端路由管理，而后者则是类似页面访问路径并没有 #，通过服务端的配置，能够访问指定 URL 都定向到当前页面，从而能够进行前端路由管理。

如果你想采用 PathLocationStrategy 策略，则需要将 ./src/app/routes/routes.module.ts 的 RouterModule.forRoot(routes, { useHash: true }) 换成 RouterModule.forRoot(routes)。同时需要服务端做一个映射，比如：

express 的例子：

app.use(express.static(path.join(__dirname, 'build')));

app.get('/*', function (req, res) {
  res.sendFile(path.join(__dirname, 'build', 'index.html'));
});

egg 的例子：

// controller
exports.index = function* () {
  yield this.render('App.jsx', {
    context: {
      user: this.session.user,
    },
  });
};

// router
app.get('home', '/*', 'home.index');

有关更多 Angular 路由相当问题，请阅读官网。

Docker

NG-ALAIN 提供了一个基于 nginx WEB服务完整的构建Angular项目的镜像文件。其中 nginx 是采用 nginx:1.13.5-alpine 的镜像，基本上可以满足 NG-ALAIN 项目的良好运行环境，倘若有更多需求，你可以利用 docker run 轻易的指定 nginx.conf。

1、构建镜像

根据 Dockerfile 构建一个完整的 NG-ALAIN 所需要的运行环境的镜像。

docker build -t ng-alain .

2、运行

基于compose（推荐）

docker-compose up -d

其细节可以通过 docker-compose.yml 修改。

基于命令式

docker run -d -p 80:80 --name alain ng-alain

最后你可以访问：http://localhost/

3、关于SSL

NG-ALAIN 提供的 Dockerfile 文件相对于比较简单，而实际项目中最常用的是对SSL的支持。

因此，默认情况下你可以将证书放置 _nginx/ssl 目录下，并开启 _nginx/default.conf 相关SSL配置项即可。

最后，增加 docker-compose.yml 的 ports 节点：

- 443:443

容器部署

参考 Angular 容器部署。