使用docker 部署 vitepress

vitepress版本等信息

json 复制代码
{
  "devDependencies": {
    "less": "^4.2.0",
    "markdown-it": "^13.0.2",
    "markdown-it-container": "^3.0.0",
    "markdown-it-mathjax3": "^4.3.2",
    "postcss": "^8.4.31",
    "vite-plugin-svg-icons": "^2.0.1",
    "vitepress": "^1.0.0-rc.24",
    "vitepress-plugin-sandpack": "^1.1.4"
  },
  "dependencies": {
    "element-plus": "^2.4.2",
    "markdown-it-custom-attrs": "^1.0.2",
    "unocss": "^0.57.7",
    "viewerjs": "^1.11.6"
  },
  "engines": {
    "node": ">19"
  }
}
复制代码
node 版本号: 20.9.0

脚本文件

创建核心的3个文件

  • Dockerfile
  • .dockerignore
  • nginx.conf

Dockerfile

Dockerfile 复制代码
FROM node:20.9.0
WORKDIR /app
COPY package.json ./
RUN npm install -g pnpm && pnpm install
RUN echo "依赖安装完成..."
COPY . .

RUN echo '开始build'
RUN pnpm run docs:build
RUN echo '---build 完成---'

FROM nginx:latest

RUN echo '拷贝dist到 nginx目录'
COPY --from=0 /app/dist /usr/share/nginx/html
COPY --from=0 /app/nginx.conf /etc/nginx/conf.d/default.conf

我这里docker 指令 copy的 dist 目录是在根目录, 也就是 npm run docs:build 执行的时候, dist 文件夹 是在项目根目录, 默认是生成在 .vitepress/dist, 需要调整一下vitepress的配置文件即可

.vitepress/config.js

js 复制代码
import { defineConfig } from 'vitepress'
import { fileURLToPath } from 'node:url'

export default defineConfig({
   // 排除不打包的目录
  srcExclude: ["./source-doc/**", 'README.md', 'Dockerfile', 'nginx.conf', '.dockerignore'],

  // 打包输出目录, 默认是 .vitepress/dist
  outDir: fileURLToPath(new URL('../dist', import.meta.url)),
})

以下内容,不需要copy进docker, 忽略, 上面copy使用的是 copy . . 表示把当前目录所有的文件都copy进设置的工作目录 /app。 这里忽略,就会跳过这些内容

.dockerignore

复制代码
node_modules
.git
scripts
source-doc
README.md
dist

nginx配置

nginx.conf

nginx 复制代码
server {
  listen 80;
  server_name localhost;

  location / {
    root /usr/share/nginx/html;
    index index.html;
    # 对于vue或者React项目,使用 history路由需要
    try_files $uri $uri/ /index.html;
  }

  location = 50x.html {
    root /usr/share/nginx/html;
  }
}

构建镜像

使用 docker 可以直接构建镜像

shell 复制代码
docker build -t vitepress-doc .

启动

shell 复制代码
docker run -itd -p 8001:80 --name vitepress-doc vitepress-doc

打开浏览器地址

arduino 复制代码
http://localhost:8001
相关推荐
彩虹暴龙兽2 小时前
JavaScript 预编译机制与执行上下文构建分析
javascript
tryCbest2 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai2732 小时前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
bai2733 小时前
同一个 1.005,toFixed 给 1.00、Math.round 给 1、Intl 给 1.01:999 个三分位小数的实测
javascript·后端
爱编程的173 小时前
一篇讲透 JS 对象:数据类型、原型链与包装类
javascript
Highcharts.js9 小时前
Highcharts漏斗图表使用配置指南
java·开发语言·javascript·信息可视化·highcharts·漏斗图
武昌库里写JAVA13 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai
Lanwarf-前端开发14 小时前
Vue3 + Canvas/WebGL 雷达扫描可视化实战:PPI、RHI、VOL、SVOL 四种模式原理与实现
前端·javascript·vue.js·webgl
FRing0315 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
YIAN17 小时前
从 LangChain 到 DeepAgents:手把手拆解 createAgent、Middleware 与复杂 Agent
javascript·langchain·deepseek