Analog
On this page

部署

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

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

部署时自定义 URL 前缀

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

  1. 更新你的 vite.config.ts 文件。
export default defineConfig(({ mode }) => ({
  base: '/basehref',
  plugins: [
    analog({
      ...(mode === 'production'
        ? { apiPrefix: 'basehref' }
        : { apiPrefix: 'basehref/api' }),
      prerender: {
        routes: async () => {
          return [];
        },
      },
    }),
  ],
}));
  1. 更新 app.config.ts 文件。

这里告知 Angular 如何识别并生成对应的 URL。

export const appConfig: ApplicationConfig = {
  providers: [
    [{ provide: APP_BASE_HREF, useValue: import.meta.env.BASE_URL || '/' }],
    ...
  ],
};
  1. HttpClient 使用 injectAPIPrefix()。
const response = await firstValueFrom(
  this.httpClient.get<{ client: string }>(`${injectAPIPrefix()}/v1/hello`),
);
  1. 在 CI 生产环境构建

不要设置 VITE_ANALOG_PUBLIC_BASE_URL，它应该使用 vite.config.ts 中的设置。 如果构建期间存在 VITE_ANALOG_PUBLIC_BASE_URL，ssr 数据将在服务器和客户端上重新获取。

  # if using nx:
  npx nx run appname:build:production
  # if using angular build directly:
  npx vite build && NITRO_APP_BASE_URL='/basehref/' node dist/analog/server/index.mjs
  1. 在生产环境的镜像指定环境变量 NITRO_APP_BASE_URL。
NITRO_APP_BASE_URL="/basehref/"
  1. 本地预览：
npx vite build && NITRO_APP_BASE_URL='/basehref/' node dist/analog/server/index.mjs