90 lines
2.2 KiB
Markdown
90 lines
2.2 KiB
Markdown
# Knowai Base 镜像维护文档
|
||
|
||
## 分支职责
|
||
负责统一 Nuxt 运行环境与框架生态依赖。
|
||
不包含任何业务代码或配置，仅提供基础依赖环境。
|
||
|
||
## 镜像标签命名规范
|
||
- 格式：`gitea.local.knowai.fun/tobegold574/knowai-base:主版本号.次版本号.修订号`
|
||
- 示例：`gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0`
|
||
- 版本规则：
|
||
- 主版本号：不兼容的框架或依赖变更
|
||
- 次版本号：兼容性增强或批量依赖升级
|
||
- 修订号：小幅依赖更新或新增兼容依赖
|
||
- `latest` 标签默认指向当前稳定版本（谨慎更新）
|
||
|
||
## 基础环境
|
||
- Node.js LTS（Debian trixie-slim）
|
||
- pnpm（包管理器）
|
||
- 系统工具：git、curl、ca-certificates
|
||
|
||
## 全局依赖（长期不变部分）
|
||
### 核心框架
|
||
- nuxt@latest
|
||
- vue@latest
|
||
- vue-router@latest
|
||
|
||
### 状态管理
|
||
- @pinia/nuxt
|
||
- @pinia/plugin-persistedstate
|
||
|
||
### UI组件库
|
||
- @element-plus/nuxt
|
||
- @element-plus/icons-vue
|
||
|
||
### 样式与构建
|
||
- @nuxtjs/tailwindcss
|
||
- @nuxt/image
|
||
- @nuxt/icon
|
||
- @nuxtjs/color-mode
|
||
- @nuxtjs/component-cache
|
||
|
||
### 网络请求
|
||
- axios
|
||
- node-fetch
|
||
- socket.io-client
|
||
|
||
### 工具库
|
||
- @vueuse/core
|
||
- lodash
|
||
- dayjs
|
||
- crypto-js
|
||
|
||
## 使用方式
|
||
其他分支的 Dockerfile：
|
||
```dockerfile
|
||
FROM gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0
|
||
WORKDIR /usr/src/app
|
||
# 添加业务代码与依赖
|
||
```
|
||
|
||
### 构建命令
|
||
`docker build -t gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0 .`
|
||
`docker push gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0`
|
||
|
||
## 镜像分层说明
|
||
Base层仅包含：
|
||
- Node.js 运行环境
|
||
- 核心框架依赖（Vue、Nuxt、Vue Router）
|
||
- 基础状态管理的集成模块（Pinia）
|
||
- 基础UI组件库的集成模块（Element Plus, tailwindcss）
|
||
- 常用工具库
|
||
|
||
其他依赖（如测试工具、开发工具等）应在各自层中按需添加，避免Base镜像臃肿。
|
||
|
||
## 更新记录
|
||
|
||
### 2025-10-29
|
||
- 创建基础架构分支
|
||
- 初始化Nuxt3项目结构
|
||
|
||
### 2025-11-4
|
||
- 删除项目代码以及CI pipeline
|
||
- 重新构建base镜像1.0.0版本
|
||
- 重新确定该分支职责
|
||
|
||
### 2025-11-27
|
||
- 修正文档
|
||
|
||
---
|
||
*仅负责全局性依赖更新，业务功能在各功能分支独立开发，构建独立镜像* |