Xu ShengXu Sheng

正确的工具、正确的方法、正确的方向,才能做正确的事情。

使用 docker 快速部署 hexo 博客

2018年8月20日博客984 words in 7 min

hexo 是一款静态博客工具,不涉及到任何后端、数据库啥的。

也就是说不管过程中怎么乱七八糟的捣鼓,最终其实在部署的时候需要使用的,其实就是一堆前端静态资源,htmljscssjpg 等等,也就是使用 hexo g 命令生成出来的 public 文件夹中所包含的部分。

那么通常来讲,对于没有个人服务器的同学来说,一般是使用 github page 的功能来将静态页面托管到 github 上,但是由于国内 github 速度感人,使用起来并不是那么顺畅。

如果有个人服务器的话,我们可以使用 nginx 作为静态资源服务器,来快速部署我们的博客。

下面将介绍如何利用 dockernginx 镜像来快速部署博客。

一、服务器安装 docker 环境

1. 安装 docker

参考: 在 linux、mac 下快速简单的安装 docker

2. 安装 docker-compose

docker-compose 并不是必须使用的,这里是为了更方便的管理我们的容器。

macos 下安装 docker 时自动就安装了 docker-composelinux 则需要使用下面的命令手动安装一下。

1
2
$ curl -L https://github.com/docker/compose/releases/download/1.8.0/run.sh > /usr/local/bin/docker-compose
$ chmod +x /usr/local/bin/docker-compose

二、初始化博客

使用 npm i -g hexo-cli 命令全局安装 hexo-cli,然后使用 hexo init blog 即可生成一个最简单的博客项目了。

然后在项目中新建一个 .npmrc 文件,将 registry=https://registry.npm.taobao.org 写入文件中,这个的作用是在安装依赖包将镜像源切换为国内的淘宝源。

此时可以执行 hexo s 命令后,在浏览器中访问 http://localhost:4000,就可以看到博客的页面了。
hexo s 启动

三、添加 Dockerfile 文件

这里需要理清楚思路的一点是,整个部署流程我们分为两个阶段,第一个阶段是生成静态文件,也就是使用 hexo g 命令生成 public 文件夹,此过程依赖 nodejs 环境,而第二个阶段则是启动 nginx

两个阶段我们会使用 dockerfile 的多阶段构建来实现,第一个阶段的 nodejs 容器中生成的 public 文件夹会被拷贝到第二个阶段的 nginx 容器中使用,最终生成的是一个包含了博客静态资源和 nginx 的镜像。

Dockerfile 文件如下

1
2
3
4
5
6
7
8
9
10
11
# /Dockerfile
FROM node:8-alpine as builder
WORKDIR /project
COPY . /project/
RUN yarn \
&& yarn global add hexo-cli \
&& hexo g

FROM nginx:alpine
COPY --from=builder /project/public /usr/share/nginx/html
RUN apk add --no-cache bash

因为是使用的 alpine 版本的镜像,并没有安装 bash,所有在部署完成后无法通过 docker exec -it xx bash 进入容器中,所以加上了一行 apk add --no-cache bash,如果没有后期进入容器的需求,可以删除这一行,提高构建时的速度。

三、添加 docker-compose.yml 文件

其实不使用 docker-compose,直接 docker run 也是可以的,但是使用 docker-compose 更方便管理,也更加直观一点。

新建 docker-compose.yml 文件:

1
2
3
4
5
6
7
8
9
10
11
# /docker-compose.yml
version: '3'
services:
app:
container_name: blog
build:
context: ./
dockerfile: ./ci/Dockerfile
ports:
- "8080:80"
restart: on-failure

上述文件中指定了 容器名字Dockerfile 以及需要映射到宿主机的哪个 端口 上,可以根据自己的需求自行调整。

构建并运行容器

在项目目录下执行命令 docker-compse up --build -d,然后在浏览器中访问 https://localhost:8080,如果看到博客页面了,部署就大功告成啦。
docker-compose

如果对你有帮助,不如请我喝一杯星爸爸,或者留言鼓励下我哦 😘 ☕.