构建信息
+| Vite | {{ viteVersion }} |
|---|---|
| Vue | {{ vueVersion }} |
| Node 要求 | Vite 5 支持 Node 18+(镜像用 22) |
计数器
+{{ count }}
+ + + +当前时间
+{{ clock }}
+ 前端本地时间,不请求后端 +构建环境变量(import.meta.env)
+| MODE | {{ env.MODE }} |
|---|---|
| PROD | {{ env.PROD }} |
| BASE_URL | {{ env.BASE_URL }} |
diff --git a/demo/app/node-frontend-vite5/.dockerignore b/demo/app/node-frontend-vite5/.dockerignore new file mode 100644 index 0000000..89fe1f0 --- /dev/null +++ b/demo/app/node-frontend-vite5/.dockerignore @@ -0,0 +1,4 @@ +dist/ +node_modules/ +.git/ +.DS_Store diff --git a/demo/app/node-frontend-vite5/.gitignore b/demo/app/node-frontend-vite5/.gitignore new file mode 100644 index 0000000..1061ea7 --- /dev/null +++ b/demo/app/node-frontend-vite5/.gitignore @@ -0,0 +1,3 @@ +dist/ +node_modules/ +npm-debug.log* diff --git a/demo/app/node-frontend-vite5/Dockerfile b/demo/app/node-frontend-vite5/Dockerfile new file mode 100644 index 0000000..afdffb9 --- /dev/null +++ b/demo/app/node-frontend-vite5/Dockerfile @@ -0,0 +1,23 @@ +# 编译阶段:compile-node22(Vite 5 本身支持 Node 18+,这里统一用 node22 镜像) +FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-node22 AS build +WORKDIR /src + +COPY package.json package-lock.json* ./ +# npm 源由镜像的 /usr/local/node/etc/npmrc 指向 npmmirror,无需额外换源 +RUN npm install --no-audit --no-fund + +COPY . ./ +RUN npm run build && ls -lh dist/ dist/assets/ + +# 运行阶段:Tengine 3.1.0(自建 proxy-tengine3 镜像)托管静态文件 +FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:proxy-tengine3 AS runtime +LABEL MAINTAINER="tianjun@odboy.cn" +ENV TimeZone=Asia/Shanghai +# 站点配置与构建产物都放进镜像:conf.d/*.conf 由主配置 include,html/ 为站点根目录 +COPY nginx/node-frontend-vite5.conf /usr/local/nginx/conf/conf.d/node-frontend-vite5.conf +COPY --from=build /src/dist/ /usr/local/nginx/html/ +# 构建期自检:配置语法错误直接让镜像构建失败;纯静态站点没有上游主机名,nginx -t 可直接通过 +RUN /usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf +EXPOSE 80 +STOPSIGNAL SIGQUIT +CMD ["/usr/local/nginx/sbin/nginx", "-g", "daemon off;"] diff --git a/demo/app/node-frontend-vite5/README.md b/demo/app/node-frontend-vite5/README.md new file mode 100644 index 0000000..20b93dd --- /dev/null +++ b/demo/app/node-frontend-vite5/README.md @@ -0,0 +1,69 @@ +# node-frontend-vite5 示例 + +**Vite 5** + Vue 3 的前端项目,用来和 `node-frontend-vue3`(Vite 7)对照:同一套两阶段构建, +只把构建工具降一个大版本。**构建阶段**用 `compile-node22`,**运行阶段**以自建 `proxy-tengine3` 托管静态文件。 + +| 阶段 | 镜像 | 说明 | +| --- | --- | --- | +| 编译 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-node22` | Node 22 + npm(源为 npmmirror);Vite 5 本身支持 Node 18+ | +| 运行 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:proxy-tengine3` | Tengine 3.1.0,托管 `dist/` | + +纯前端项目:页面数据全部在浏览器内产生,不调用任何后端接口,部署只需要一个 Tengine 容器。 + +> 关于名字里的 “vite3”:Vite 3 已于 2022 年停止维护,且与当前 Node 22 组合缺少经过验证的插件版本; +> 这里按 **Vite 5** 实现(5.4.21),目录名保留 `vite5`。若必须用 Vite 3,请明确,我再降到对应依赖组合。 + +### 示例内容 + +``` +node-frontend-vite5/ +├── package.json # vue 3.4.38 / vue-router 4.5.1;vite 5.4.21 + plugin-vue 5.1.4 +├── vite.config.js # base: './';vue 单独拆包 +├── index.html +├── src/ +│ ├── main.js # createApp + mount +│ ├── App.vue # 单页:构建信息、计数器、时钟、import.meta.env 展示 +│ └── styles.css # 手写样式,不引 UI 库 +├── nginx/ +│ └── node-frontend-vite5.conf # Tengine 站点配置:静态托管 + /healthz +├── Dockerfile # 两阶段:compile-node22 -> proxy-tengine3 +├── build.sh # 构建镜像(PUSH=1 时同时推送) +├── docker-compose.yml # 只部署前端(端口 8092) +├── startup.sh / shutdown.sh +└── .dockerignore / .gitignore +``` + +### 构建与部署 + +```shell +sh build.sh # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-node-frontend-vite5 . +PUSH=1 sh build.sh # 构建并推送 +sh startup.sh # docker-compose -f docker-compose.yml -p node-frontend-vite5-demo up -d +``` + +访问 http://127.0.0.1:8092/ ;`curl http://127.0.0.1:8092/healthz` 返回 `ok`。 + +### 本地开发(不用 docker) + +```shell +npm install +npm run dev # http://127.0.0.1:5473 +``` + +### 关键点 + +**import.meta.env**:Vite 在构建时把 `import.meta.env.MODE/PROD/BASE_URL` 静态替换成字面量, +页面直接展示出来便于确认构建模式;生产包里不会带上其它环境变量。 + +**与 Vite 7 的差异**:配置项写法基本一致(`plugins` / `base` / `build.rollupOptions`), +主要区别是 Vite 5 对 Node 版本要求更低、以及 Vite 6+ 才有的 Environment API 等新特性在本示例中没用到。 + +**站点配置**:配置放在 `nginx/node-frontend-vite5.conf`,构建时 `COPY` 到 `/usr/local/nginx/conf/conf.d/`; +compose 把宿主机 `./nginx` 挂到同一个 `conf.d`,改完 `nginx -t && nginx -s reload` 生效。 +挂目录而不是单文件:单文件挂载编辑会换 inode,容器内看不到改动。 + +### 停止 + +```shell +sh shutdown.sh +``` diff --git a/demo/app/node-frontend-vite5/build.sh b/demo/app/node-frontend-vite5/build.sh new file mode 100755 index 0000000..3fb3555 --- /dev/null +++ b/demo/app/node-frontend-vite5/build.sh @@ -0,0 +1,11 @@ +#!/usr/bin/env bash +# 在示例目录下构建示例镜像(编译 + 运行两阶段均在本机 docker 内完成) +set -euo pipefail +cd "$(dirname "$0")" + +IMAGE=${IMAGE:-registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-node-frontend-vite5} +docker build -t "${IMAGE}" . + +if [ "${PUSH:-0}" = "1" ]; then + docker push "${IMAGE}" +fi diff --git a/demo/app/node-frontend-vite5/docker-compose.yml b/demo/app/node-frontend-vite5/docker-compose.yml new file mode 100644 index 0000000..c5d43e9 --- /dev/null +++ b/demo/app/node-frontend-vite5/docker-compose.yml @@ -0,0 +1,32 @@ +version: '3.8' + +# 网段避开其它示例(172.31.0/24 ~ 172.31.5/24 已被 go / rust / node-backend / vue2 / vue3 / react 占用) +networks: + node-frontend-vite5-demo: + ipam: + driver: default + config: + - subnet: "172.31.6.0/24" + +services: + frontend: + image: registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-node-frontend-vite5 # 镜像由 build.sh 构建 + container_name: node-frontend-vite5-demo + restart: unless-stopped + ports: # 映射端口:前端页面 + - "8092:80" + volumes: # 只挂载站点配置目录,改完 reload 即可,不必重建镜像 + # 挂目录而不是单文件:单文件挂载在宿主机上编辑会换 inode,容器内看不到改动 + - "./nginx:/usr/local/nginx/conf/conf.d" + environment: # 设置环境变量,相当于docker run命令中的-e + TZ: Asia/Shanghai + healthcheck: + # 运行镜像自带 net-tools,直接用端口探测 + test: ["CMD-SHELL", "netstat -tln | grep -q ':80 '"] + interval: 30s + timeout: 5s + retries: 3 + start_period: 5s + networks: + node-frontend-vite5-demo: + ipv4_address: 172.31.6.20 diff --git a/demo/app/node-frontend-vite5/index.html b/demo/app/node-frontend-vite5/index.html new file mode 100644 index 0000000..e5ce9fe --- /dev/null +++ b/demo/app/node-frontend-vite5/index.html @@ -0,0 +1,12 @@ + + +
+ + +| Vite | {{ viteVersion }} |
|---|---|
| Vue | {{ vueVersion }} |
| Node 要求 | Vite 5 支持 Node 18+(镜像用 22) |
{{ count }}
+ + + +{{ clock }}
+ 前端本地时间,不请求后端 +| MODE | {{ env.MODE }} |
|---|---|
| PROD | {{ env.PROD }} |
| BASE_URL | {{ env.BASE_URL }} |