docs: update documentations for 2.21 (#502)

Signed-off-by: Ryan Wang <i@ryanc.cc>

Author: ruibaby

docs/developer-guide/core/build.md

@@ -33,7 +33,7 @@ git checkout ${branch_name}
 
 ## 构建 Fat Jar
 
-构建之前需要修改 `gradle.properties` 中的 `version` 属性（推荐遵循 [SemVer 规范](https://semver.org/)），例如：`version=2.20.0`
+构建之前需要修改 `gradle.properties` 中的 `version` 属性（推荐遵循 [SemVer 规范](https://semver.org/)），例如：`version=2.21.0`
 
 ```bash
 cd path/to/halo

docs/developer-guide/core/prepare.md

@@ -5,9 +5,9 @@ description: 开发环境的准备工作
 
 ## 环境要求
 
-- [OpenJDK 17 LTS](https://github.com/openjdk/jdk)
+- [OpenJDK 21 LTS](https://github.com/openjdk/jdk)
 - [Node.js 20 LTS](https://nodejs.org)
-- [pnpm 9](https://pnpm.io/)
+- [pnpm 10](https://pnpm.io/)
 - [IntelliJ IDEA](https://www.jetbrains.com/idea/)
 - [Git](https://git-scm.com/)
 - [Docker](https://www.docker.com/)（可选）

docs/getting-started/install/config.md

@@ -16,7 +16,7 @@ Halo 支持通过多种方式进行配置，目前 [Docker Compose 部署文档]
 ```yaml {5-10}
 services:
   halo:
-    image: registry.fit2cloud.com/halo/halo:2.20
+    image: registry.fit2cloud.com/halo/halo:2.21
     ...
     command:
       - --spring.r2dbc.url=r2dbc:pool:postgresql://halodb/halo

docs/getting-started/install/docker-compose.md

@@ -52,7 +52,7 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
 
          services:
            halo:
-             image: registry.fit2cloud.com/halo/halo:2.20
+             image: registry.fit2cloud.com/halo/halo:2.21
              restart: on-failure:3
              depends_on:
                halodb:
@@ -111,7 +111,7 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
 
          services:
            halo:
-             image: registry.fit2cloud.com/halo/halo:2.20
+             image: registry.fit2cloud.com/halo/halo:2.21
              restart: on-failure:3
              depends_on:
                halodb:
@@ -181,7 +181,7 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
 
         services:
           halo:
-            image: registry.fit2cloud.com/halo/halo:2.20
+            image: registry.fit2cloud.com/halo/halo:2.21
             restart: on-failure:3
             volumes:
               - ./halo2:/root/.halo2
@@ -207,7 +207,7 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
 
         services:
           halo:
-            image: registry.fit2cloud.com/halo/halo:2.20
+            image: registry.fit2cloud.com/halo/halo:2.21
             restart: on-failure:3
             network_mode: "host"
             volumes:
@@ -273,7 +273,7 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
    ```yaml {3}
    services:
     halo:
-      image: registry.fit2cloud.com/halo/halo:2.20
+      image: registry.fit2cloud.com/halo/halo:2.21
    ```
 
    ```bash
@@ -337,7 +337,7 @@ networks:
 
 services:
   halo:
-    image: registry.fit2cloud.com/halo/halo:2.20
+    image: registry.fit2cloud.com/halo/halo:2.21
     restart: on-failure:3
     volumes:
       - ./halo2:/root/.halo2

docs/getting-started/install/docker.md

@@ -31,7 +31,7 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
 1. 创建容器
 
    ```bash
-   docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 -e JVM_OPTS="-Xmx256m -Xms256m" registry.fit2cloud.com/halo/halo:2.20
+   docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 -e JVM_OPTS="-Xmx256m -Xms256m" registry.fit2cloud.com/halo/halo:2.21
    ```
 
    :::info
@@ -64,7 +64,7 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
 2. 拉取新版本镜像
 
    ```bash
-   docker pull registry.fit2cloud.com/halo/halo:2.20
+   docker pull registry.fit2cloud.com/halo/halo:2.21
    ```
 
 3. 停止运行中的容器
@@ -79,5 +79,5 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
    修改版本号后，按照最初安装的方式，重新创建容器即可。
 
    ```bash
-   docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.20
+   docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.21
    ```

docs/getting-started/install/jar-file.md

@@ -10,7 +10,9 @@ title: 使用 JAR 文件部署
 
 在开始之前，需要确保服务器已经满足以下条件：
 
-1. [Java](https://openjdk.org) 环境，目前 Halo 最低需要 **JRE 17** 的环境。
+1. [Java](https://openjdk.org) 环境，版本要求：
+   - 2.21 以上版本：**JRE 21**
+   - 2.20 及以下版本：**JRE 17**
 2. 数据库（任一）
    - [MySQL 5.7+](https://www.mysql.com)
    - [MariaDB](https://mariadb.org)
@@ -53,7 +55,7 @@ title: 使用 JAR 文件部署
 3. 下载运行包
 
    ```bash
-   wget https://dl.halo.run/release/halo-2.20.12.jar -O halo.jar
+   wget https://dl.halo.run/release/halo-2.21.0.jar -O halo.jar
    ```
 
    :::info
@@ -249,7 +251,7 @@ journalctl -n 20 -u halo
 3. 下载新版本的 Halo 运行包，覆盖原有的运行包
 
    ```bash
-   wget https://dl.halo.run/release/halo-2.20.12.jar -O /home/halo/app/halo.jar
+   wget https://dl.halo.run/release/halo-2.21.0.jar -O /home/halo/app/halo.jar
    ```
 
    :::info

docs/getting-started/install/other/traefik.md

@@ -96,7 +96,7 @@ networks:
 
 services:
   halo:
-    image: registry.fit2cloud.com/halo/halo:2.20
+    image: registry.fit2cloud.com/halo/halo:2.21
     container_name: halo
     restart: on-failure:3
     volumes:

docs/getting-started/install/podman.md

@@ -57,7 +57,7 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
 
    ```bash
    mkdir -p ~/.halo2
-   podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.20
+   podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.21
    ```
 
    :::info
@@ -90,7 +90,7 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
 2. 拉取新版本镜像
 
    ```bash
-   podman pull registry.fit2cloud.com/halo/halo:2.20
+   podman pull registry.fit2cloud.com/halo/halo:2.21
    ```
 
 3. 停止运行中的容器
@@ -105,7 +105,7 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
    修改版本号后，按照最初安装的方式，重新创建容器即可。
 
    ```bash
-   podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.20
+   podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.21
    ```
 
 ## 使用 [Podman Quadlet](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html)
@@ -141,7 +141,7 @@ Environment=SPRING_CONFIG_LOCATION="optional:classpath:/;optional:file:/.halo/"
 Environment=TZ=Asia/Shanghai
 Volume=/opt/podman-data/halo:/.halo
 PublishPort=127.0.0.1:8090:8090
-Image=ghcr.io/halo-dev/halo:2.20
+Image=ghcr.io/halo-dev/halo:2.21
 Exec=--halo.external-url=https://localhost:8090 --spring.sql.init.platform=postgresql --spring.r2dbc.url=r2dbc:pool:postgresql://127.0.0.1:5432/my-db --spring.r2dbc.username=my-user --spring.r2dbc.password=my-password
 
 [Service]
@@ -170,7 +170,7 @@ Podman Quadlet 解析：
 
 `[Container]` 部分：
 
-- `AutoUpdate=registry`指定了自动拉取容器。假设后续 Halo 镜像支持了`latest`标签，你需要`systemctl enable --now podman-auto-update.timer`以启用容器自动更新。本文示例`ghcr.io/halo-dev/halo:2.20`，将会自动更新适用与`2.20`版本的 patch，例如您创建容器时是`2.20.1`，在官方发布`2.20.2`版本时，容器会自动更新到`2.20.2`。
+- `AutoUpdate=registry`指定了自动拉取容器。假设后续 Halo 镜像支持了`latest`标签，你需要`systemctl enable --now podman-auto-update.timer`以启用容器自动更新。本文示例`ghcr.io/halo-dev/halo:2.21`，将会自动更新适用与`2.21`版本的 patch，例如您创建容器时是`2.21.1`，在官方发布`2.21.2`版本时，容器会自动更新到`2.21.2`。
 - `ContainerName=`指定了 systemd 将生成的服务名称。
 - `User=60000 Group=60000 UserNS=keep-id:uid=60000,gid=60000` 限制容器以 id 60000 的用户运行，提高安全性。注意这个 id 60000 请根据你实际想要运行的用户名来修改，可通过`id user`获得你的用户的 id.
 - `Environment=`字段指定了容器的环境变量，其中你需要注意的是`Environment=HALO_WORK_DIR="/.halo"` `Environment=SPRING_CONFIG_LOCATION="optional:classpath:/;optional:file:/.halo/"`这两个变量中的`/.halo`路径。
@@ -213,7 +213,7 @@ AutoUpdate=registry
 ContainerName=halo
 Volume=/opt/podman-data/halo:/root/.halo
 PublishPort=127.0.0.1:8090:8090
-Image=ghcr.io/halo-dev/halo:2.20
+Image=ghcr.io/halo-dev/halo:2.21
 Exec=--halo.external-url=https://localhost:8090 --spring.sql.init.platform=postgresql --spring.r2dbc.url=r2dbc:pool:postgresql://127.0.0.1:5432/my-db --spring.r2dbc.username=my-user --spring.r2dbc.password=my-password
 
 [Service]

docs/getting-started/install/slots/_docker-registry-list.md

@@ -5,11 +5,11 @@
 - [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
 
 :::info 注意
-目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `2.20` 或者 `2.20.0`。
+目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `2.21` 或者 `2.21.0`。
 
 - `registry.fit2cloud.com/halo/halo:2`：表示最新的 2.x 版本，即每次发布新版本都会更新此镜像。
-- `registry.fit2cloud.com/halo/halo:2.20`：表示最新的 2.20.x 版本，即每次发布 patch 版本都会同时更新此镜像。
-- `registry.fit2cloud.com/halo/halo:2.20.0`：表示一个具体的版本。
+- `registry.fit2cloud.com/halo/halo:2.21`：表示最新的 2.21.x 版本，即每次发布 patch 版本都会同时更新此镜像。
+- `registry.fit2cloud.com/halo/halo:2.21.0`：表示一个具体的版本。
 
-后续文档以 `registry.fit2cloud.com/halo/halo:2.20` 为例。
+后续文档以 `registry.fit2cloud.com/halo/halo:2.21` 为例。
 :::

docs/getting-started/prepare.md

@@ -49,7 +49,11 @@ Halo 理论上可以运行在任何支持 Docker 及 Java 的平台。
 - [使用 JAR 文件部署](./install/jar-file.md)
 
 :::info
-当前版本（2.0）需要 JRE 17 的版本，推荐使用 OpenJDK 17。
+版本要求：
+
+- 2.21 以上版本：**JRE 21**
+- 2.20 及以下版本：**JRE 17**
+
 :::
 
 #### 数据库