logo
0
0
WeChat Login

我的知识库

个人技术知识库,系统化整理和分享学习工作中积累的技术经验。

部署状态 构建工具 框架


📚 内容概览

  • 🐧 Linux 运维:系统管理、磁盘操作、性能优化等实战经验
  • 🗄️ 数据库技术:MySQL、PostgreSQL、Redis 等数据库使用和优化
  • ☸️ 云原生:容器编排、微服务架构、云原生技术实践
  • 🌐 网络技术:网络协议、网络安全、故障排查等知识整理

🚀 技术栈

前端框架

  • VitePress v2.0.0-alpha.13 - 基于 Vite 和 Vue 的静态站点生成器
  • Vue v3.5.13 - 渐进式 JavaScript 框架

构建与部署

开发工具

  • Node.js v20 - JavaScript 运行时
  • npm - 包管理器

🏗️ 项目结构

My-Knowledge-Accumulation/ ├── docs/ # 文档源文件 │ ├── .vitepress/ # VitePress 配置 │ │ ├── config.ts # 站点配置(自动扫描目录) │ │ └── theme/ # 主题自定义 │ ├── linux/ # Linux 相关文档 │ ├── database/ # 数据库相关文档 │ ├── 云原生/ # 云原生相关文档 │ ├── network/ # 网络技术相关文档 │ ├── public/ # 静态资源 │ └── index.md # 首页 ├── .cnb.yml # CNB CI/CD 配置 ├── package.json # 项目依赖配置 ├── WRITING_GUIDELINES.md # 文档写作规范 └── README.md # 项目说明文档

🔧 本地开发

前置要求

  • Node.js >= 18
  • npm >= 9

安装依赖

npm install

启动开发服务器

npm run docs:dev

访问 http://localhost:5173 查看站点。

构建生产版本

npm run build

构建输出位于 docs/.vitepress/dist/ 目录。

本地预览构建结果

npm run docs:preview

🌐 部署架构

工作流程

开发者推送代码 ↓ CNB 代码仓库(Git) ↓ CNB CI/CD 自动触发 ↓ 构建环境(Node:20 Docker 容器) ├─ npm install(安装依赖) ├─ npm run build(VitePress 构建) └─ 生成静态文件(HTML/CSS/JS) ↓ EdgeOne Pages CLI 部署 ↓ 腾讯云 EdgeOne Pages ├─ 全球边缘节点分发 ├─ 智能路由加速 └─ HTTPS 自动配置 ↓ 用户访问(全球低延迟)

部署配置

CI/CD 配置文件.cnb.yml

main: push: - imports: https://cnb.cool/htazq/my-secrets/-/blob/main/envs.yml stages: # 构建阶段 - name: Build Current Project image: node:20 script: | node -v npm install npm run build # 部署阶段 - name: Deploy to EdgeOne Pages image: node:20 script: | npx edgeone pages deploy ./docs/.vitepress/dist \ -n cnb-my-knowledge-accumulation \ -t $EDGEONE_API_TOKEN

关键环境变量

  • EDGEONE_API_TOKEN:腾讯云 EdgeOne API 令牌(存储在私有仓库)

部署特性

  • 自动化部署:推送代码自动触发构建和部署
  • 全球 CDN 加速:利用腾讯云边缘网络,全球低延迟访问
  • HTTPS 支持:自动配置 SSL 证书
  • 版本控制:每次部署保留历史版本,支持快速回滚
  • 零停机部署:原子化部署,无服务中断

📝 内容贡献

添加新文档

  1. docs/ 目录下对应分类创建 .md 文件
  2. 遵循 文档写作规范
  3. VitePress 配置会自动扫描并生成导航和侧边栏

写作规范

详见 WRITING_GUIDELINES.md,核心要求:

  • 客观陈述,无第一/第二/第三人称
  • 准确严谨,避免浮夸表达
  • 步骤详细,代码可直接执行
  • 格式规范,中英文间正确添加空格

🔗 相关链接


📄 许可证

本项目内容采用 CC BY-NC-SA 4.0 许可协议。


最后更新:2025-11-18
维护者:htazq

About

我的知识累积

Language
Dockerfile94.2%
Shell5.8%