pc5kflswa
/
docs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: update default docker registry (#370)

Browse Source 
更新部署文档，添加我们的自建 Docker 仓库，并设置为首选。

```release-note
None
```
wan92hen-patch-1
Ryan Wang 6 months ago committed by GitHub
parent 92ef10595e
commit 3a69e510b3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
14 changed files with 72 additions and 188 deletions
Show Stats Download Patch File Download Diff File

27
docs/getting-started/install/docker-compose.md
Unescape View File

@ -4,6 +4,7 @@ description: 使用 Docker Compose 部署
---
import DockerArgs from "./slots/_docker-args.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
:::info
在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare.md)，这可以快速帮助你了解 Halo。
@ -20,19 +21,7 @@ import DockerArgs from "./slots/_docker-args.md"
## 创建容器组
可用的 Halo 2.16 的 Docker 镜像：
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `halohub/halo:2.16` 或者 `halohub/halo:2.16.0`。
- `halohub/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新 `halohub/halo:2.16` 镜像。
- `halohub/halo:2.16.0`：表示一个具体的版本。
后续文档以 `halohub/halo:2.16` 为例。
:::
<DockerRegistryList />
1. 在系统任意位置创建一个文件夹，此文档以 `~/halo` 为例。
@ -59,7 +48,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
depends_on:
halodb:
@ -117,7 +106,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
depends_on:
halodb:
@ -185,7 +174,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
volumes:
- ./halo2:/root/.halo2
@ -209,7 +198,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
network_mode: "host"
volumes:
@ -258,7 +247,7 @@ import DockerArgs from "./slots/_docker-args.md"
```yaml {3}
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
```
```bash
@ -322,7 +311,7 @@ networks:
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
volumes:
- ./halo2:/root/.halo2

21
docs/getting-started/install/docker.md
Unescape View File

