使用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
相关推荐
tryCbest6 小时前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js
anyup7 小时前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
Hilaku7 小时前
Claude Code 过夜跑长任务实战:tmux、权限、验收,以及我为什么换到 ApexOne
前端·javascript·程序员
程序员大阳8 小时前
副队长ES6+教程(14)--手写Promise来加深理解
前端·javascript·es6·源码·promise·手写·深层
程序员大阳8 小时前
副队长ES6+教程(11)--生成器 Generator
javascript·es6·生成器·generator
FungLeo8 小时前
成为全栈·Vue 管理后台篇·可折叠侧栏与移动抽屉:后台导航的响应式实现
前端·javascript·vue.js·侧边栏·响应式布局·无障碍·移动端导航
程序员大阳9 小时前
副队长ES6+教程(9)--Set 与 Map
javascript·es6·set·map·for of遍历
思特奇时空智能11 小时前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
FungLeo11 小时前
成为全栈·Vue 管理后台篇·Biome、类型检查、构建和API 代理如何组成质量门禁
前端·javascript·vue.js·typescript·vite·前端工程化·biome
程序员大阳11 小时前
副队长ES6+教程(10)--迭代器 Iterator 与 for...of
javascript·es6·遍历·for of