feat: 新增 node-frontend-vite5 示例(Vite 5 + Vue 3,Tengine 托管)
This commit is contained in:
@@ -0,0 +1,4 @@
|
|||||||
|
dist/
|
||||||
|
node_modules/
|
||||||
|
.git/
|
||||||
|
.DS_Store
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
dist/
|
||||||
|
node_modules/
|
||||||
|
npm-debug.log*
|
||||||
@@ -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;"]
|
||||||
@@ -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
|
||||||
|
```
|
||||||
Executable
+11
@@ -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
|
||||||
@@ -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
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="zh-CN">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>node-frontend-vite5 | Vite 5 + Vue 3</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div id="app"></div>
|
||||||
|
<script src="/src/main.js" type="module"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
# node-frontend-vite5 站点:Tengine 3.1.0 托管 Vite 5 + Vue 3 构建产物(纯静态,无后端依赖)
|
||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
server_name _;
|
||||||
|
|
||||||
|
access_log /dev/stdout main;
|
||||||
|
|
||||||
|
root /usr/local/nginx/html;
|
||||||
|
index index.html;
|
||||||
|
|
||||||
|
# 静态资源带 hash,长缓存;index.html 每次重新验证,保证发版后立即生效
|
||||||
|
location /assets/ {
|
||||||
|
expires 30d;
|
||||||
|
add_header Cache-Control "public, immutable";
|
||||||
|
try_files $uri =404;
|
||||||
|
}
|
||||||
|
|
||||||
|
# 前端路由兜底:单页示例用不到,保留是为了以后切 history 模式时不用改配置
|
||||||
|
location / {
|
||||||
|
try_files $uri $uri/ /index.html;
|
||||||
|
}
|
||||||
|
|
||||||
|
# 健康检查:直接读 index.html
|
||||||
|
location = /healthz {
|
||||||
|
access_log off;
|
||||||
|
default_type text/plain;
|
||||||
|
return 200 "ok\n";
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
{
|
||||||
|
"name": "node-frontend-vite5",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"private": true,
|
||||||
|
"description": "Vite 5 + Vue 3 前端示例(对比 Vite 7),构建产物由 Tengine 托管",
|
||||||
|
"type": "module",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18.0.0"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"dev": "vite",
|
||||||
|
"build": "vite build",
|
||||||
|
"preview": "vite preview --port 4173"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"vue": "3.4.38",
|
||||||
|
"vue-router": "4.5.1"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@vitejs/plugin-vue": "5.1.4",
|
||||||
|
"vite": "5.4.21"
|
||||||
|
}
|
||||||
|
}
|
||||||
Executable
+4
@@ -0,0 +1,4 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -euo pipefail
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
docker-compose -f docker-compose.yml -p node-frontend-vite5-demo down
|
||||||
@@ -0,0 +1,74 @@
|
|||||||
|
<template>
|
||||||
|
<div class="app">
|
||||||
|
<header class="header">
|
||||||
|
<span class="logo">node-frontend-vite5</span>
|
||||||
|
<span class="tag">Vite 5 + Vue 3</span>
|
||||||
|
</header>
|
||||||
|
<main class="main">
|
||||||
|
<div class="grid">
|
||||||
|
<section class="card">
|
||||||
|
<h3 class="card-title">构建信息</h3>
|
||||||
|
<table class="kv">
|
||||||
|
<tbody>
|
||||||
|
<tr><th>Vite</th><td>{{ viteVersion }}</td></tr>
|
||||||
|
<tr><th>Vue</th><td>{{ vueVersion }}</td></tr>
|
||||||
|
<tr><th>Node 要求</th><td>Vite 5 支持 Node 18+(镜像用 22)</td></tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section class="card">
|
||||||
|
<h3 class="card-title">计数器</h3>
|
||||||
|
<p class="big">{{ count }}</p>
|
||||||
|
<button class="btn" @click="count -= 1">-1</button>
|
||||||
|
<button class="btn primary" @click="count += 1">+1</button>
|
||||||
|
<button class="btn" @click="count = 0">重置</button>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section class="card">
|
||||||
|
<h3 class="card-title">当前时间</h3>
|
||||||
|
<p class="big small">{{ clock }}</p>
|
||||||
|
<span class="hint">前端本地时间,不请求后端</span>
|
||||||
|
</section>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<section class="card">
|
||||||
|
<h3 class="card-title">构建环境变量(import.meta.env)</h3>
|
||||||
|
<table class="kv">
|
||||||
|
<tbody>
|
||||||
|
<tr><th>MODE</th><td>{{ env.MODE }}</td></tr>
|
||||||
|
<tr><th>PROD</th><td>{{ env.PROD }}</td></tr>
|
||||||
|
<tr><th>BASE_URL</th><td>{{ env.BASE_URL }}</td></tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</section>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<script setup>
|
||||||
|
import { onBeforeUnmount, onMounted, ref } from 'vue';
|
||||||
|
import { version as vueVersionValue } from 'vue';
|
||||||
|
|
||||||
|
// Vite 在构建时把 import.meta.env 静态替换成字面量,生产包里不会泄露其它环境变量
|
||||||
|
const env = import.meta.env;
|
||||||
|
const viteVersion = `5.4.21`;
|
||||||
|
const vueVersion = vueVersionValue;
|
||||||
|
|
||||||
|
const count = ref(0);
|
||||||
|
const clock = ref(format(new Date()));
|
||||||
|
let timer = null;
|
||||||
|
|
||||||
|
function format(d) {
|
||||||
|
const p = (n) => String(n).padStart(2, '0');
|
||||||
|
return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
onMounted(() => {
|
||||||
|
timer = setInterval(() => {
|
||||||
|
clock.value = format(new Date());
|
||||||
|
}, 1000);
|
||||||
|
});
|
||||||
|
|
||||||
|
onBeforeUnmount(() => clearInterval(timer));
|
||||||
|
</script>
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
import { createApp } from 'vue';
|
||||||
|
import App from './App.vue';
|
||||||
|
import './styles.css';
|
||||||
|
|
||||||
|
createApp(App).mount('#app');
|
||||||
@@ -0,0 +1,115 @@
|
|||||||
|
* {
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
|
||||||
|
html,
|
||||||
|
body,
|
||||||
|
#app {
|
||||||
|
height: 100%;
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif;
|
||||||
|
color: #303133;
|
||||||
|
background: #f5f7fa;
|
||||||
|
}
|
||||||
|
|
||||||
|
.header {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: 12px;
|
||||||
|
height: 56px;
|
||||||
|
padding: 0 20px;
|
||||||
|
background: #fff;
|
||||||
|
border-bottom: 1px solid #ebeef5;
|
||||||
|
}
|
||||||
|
|
||||||
|
.logo {
|
||||||
|
font-size: 18px;
|
||||||
|
font-weight: 600;
|
||||||
|
color: #42b883;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tag {
|
||||||
|
padding: 2px 8px;
|
||||||
|
border-radius: 10px;
|
||||||
|
background: #f0f9eb;
|
||||||
|
color: #67c23a;
|
||||||
|
font-size: 12px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.main {
|
||||||
|
padding: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.grid {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
|
||||||
|
gap: 16px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card {
|
||||||
|
padding: 20px;
|
||||||
|
background: #fff;
|
||||||
|
border: 1px solid #ebeef5;
|
||||||
|
border-radius: 4px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card + .card {
|
||||||
|
margin-top: 16px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-title {
|
||||||
|
margin: 0 0 16px;
|
||||||
|
font-size: 16px;
|
||||||
|
font-weight: 600;
|
||||||
|
}
|
||||||
|
|
||||||
|
.kv {
|
||||||
|
width: 100%;
|
||||||
|
border-collapse: collapse;
|
||||||
|
}
|
||||||
|
|
||||||
|
.kv th,
|
||||||
|
.kv td {
|
||||||
|
padding: 6px 12px;
|
||||||
|
border: 1px solid #ebeef5;
|
||||||
|
text-align: left;
|
||||||
|
}
|
||||||
|
|
||||||
|
.kv th {
|
||||||
|
width: 40%;
|
||||||
|
background: #fafafa;
|
||||||
|
}
|
||||||
|
|
||||||
|
.big {
|
||||||
|
margin: 0 0 12px;
|
||||||
|
font-size: 28px;
|
||||||
|
font-weight: 600;
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
}
|
||||||
|
|
||||||
|
.big.small {
|
||||||
|
font-size: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn {
|
||||||
|
margin-right: 8px;
|
||||||
|
padding: 6px 14px;
|
||||||
|
border: 1px solid #dcdfe6;
|
||||||
|
border-radius: 4px;
|
||||||
|
background: #fff;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn.primary {
|
||||||
|
color: #fff;
|
||||||
|
border-color: #42b883;
|
||||||
|
background: #42b883;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hint {
|
||||||
|
color: #909399;
|
||||||
|
font-size: 12px;
|
||||||
|
}
|
||||||
Executable
+5
@@ -0,0 +1,5 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -euo pipefail
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
docker-compose -f docker-compose.yml -p node-frontend-vite5-demo up -d
|
||||||
|
docker-compose -f docker-compose.yml -p node-frontend-vite5-demo ps
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
import { defineConfig } from 'vite';
|
||||||
|
import vue from '@vitejs/plugin-vue';
|
||||||
|
|
||||||
|
// 纯静态前端:产物由 Tengine 托管,base 用相对路径,部署到任意子路径都能跑
|
||||||
|
export default defineConfig({
|
||||||
|
plugins: [vue()],
|
||||||
|
base: './',
|
||||||
|
server: {
|
||||||
|
host: '0.0.0.0',
|
||||||
|
port: 5473,
|
||||||
|
},
|
||||||
|
build: {
|
||||||
|
outDir: 'dist',
|
||||||
|
sourcemap: false,
|
||||||
|
rollupOptions: {
|
||||||
|
output: {
|
||||||
|
manualChunks: {
|
||||||
|
vue: ['vue', 'vue-router'],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
});
|
||||||
Reference in New Issue
Block a user