@ -4,6 +4,7 @@ description: 使用 Docker 部署
---
import DockerArgs from "./slots/_docker-args.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
:::info
在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare)，这可以快速帮助你了解 Halo。
@ -25,24 +26,12 @@ import DockerArgs from "./slots/_docker-args.md"
## 使用 Docker 镜像
可用的 Halo 2.16 的 Docker 镜像：
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `halohub/halo:2.16` 或者 `halohub/halo:2.16.0`。
- `halohub/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新 `halohub/halo:2.16` 镜像。
- `halohub/halo:2.16.0`：表示一个具体的版本。
后续文档以 `halohub/halo:2.16` 为例。
:::
<DockerRegistryList />
1. 创建容器
```bash
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```
:::info
@ -71,7 +60,7 @@ import DockerArgs from "./slots/_docker-args.md"
2. 拉取新版本镜像
```bash
docker pull halohub/halo:2.16
docker pull registry.fit2cloud.com/halo/halo:2.16
```
3. 停止运行中的容器
@ -86,5 +75,5 @@ import DockerArgs from "./slots/_docker-args.md"
修改版本号后，按照最初安装的方式，重新创建容器即可。
```bash
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```

40
docs/getting-started/install/jar-file.md
Unescape View File

@ -258,7 +258,6 @@ journalctl -n 20 -u halo
你可以在下面的反向代理软件中任选一项，我们假设你已经安装好了其中一项，并对其的基本操作有一定了解。 如果你对它们没有任何了解，可以参考我们更为详细的反向代理文档：
1. 使用 [Nginx Proxy Manager](../install/other/nginxproxymanager.md)
2. 使用 [Traefik](../install/other/traefik.md)
### Nginx
@ -290,42 +289,3 @@ encode gzip
reverse_proxy 127.0.0.1:8090
```
### Traefik
更新 halo 容器组的配置
1. `networks` 中引入已存在的网络 `traefik`（此网络需要 [提前创建](../install/other/traefik.md#创建-traefik)）
2. `services.halo.networks` 中添加网络 `traefik`
3. 修改外部地址为你的域名
4. 声明路由规则、开启 TLS
```yaml {4-5,16,20,25-31}
version: "3.8"
networks:
traefik:
external: true
halo:
services:
halo:
image: halohub/halo:2.16
container_name: halo
restart: on-failure:3
volumes:
- ./halo2:/root/.halo2
networks:
- traefik
- halo
command:
# 外部访问地址，请根据实际需要修改
- --halo.external-url=https://yourdomain.com
labels:
traefik.enable: "true"
traefik.docker.network: traefik
traefik.http.routers.halo.rule: Host(`yourdomain.com`)
traefik.http.routers.halo.tls: "true"
traefik.http.routers.halo.tls.certresolver: myresolver
traefik.http.services.halo.loadbalancer.server.port: 8090
```

2
docs/getting-started/install/other/traefik.md
Unescape View File

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

21
docs/getting-started/install/podman.md
Unescape View File

@ -4,6 +4,7 @@ description: 使用 Podman 部署
---
import DockerArgs from "./slots/_docker-args.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
## 前言
@ -50,25 +51,13 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
通过[前言](#前言)我们已经了解了 Podman ，其中提到 ***Podman 与 Docker 高度兼容*** ，正是因为 Podman 完全是为了替代 Docker 而诞生，所以原本的 Docker 生态中的镜像我们可以无需更改直接使用。
:::
可用的 Halo 2.16 的 Docker 镜像：
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `halohub/halo:2.16` 或者 `halohub/halo:2.16.0`。
- `halohub/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新 `halohub/halo:2.16` 镜像。
- `halohub/halo:2.16.0`：表示一个具体的版本。
后续文档以 `halohub/halo:2.16` 为例。
:::
<DockerRegistryList />
1. 创建容器
```bash
mkdir -p ~/.halo2
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```
:::info
@ -97,7 +86,7 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
2. 拉取新版本镜像
```bash
podman pull halohub/halo:2.16
podman pull registry.fit2cloud.com/halo/halo:2.16
```
3. 停止运行中的容器
@ -112,7 +101,7 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
修改版本号后，按照最初安装的方式，重新创建容器即可。
```bash
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```
## 使用 [Podman Quadlet](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html)

15
docs/getting-started/install/slots/_docker-registry-list.md
Unescape View File

@ -0,0 +1,15 @@
目前 Halo 官方维护的 Docker 镜像仓库，可以根据自己的需求选择合适的镜像源：
- registry.fit2cloud.com/halo/halo
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `2.16` 或者 `2.16.0`。
- `registry.fit2cloud.com/halo/halo:2`：表示最新的 2.x 版本，即每次发布新版本都会更新此镜像。
- `registry.fit2cloud.com/halo/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新此镜像。
- `registry.fit2cloud.com/halo/halo:2.16.0`：表示一个具体的版本。
后续文档以 `registry.fit2cloud.com/halo/halo:2.16` 为例。
:::

4
docs/user-guide/faq.md
Unescape View File

@ -93,7 +93,7 @@ server {
--name halo-1 \
-p 8090:8090 \
-v ~/.halo2:/root/.halo2 \
halohub/halo:2.16 \
registry.fit2cloud.com/halo/halo:2.16 \
# 第二个 Halo 容器
docker run \
@ -101,7 +101,7 @@ server {
--name halo-2 \
-p 8091:8090 \
-v ~/.halo2_2:/root/.halo2 \
halohub/halo:2.16 \
registry.fit2cloud.com/halo/halo:2.16 \
```
更多 Docker 相关的教程请参考：[使用 Docker 部署 Halo](../getting-started/install/docker.md)

27
versioned_docs/version-2.16/getting-started/install/docker-compose.md
Unescape View File

@ -4,6 +4,7 @@ description: 使用 Docker Compose 部署
---
import DockerArgs from "./slots/_docker-args.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
:::info
在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare.md)，这可以快速帮助你了解 Halo。
@ -20,19 +21,7 @@ import DockerArgs from "./slots/_docker-args.md"
## 创建容器组
可用的 Halo 2.16 的 Docker 镜像：
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `halohub/halo:2.16` 或者 `halohub/halo:2.16.0`。
- `halohub/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新 `halohub/halo:2.16` 镜像。
- `halohub/halo:2.16.0`：表示一个具体的版本。
后续文档以 `halohub/halo:2.16` 为例。
:::
<DockerRegistryList />
1. 在系统任意位置创建一个文件夹，此文档以 `~/halo` 为例。
@ -59,7 +48,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
depends_on:
halodb:
@ -117,7 +106,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
depends_on:
halodb:
@ -185,7 +174,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
volumes:
- ./halo2:/root/.halo2
@ -209,7 +198,7 @@ import DockerArgs from "./slots/_docker-args.md"
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
network_mode: "host"
volumes:
@ -258,7 +247,7 @@ import DockerArgs from "./slots/_docker-args.md"
```yaml {3}
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
```
```bash
@ -322,7 +311,7 @@ networks:
services:
halo:
image: halohub/halo:2.16
image: registry.fit2cloud.com/halo/halo:2.16
restart: on-failure:3
volumes:
- ./halo2:/root/.halo2

21
versioned_docs/version-2.16/getting-started/install/docker.md
Unescape View File

@ -4,6 +4,7 @@ description: 使用 Docker 部署
---
import DockerArgs from "./slots/_docker-args.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
:::info
在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare)，这可以快速帮助你了解 Halo。
@ -25,24 +26,12 @@ import DockerArgs from "./slots/_docker-args.md"
## 使用 Docker 镜像
可用的 Halo 2.16 的 Docker 镜像：
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `halohub/halo:2.16` 或者 `halohub/halo:2.16.0`。
- `halohub/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新 `halohub/halo:2.16` 镜像。
- `halohub/halo:2.16.0`：表示一个具体的版本。
后续文档以 `halohub/halo:2.16` 为例。
:::
<DockerRegistryList />
1. 创建容器
```bash
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```
:::info
@ -71,7 +60,7 @@ import DockerArgs from "./slots/_docker-args.md"
2. 拉取新版本镜像
```bash
docker pull halohub/halo:2.16
docker pull registry.fit2cloud.com/halo/halo:2.16
```
3. 停止运行中的容器
@ -86,5 +75,5 @@ import DockerArgs from "./slots/_docker-args.md"
修改版本号后，按照最初安装的方式，重新创建容器即可。
```bash
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```

40
versioned_docs/version-2.16/getting-started/install/jar-file.md
Unescape View File

@ -258,7 +258,6 @@ journalctl -n 20 -u halo
你可以在下面的反向代理软件中任选一项，我们假设你已经安装好了其中一项，并对其的基本操作有一定了解。 如果你对它们没有任何了解，可以参考我们更为详细的反向代理文档：
1. 使用 [Nginx Proxy Manager](../install/other/nginxproxymanager.md)
2. 使用 [Traefik](../install/other/traefik.md)
### Nginx
@ -290,42 +289,3 @@ encode gzip
reverse_proxy 127.0.0.1:8090
```
### Traefik
更新 halo 容器组的配置
1. `networks` 中引入已存在的网络 `traefik`（此网络需要 [提前创建](../install/other/traefik.md#创建-traefik)）
2. `services.halo.networks` 中添加网络 `traefik`
3. 修改外部地址为你的域名
4. 声明路由规则、开启 TLS
```yaml {4-5,16,20,25-31}
version: "3.8"
networks:
traefik:
external: true
halo:
services:
halo:
image: halohub/halo:2.16
container_name: halo
restart: on-failure:3
volumes:
- ./halo2:/root/.halo2
networks:
- traefik
- halo
command:
# 外部访问地址，请根据实际需要修改
- --halo.external-url=https://yourdomain.com
labels:
traefik.enable: "true"
traefik.docker.network: traefik
traefik.http.routers.halo.rule: Host(`yourdomain.com`)
traefik.http.routers.halo.tls: "true"
traefik.http.routers.halo.tls.certresolver: myresolver
traefik.http.services.halo.loadbalancer.server.port: 8090
```

2
versioned_docs/version-2.16/getting-started/install/other/traefik.md
Unescape View File

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

21
versioned_docs/version-2.16/getting-started/install/podman.md
Unescape View File

@ -4,6 +4,7 @@ description: 使用 Podman 部署
---
import DockerArgs from "./slots/_docker-args.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
## 前言
@ -50,25 +51,13 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
通过[前言](#前言)我们已经了解了 Podman ，其中提到 ***Podman 与 Docker 高度兼容*** ，正是因为 Podman 完全是为了替代 Docker 而诞生，所以原本的 Docker 生态中的镜像我们可以无需更改直接使用。
:::
可用的 Halo 2.16 的 Docker 镜像：
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `halohub/halo:2.16` 或者 `halohub/halo:2.16.0`。
- `halohub/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新 `halohub/halo:2.16` 镜像。
- `halohub/halo:2.16.0`：表示一个具体的版本。
后续文档以 `halohub/halo:2.16` 为例。
:::
<DockerRegistryList />
1. 创建容器
```bash
mkdir -p ~/.halo2
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```
:::info
@ -97,7 +86,7 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
2. 拉取新版本镜像
```bash
podman pull halohub/halo:2.16
podman pull registry.fit2cloud.com/halo/halo:2.16
```
3. 停止运行中的容器
@ -112,7 +101,7 @@ Podman 采用无守护进程的包容性架构，因此可以更安全、更简
修改版本号后，按照最初安装的方式，重新创建容器即可。
```bash
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.16
podman run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.16
```
## 使用 [Podman Quadlet](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html)

15
versioned_docs/version-2.16/getting-started/install/slots/_docker-registry-list.md
Unescape View File

@ -0,0 +1,15 @@
目前 Halo 官方维护的 Docker 镜像仓库，可以根据自己的需求选择合适的镜像源：
- registry.fit2cloud.com/halo/halo
- [halohub/halo](https://hub.docker.com/r/halohub/halo)
- [ghcr.io/halo-dev/halo](https://github.com/halo-dev/halo/pkgs/container/halo)
:::info 注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 `2.16` 或者 `2.16.0`。
- `registry.fit2cloud.com/halo/halo:2`：表示最新的 2.x 版本，即每次发布新版本都会更新此镜像。
- `registry.fit2cloud.com/halo/halo:2.16`：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新此镜像。
- `registry.fit2cloud.com/halo/halo:2.16.0`：表示一个具体的版本。
后续文档以 `registry.fit2cloud.com/halo/halo:2.16` 为例。
:::

4
versioned_docs/version-2.16/user-guide/faq.md
Unescape View File

@ -93,7 +93,7 @@ server {
--name halo-1 \
-p 8090:8090 \
-v ~/.halo2:/root/.halo2 \
halohub/halo:2.16 \
registry.fit2cloud.com/halo/halo:2.16 \
# 第二个 Halo 容器
docker run \
@ -101,7 +101,7 @@ server {
--name halo-2 \
-p 8091:8090 \
-v ~/.halo2_2:/root/.halo2 \
halohub/halo:2.16 \
registry.fit2cloud.com/halo/halo:2.16 \
```
更多 Docker 相关的教程请参考：[使用 Docker 部署 Halo](../getting-started/install/docker.md)

Write Preview
Loading…
Cancel
Save