Docker-Reference(速查神器)

**相关链接：**
---
- 原版(英文)：
	- 在线使用：https://cheatsheets.zip/
	- GitHub：https://github.com/Fechin/reference
- 中文版：
	- 在线使用：https://jaywcjlove.github.io/reference
	- GitHub：https://github.com/jaywcjlove/reference
	- Docker：https://hub.docker.com/r/wcjiang/reference
	- 部署教程：https://github.com/jaywcjlove/reference/issues/102
	- 官方静态文件：https://github.com/jaywcjlove/reference/tree/gh-pages

## [中文版](https://github.com/jaywcjlove/reference)
### Docker 部署
```bash
docker run --name reference -itd -p 9667:3000 wcjiang/reference:latest  # 拉取并部署
  # registry.cn-beijing.aliyuncs.com/deanmr/reference:latest  # 备用镜像
```
访问地址：http://localhost:9667/

### 使用官方静态
```bash
git clone https://github.com/jaywcjlove/reference.git -b gh-pages
# OR
git clone https://gitee.com/jaywcjlove/reference.git -b gh-pages
```
拉取后直接 Nginx部署 即可

### 自编译构建
也可直接使用 [官方 gh-pages](https://github.com/jaywcjlove/reference/tree/gh-pages) 不需要自行构建
```bash
git clone https://github.com/jaywcjlove/reference.git  # 拉取最新项目
nano Dockerfile  # 创建构建文件
docker build -t reference .  # 构建镜像
docker run -it --name reference -p 9667:80 reference  # 部署镜像

docker cp reference:/usr/share/nginx/html .  # 复制静态文件到本地(方便Nginx部署)
```

`Dockerfile` 构建文件
```yaml
############################# 分步构建(构建镜像较小) #############################
# 第一阶段：构建阶段
FROM node AS build
# 设置工作目录
WORKDIR /usr/src/app
# 复制项目文件到工作目录(预先拉取项目,文件夹名为 reference-main)
COPY ./reference* .
# 安装项目依赖项,运行构建命令来生成静态文件
RUN npm install && npm run build

# 第二阶段：部署阶段
FROM nginx:alpine AS deploy
# 设置工作目录
WORKDIR /usr/share/nginx/html
# 从构建阶段复制静态文件
COPY --from=build /usr/src/app/dist .
# 对外暴露端口
EXPOSE 80
# 运行Nginx服务
CMD ["nginx", "-g", "daemon off;"]
```
`.env` 配置文件,需要使用 `touch .env` 添加环境变量
```bash
# 提供自定义菜单
REF_URL=http://ref.xxx.cn/
REF_LABEL=网站首页
# 页脚添加 (支持 HTML 字符串)
REF_FOOTER=备案号：沪ICP备20220000000号-1
# 修改版权信息 (支持 HTML 字符串)
LICENSE=Copyright (c) <b>2022</b> 小弟调调™
```

## [原版(英文)](https://github.com/Fechin/reference)
```bash
git clone https://github.com/Fechin/reference.git  # 拉取最新项目
nano Dockerfile  # 创建构建文件
docker build -t reference .  # 构建镜像
docker run -it --name reference -p 9667:80 reference  # 部署镜像

docker cp reference:/usr/share/nginx/html .  # 复制静态文件到本地(方便Nginx部署)
```
访问地址：http://localhost:9667/

`Dockerfile` 构建文件
```yaml
############################# 分步构建(构建镜像较小) #############################
# 第一阶段：构建阶段
FROM node AS build
# 设置工作目录
WORKDIR /usr/src/app
# 复制项目文件到工作目录(预先拉取项目,文件夹名为 reference-main)
COPY ./reference* .
# 安装项目依赖项,运行构建命令来生成静态文件
RUN npm install && npm run build

# 第二阶段：部署阶段
FROM nginx:alpine AS deploy
# 设置工作目录
WORKDIR /usr/share/nginx/html
# 从构建阶段复制静态文件
COPY --from=build /usr/src/app/public .
# 对外暴露端口
EXPOSE 80
# 运行Nginx服务
CMD ["nginx", "-g", "daemon off;"]

# ############################# 测试使用(构建镜像较大) #############################
# # 使用官方Node.js运行时作为父镜像
# FROM node
# # 设置工作目录
# WORKDIR /usr/src/app
# # 复制项目文件到工作目录
# COPY ./reference* .
# # 安装项目依赖项
# RUN npm install
# # 对外暴露端口
# EXPOSE 4000
# # 运行应用
# CMD ["npm", "run", "dev"]
```

**相关教程：**
[Docker自建一款开源&实用的运维开发速查表神器](https://mp.weixin.qq.com/s/YiareZbS0f823fWERQWT4A)