halo/docs
1
0
Fork 0
mirror of https://github.com/halo-dev/docs.git synced 2025-10-22 02:45:28 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
18bab504987fb5060ebabbcdd1261a94e75e8e60
docs/versioned_docs/version-1.4/getting-started/upgrade.md
Ryan Wang 4921736046 refactor: document versioning structure (#99) 
重构文档版本结构。

- 移除 1.5/1.4 相关所有 patch 版本的文档，使用 1.5/1.4 版本号代替。
- 创建 1.6 的文档版本。
- 后续针对 1.5 或者 1.6 的更新，可以直接对具体版本进行更改。

本打算使用 [@docusaurus/plugin-client-redirects](https://docusaurus.io/zh-CN/docs/api/plugins/@docusaurus/plugin-client-redirects) 做已删除的 patch 版本的重定向，旦可能不是很好满足匹配重定向的需求。~~所以在此 PR 合并之前我将通过 Nginx 对具体版本进行重定向转发~~。

比如：`/1.4.17/{path}` 重定向到 `/1.4/{path}`，`/1.5.4/{path}` `/1.5.3/{path}` 都从定向到 `/1.5/{path}`

/kind documentation
/cc @halo-dev/sig-docs 

> PS: 此 PR 未对新发布的 [1.6.0](https://github.com/halo-dev/halo/releases/tag/v1.6.0) [1.5.5](https://github.com/halo-dev/halo/releases/tag/v1.5.5) [2.0.0-alpha.2](https://github.com/halo-dev/halo/releases/tag/v2.0.0-alpha.2) 做修改，将在后续 PR 更改。

```release-note
None
```
2022-10-13 03:58:14 +00:00

2.7 KiB
Raw Blame History

title, description
title description
版本升级 版本升级指南

选择你部署的平台：

Linux

我们假设您存放运行包的路径为 ~/app，运行包的文件名为 halo.jar，如有不同，下列命令请按需修改。

:::tip 从 1.4.3 开始，Halo 最低支持的 JRE 版本为 11，在升级前，请务必先升级 JRE。 :::

:::info 如果当前您不方便升级到 11，我们推荐使用 Docker 运行新版 Halo，从 Jar 包的方式迁移到 Docker 运行非常方便，按照指南在创建容器的时候将容器内的 /root/.halo 目录映射到当前 Halo 的工作目录即可。 :::

  1. 停止正在运行的服务
service halo stop
  1. 备份数据以及旧的运行包（重要）
cp -r ~/.halo ~/.halo.1.4.16

cd ~/app && mv halo.jar halo.jar.1.4.16
  1. 下载最新版本的运行包
cd ~/app && wget https://dl.halo.run/release/halo-1.4.17.jar -O halo.jar

:::info 如果下载速度不理想，可以在这里选择其他下载地址。 :::

  1. 启动测试
java -jar halo.jar

:::info 如测试启动正常，请继续下一步。使用 CTRL+C 停止运行测试进程。 :::

  1. 重启服务
service halo start

Docker

我们假设您的容器是按照 使用 Docker 部署 Halo 中的命令构建的。如有不同，请根据实际情况修改。

  1. 停止并删除当前运行中的容器
docker stop halo

docker rm -f halo

:::info 你的容器名称不一定为 halo，在执行前可以先执行 docker ps -a 查看一下。 :::

  1. 备份数据（重要）
cp -r ~/.halo ~/.halo.1.4.16
  1. 拉取最新的 Halo 镜像
docker pull halohub/halo:1.4.17

:::info 查看最新版本镜像：https://hub.docker.com/r/halohub/halo ，我们推荐使用具体版本号的镜像，但也提供了 latest 标签的镜像，它始终是最新的。 :::

  1. 创建容器
docker run -it -d --name halo -p 8090:8090 -v ~/.halo:/root/.halo --restart=unless-stopped halohub/halo:1.4.17
  • -it： 开启输入功能并连接伪终端
  • -d： 后台运行容器
  • --name： 为容器指定一个名称
  • -p： 端口映射，格式为 主机(宿主)端口:容器端口 ，可在 application.yaml 配置。
  • -v： 工作目录映射。形式为：-v 宿主机路径:/root/.halo，后者不能修改。
  • --restart： 建议设置为 unless-stopped，在 Docker 启动的时候自动启动 Halo 容器。