跳到主要内容

部署

Node.js 部署是 Analog 为生产环境构建的默认预设输出。

在默认预设情况下运行 npm run build 时，编译结果就是一个 ready-to-run 的 Node 服务器器入口。

要单独启动这个服务，可以运行：

$ node dist/analog/server/index.mjs
Listening on http://localhost:3000

环境变量​

你可以用下面的环境变量自定义一些服务器行为：

  • NITRO_PORT or PORT (defaults to 3000)
  • NITRO_HOST or HOST

内置的预设​

Analog 可以一套代码为不同的 主机托管商 提供相应的输出格式，你可以通过环境变量或者 vite.config.ts 修改部署预设。

以来 CI/CD 的部署建议使用环境变量。

例如: 使用 BUILD_PRESET

BUILD_PRESET=node-server

例如: 使用 vite.config.ts

import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [
    analog({
      nitro: {
        preset: 'node-server',
      },
    }),
  ],
});

部署时自定义 URL 前缀​

如果你部署是需要指定一个自定义的 URL 前缀，例如 https://domain.com/`basehref`/ 你必须确保 服务端数据获取，HTML 标记和资源 和 动态 API 路由 能在 basehref 下正常工作。

  1. 指示 Angular 识别并生成对应的 URL。创建一个新的文件 app.config.env.ts。
import { ApplicationConfig } from '@angular/core';
import { APP_BASE_HREF } from '@angular/common';

export const envConfig: ApplicationConfig = {
  providers: [{ provide: APP_BASE_HREF, useValue: '/basehref/' }],
};
  1. 更新 app.config.ts 去导入这个新的文件
import { mergeApplicationConfig } from '@angular/core';
import { envConfig } from './app.config.env';

export const appConfig = mergeApplicationConfig(envConfig, {
....
});
  1. 在 CI 生产环境构建
  # sets the base url for server-side data fetching
  export VITE_ANALOG_PUBLIC_BASE_URL="https://domain.com/basehref"
  # prefixes all assets and html with /basehref/
  npx nx run appname:build:production --baseHref='/basehref/'
  1. 在生产环境的镜像指定新的环境变量。
NITRO_APP_BASE_URL="/basehref/"

vite.config.ts 文件类似的配置：

    plugins: [
      analog({
        apiPrefix: 'api',

Nitro 所有的 API 路由将基于 /basehref/api 。