From 42206e7b15dbab1299a34c80e0cbd29d8a8731a6 Mon Sep 17 00:00:00 2001 From: Ryan Wang Date: Tue, 7 Nov 2023 15:15:28 +0800 Subject: [PATCH] docs: improve backup instructions in upgrade documentations (#274) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 优化版本升级的备份说明，统一改为使用系统提供的备份功能，而不是手动操作工作目录。 ```release-note None ``` --- .../getting-started/install/docker-compose.md | 21 ++----------------- docs/getting-started/install/docker.md | 13 +++--------- docs/getting-started/install/podman.md | 20 ++++++------------ .../getting-started/install/docker-compose.md | 21 ++----------------- .../getting-started/install/docker.md | 13 +++--------- .../getting-started/install/podman.md | 20 ++++++------------ 6 files changed, 22 insertions(+), 86 deletions(-) diff --git a/docs/getting-started/install/docker-compose.md b/docs/getting-started/install/docker-compose.md index 8834921..0ebef57 100644 --- a/docs/getting-started/install/docker-compose.md +++ b/docs/getting-started/install/docker-compose.md @@ -247,21 +247,8 @@ import DockerArgs from "./slots/docker-args.md" ## 更新容器组 -1. 停止运行中的容器组 - - ```bash - cd ~/halo && docker-compose down - ``` - -2. 备份数据（重要） - - ```bash - cp -r ~/halo ~/halo.archive - ``` - - > 需要注意的是，`halo.archive` 文件名不一定要根据此文档命名，这里仅仅是个示例。 - -3. 更新 Halo 服务 +1. 备份数据，可以参考 [备份与恢复](../../user-guide/backup.md) 进行完整备份。 +2. 更新 Halo 服务 修改 `docker-compose.yaml` 中配置的镜像版本。 @@ -272,10 +259,6 @@ import DockerArgs from "./slots/docker-args.md" container_name: halo ``` - ```bash - docker-compose pull halo - ``` - ```bash docker-compose up -d ``` diff --git a/docs/getting-started/install/docker.md b/docs/getting-started/install/docker.md index 912a678..99c187a 100644 --- a/docs/getting-started/install/docker.md +++ b/docs/getting-started/install/docker.md @@ -67,27 +67,20 @@ import DockerArgs from "./slots/docker-args.md" ## 升级版本 -1. 拉取新版本镜像 +1. 备份数据，可以参考 [备份与恢复](../../user-guide/backup.md) 进行完整备份。 +2. 拉取新版本镜像 ```bash docker pull halohub/halo:2.10 ``` -2. 停止运行中的容器 +3. 停止运行中的容器 ```bash docker stop halo docker rm halo ``` -3. 备份数据（重要） - - ```bash - cp -r ~/.halo2 ~/halo2.archive - ``` - - > 需要注意的是，`halo2.archive` 文件名不一定要根据此文档命名，这里仅仅是个示例。 - 4. 更新 Halo 修改版本号后，按照最初安装的方式，重新创建容器即可。 diff --git a/docs/getting-started/install/podman.md b/docs/getting-started/install/podman.md index cd0480c..48ad43f 100644 --- a/docs/getting-started/install/podman.md +++ b/docs/getting-started/install/podman.md @@ -93,35 +93,27 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简 ## 升级版本 -1. 拉取新版本镜像 +1. 备份数据，可以参考 [备份与恢复](../../user-guide/backup.md) 进行完整备份。 +2. 拉取新版本镜像 ```bash podman pull halohub/halo:2.10 ``` -2. 停止运行中的容器 +3. 停止运行中的容器 ```bash podman stop halo podman rm halo ``` -3. 备份数据（重要） - - ```bash - cp -r ~/.halo2 ~/halo2.archive - ``` - - > 需要注意的是，`halo2.archive` 文件名不一定要根据此文档命名，这里仅仅是个示例。 - 4. 更新 Halo 修改版本号后，按照最初安装的方式，重新创建容器即可。 - ```bash - mkdir -p ~/.halo2 - podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.10 - ``` + ```bash + podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.10 + ``` ## 使用 [Podman Quadlet](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html) diff --git a/versioned_docs/version-2.10/getting-started/install/docker-compose.md b/versioned_docs/version-2.10/getting-started/install/docker-compose.md index 8834921..0ebef57 100644 --- a/versioned_docs/version-2.10/getting-started/install/docker-compose.md +++ b/versioned_docs/version-2.10/getting-started/install/docker-compose.md @@ -247,21 +247,8 @@ import DockerArgs from "./slots/docker-args.md" ## 更新容器组 -1. 停止运行中的容器组 - - ```bash - cd ~/halo && docker-compose down - ``` - -2. 备份数据（重要） - - ```bash - cp -r ~/halo ~/halo.archive - ``` - - > 需要注意的是，`halo.archive` 文件名不一定要根据此文档命名，这里仅仅是个示例。 - -3. 更新 Halo 服务 +1. 备份数据，可以参考 [备份与恢复](../../user-guide/backup.md) 进行完整备份。 +2. 更新 Halo 服务 修改 `docker-compose.yaml` 中配置的镜像版本。 @@ -272,10 +259,6 @@ import DockerArgs from "./slots/docker-args.md" container_name: halo ``` - ```bash - docker-compose pull halo - ``` - ```bash docker-compose up -d ``` diff --git a/versioned_docs/version-2.10/getting-started/install/docker.md b/versioned_docs/version-2.10/getting-started/install/docker.md index 912a678..99c187a 100644 --- a/versioned_docs/version-2.10/getting-started/install/docker.md +++ b/versioned_docs/version-2.10/getting-started/install/docker.md @@ -67,27 +67,20 @@ import DockerArgs from "./slots/docker-args.md" ## 升级版本 -1. 拉取新版本镜像 +1. 备份数据，可以参考 [备份与恢复](../../user-guide/backup.md) 进行完整备份。 +2. 拉取新版本镜像 ```bash docker pull halohub/halo:2.10 ``` -2. 停止运行中的容器 +3. 停止运行中的容器 ```bash docker stop halo docker rm halo ``` -3. 备份数据（重要） - - ```bash - cp -r ~/.halo2 ~/halo2.archive - ``` - - > 需要注意的是，`halo2.archive` 文件名不一定要根据此文档命名，这里仅仅是个示例。 - 4. 更新 Halo 修改版本号后，按照最初安装的方式，重新创建容器即可。 diff --git a/versioned_docs/version-2.10/getting-started/install/podman.md b/versioned_docs/version-2.10/getting-started/install/podman.md index cd0480c..48ad43f 100644 --- a/versioned_docs/version-2.10/getting-started/install/podman.md +++ b/versioned_docs/version-2.10/getting-started/install/podman.md @@ -93,35 +93,27 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简 ## 升级版本 -1. 拉取新版本镜像 +1. 备份数据，可以参考 [备份与恢复](../../user-guide/backup.md) 进行完整备份。 +2. 拉取新版本镜像 ```bash podman pull halohub/halo:2.10 ``` -2. 停止运行中的容器 +3. 停止运行中的容器 ```bash podman stop halo podman rm halo ``` -3. 备份数据（重要） - - ```bash - cp -r ~/.halo2 ~/halo2.archive - ``` - - > 需要注意的是，`halo2.archive` 文件名不一定要根据此文档命名，这里仅仅是个示例。 - 4. 更新 Halo 修改版本号后，按照最初安装的方式，重新创建容器即可。 - ```bash - mkdir -p ~/.halo2 - podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.10 - ``` + ```bash + podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.10 + ``` ## 使用 [Podman Quadlet](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html)