From a4fafa06f430650dec1e8b858f30963bd1a8e6ae Mon Sep 17 00:00:00 2001 From: Nexisato <978452096@qq.com> Date: Wed, 2 Sep 2026 19:51:55 +0800 Subject: [PATCH 1/2] chore: bump version docker v330 --- APP_VERSION | 2 +- en/self_host/docker/deploy.md | 2 +- en/self_host/docker/faq.md | 2 +- en/self_host/docker/offline-deployment.md | 30 +++++----- en/self_host/kubernetes/deploy.md | 2 +- zh/self_host/docker/deploy.md | 2 +- zh/self_host/docker/faq.md | 2 +- zh/self_host/docker/offline-deployment.md | 72 +++++++++++------------ zh/self_host/kubernetes/deploy.md | 2 +- 9 files changed, 58 insertions(+), 58 deletions(-) diff --git a/APP_VERSION b/APP_VERSION index 6d260c3a..b299be97 100644 --- a/APP_VERSION +++ b/APP_VERSION @@ -1 +1 @@ -v3.2.0 +v3.3.0 diff --git a/en/self_host/docker/deploy.md b/en/self_host/docker/deploy.md index bb887a8c..3cb35b7e 100644 --- a/en/self_host/docker/deploy.md +++ b/en/self_host/docker/deploy.md @@ -1,4 +1,4 @@ -# Deploying with Docker +# Deploying with Docker To deploy SwanLab Community Edition privately, follow the installation steps below. diff --git a/en/self_host/docker/faq.md b/en/self_host/docker/faq.md index 5bb54a13..e2506945 100644 --- a/en/self_host/docker/faq.md +++ b/en/self_host/docker/faq.md @@ -33,7 +33,7 @@ Find the `swanlab/` directory at the location where the script was executed, run ```yaml traefik: <<: *common - image: ccr.ccs.tencentyun.com/self-hosted/traefik:v3.0 + image: repo.swanlab.cn/self-hosted/traefik:v3.1 container_name: swanlab-traefik ports: - "8000:80" # [!code --] diff --git a/en/self_host/docker/offline-deployment.md b/en/self_host/docker/offline-deployment.md index 481881d5..f9e68a87 100644 --- a/en/self_host/docker/offline-deployment.md +++ b/en/self_host/docker/offline-deployment.md @@ -21,18 +21,18 @@ On a machine with Docker installed, execute the [pull-images.sh](https://github. # Define image list images=( - "ccr.ccs.tencentyun.com/self-hosted/traefik:v3.0" - "ccr.ccs.tencentyun.com/self-hosted/postgres:16.1" - "ccr.ccs.tencentyun.com/self-hosted/redis-stack-server:7.2.0-v15" - "ccr.ccs.tencentyun.com/self-hosted/clickhouse:24.3" - "ccr.ccs.tencentyun.com/self-hosted/logrotate:v1" - "ccr.ccs.tencentyun.com/self-hosted/fluent-bit:3.0" - "ccr.ccs.tencentyun.com/self-hosted/minio:RELEASE.2025-02-28T09-55-16Z" - "ccr.ccs.tencentyun.com/self-hosted/minio-mc:RELEASE.2025-04-08T15-39-49Z" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-server:v3.2.0" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-house:v3.2.0" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-cloud:v3.2.0" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-next:v3.2.0" + "repo.swanlab.cn/self-hosted/traefik:v3.1" + "repo.swanlab.cn/self-hosted/postgres:16.1" + "repo.swanlab.cn/self-hosted/redis-stack:7.2.0-v15" + "repo.swanlab.cn/self-hosted/clickhouse-server:24.3" + "repo.swanlab.cn/self-hosted/logrotate:1.0" + "repo.swanlab.cn/self-hosted/fluent-bit:3.1" + "repo.swanlab.cn/self-hosted/minio/minio:RELEASE.2025-02-28T09-55-16Z" + "repo.swanlab.cn/self-hosted/minio/mc:RELEASE.2025-04-08T15-39-49Z" + "repo.swanlab.cn/self-hosted/swanlab-server:v3.3.0" + "repo.swanlab.cn/self-hosted/swanlab-house:v3.3.0" + "repo.swanlab.cn/self-hosted/swanlab-cloud:v3.3.0" + "repo.swanlab.cn/self-hosted/swanlab-next:v3.3.0" ) # Pull images @@ -84,8 +84,8 @@ Verify loaded images with `docker images`: ```bash (base) root@swanlab:~# docker images REPOSITORY TAG IMAGE ID CREATED SIZE -ccr.ccs.tencentyun.com/self-hosted/swanlab-server v2.8.0 a2b992161a68 8 days ago 1.46GB -ccr.ccs.tencentyun.com/self-hosted/swanlab-next v2.8.0 7a33e5b1afc5 3 weeks ago 265MB +repo.swanlab.cn/self-hosted/swanlab-server v3.3.0 a2b992161a68 8 days ago 1.46GB +repo.swanlab.cn/self-hosted/swanlab-next v3.3.0 7a33e5b1afc5 3 weeks ago 265MB ... [truncated for brevity] ``` @@ -116,7 +116,7 @@ $ ./docker/install.sh ____) \ V V / (_| | | | | |___| (_| | |_) | |_____/ \_/\_/ \__,_|_| |_|______\__,_|_.__/ - Self-Hosted Docker v3.2.0 - @SwanLab + Self-Hosted Docker v3.3.0 - @SwanLab 🎉 Wow, the installation is complete. Everything is perfect. 🥰 Congratulations, self-hosted SwanLab can be accessed using {IP}:8000 diff --git a/en/self_host/kubernetes/deploy.md b/en/self_host/kubernetes/deploy.md index 90f4a23c..ac5eec6f 100644 --- a/en/self_host/kubernetes/deploy.md +++ b/en/self_host/kubernetes/deploy.md @@ -1,4 +1,4 @@ -# Deploying with Kubernetes +# Deploying with Kubernetes > If you need to migrate from the Docker version to the Kubernetes version, please refer to [this document](../docker/migration-docker-kubernetes.md). > The SwanLab Python SDK version supported by the Kubernetes version is >= 0.7.4 diff --git a/zh/self_host/docker/deploy.md b/zh/self_host/docker/deploy.md index 71d71517..d98364dc 100644 --- a/zh/self_host/docker/deploy.md +++ b/zh/self_host/docker/deploy.md @@ -1,4 +1,4 @@ -# 使用Docker进行部署 +# 使用Docker进行部署 如果你想要使用SwanLab私有化部署（社区版），请按照下面的流程进行安装。 diff --git a/zh/self_host/docker/faq.md b/zh/self_host/docker/faq.md index e67b6e9b..652cbe70 100644 --- a/zh/self_host/docker/faq.md +++ b/zh/self_host/docker/faq.md @@ -33,7 +33,7 @@ SwanLab 自托管版本基于 [Docker](https://www.docker.com/) 部署，默认 ```yaml traefik: <<: *common - image: ccr.ccs.tencentyun.com/self-hosted/traefik:v3.0 + image: repo.swanlab.cn/self-hosted/traefik:v3.1 container_name: swanlab-traefik ports: - "8000:80" # [!code --] diff --git a/zh/self_host/docker/offline-deployment.md b/zh/self_host/docker/offline-deployment.md index 69260924..22617cfa 100644 --- a/zh/self_host/docker/offline-deployment.md +++ b/zh/self_host/docker/offline-deployment.md @@ -23,18 +23,18 @@ # 定义要下载的镜像列表 images=( - "ccr.ccs.tencentyun.com/self-hosted/traefik:v3.0" - "ccr.ccs.tencentyun.com/self-hosted/postgres:16.1" - "ccr.ccs.tencentyun.com/self-hosted/redis-stack-server:7.2.0-v15" - "ccr.ccs.tencentyun.com/self-hosted/clickhouse:24.3" - "ccr.ccs.tencentyun.com/self-hosted/logrotate:v1" - "ccr.ccs.tencentyun.com/self-hosted/fluent-bit:3.0" - "ccr.ccs.tencentyun.com/self-hosted/minio:RELEASE.2025-02-28T09-55-16Z" - "ccr.ccs.tencentyun.com/self-hosted/minio-mc:RELEASE.2025-04-08T15-39-49Z" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-server:v3.2.0" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-house:v3.2.0" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-cloud:v3.2.0" - "ccr.ccs.tencentyun.com/self-hosted/swanlab-next:v3.2.0" + "repo.swanlab.cn/self-hosted/traefik:v3.1" + "repo.swanlab.cn/self-hosted/postgres:16.1" + "repo.swanlab.cn/self-hosted/redis-stack:7.2.0-v15" + "repo.swanlab.cn/self-hosted/clickhouse-server:24.3" + "repo.swanlab.cn/self-hosted/logrotate:1.0" + "repo.swanlab.cn/self-hosted/fluent-bit:3.1" + "repo.swanlab.cn/self-hosted/minio/minio:RELEASE.2025-02-28T09-55-16Z" + "repo.swanlab.cn/self-hosted/minio/mc:RELEASE.2025-04-08T15-39-49Z" + "repo.swanlab.cn/self-hosted/swanlab-server:v3.3.0" + "repo.swanlab.cn/self-hosted/swanlab-house:v3.3.0" + "repo.swanlab.cn/self-hosted/swanlab-cloud:v3.3.0" + "repo.swanlab.cn/self-hosted/swanlab-next:v3.3.0" ) # 下载镜像 @@ -88,18 +88,18 @@ $ docker load -i swanlab_images.tar ```bash (base) root@swanlab:~# docker images REPOSITORY TAG IMAGE ID CREATED SIZE -ccr.ccs.tencentyun.com/self-hosted/swanlab-server v2.8.0 a2b992161a68 8 days ago 1.46GB -ccr.ccs.tencentyun.com/self-hosted/swanlab-next v2.8.0 7a33e5b1afc5 3 weeks ago 265MB -ccr.ccs.tencentyun.com/self-hosted/swanlab-cloud v2.8.0 0bc15f138d79 3 weeks ago 53.3MB -ccr.ccs.tencentyun.com/self-hosted/swanlab-house v2.8.0 007b252f5b6c 3 weeks ago 48.5MB -ccr.ccs.tencentyun.com/self-hosted/minio-mc RELEASE.2025-04-08T15-39-49Z f33e36a42eec 5 weeks ago 84.1MB -ccr.ccs.tencentyun.com/self-hosted/clickhouse 24.3 6ffc1e932ef1 2 months ago 942MB -ccr.ccs.tencentyun.com/self-hosted/fluent-bit 3.0 97e65b999a4d 2 months ago 84.9MB -ccr.ccs.tencentyun.com/self-hosted/traefik v3.0 0f62db80c71d 2 months ago 190MB -ccr.ccs.tencentyun.com/self-hosted/minio RELEASE.2025-02-28T09-55-16Z 377fe6127f60 2 months ago 180MB -ccr.ccs.tencentyun.com/self-hosted/redis-stack-server 7.2.0-v15 110cc99f3057 3 months ago 520MB -ccr.ccs.tencentyun.com/self-hosted/postgres 16.1 86414087c100 16 months ago 425MB -ccr.ccs.tencentyun.com/self-hosted/logrotate v1 e07b32a4bfda 6 years ago 45.6MB +repo.swanlab.cn/self-hosted/swanlab-server v3.3.0 a2b992161a68 8 days ago 1.46GB +repo.swanlab.cn/self-hosted/swanlab-next v3.3.0 7a33e5b1afc5 3 weeks ago 265MB +repo.swanlab.cn/self-hosted/swanlab-cloud v3.3.0 0bc15f138d79 3 weeks ago 53.3MB +repo.swanlab.cn/self-hosted/swanlab-house v3.3.0 007b252f5b6c 3 weeks ago 48.5MB +repo.swanlab.cn/self-hosted/minio/mc RELEASE.2025-04-08T15-39-49Z f33e36a42eec 5 weeks ago 84.1MB +repo.swanlab.cn/self-hosted/clickhouse-server 24.3 6ffc1e932ef1 2 months ago 942MB +repo.swanlab.cn/self-hosted/fluent-bit 3.1 97e65b999a4d 2 months ago 84.9MB +repo.swanlab.cn/self-hosted/traefik v3.1 0f62db80c71d 2 months ago 190MB +repo.swanlab.cn/self-hosted/minio/minio RELEASE.2025-02-28T09-55-16Z 377fe6127f60 2 months ago 180MB +repo.swanlab.cn/self-hosted/redis-stack 7.2.0-v15 110cc99f3057 3 months ago 520MB +repo.swanlab.cn/self-hosted/postgres 16.1 86414087c100 16 months ago 425MB +repo.swanlab.cn/self-hosted/logrotate 1.0 e07b32a4bfda 6 years ago 45.6MB ``` ### 4. 安装 SwanLab 服务 @@ -129,7 +129,7 @@ $ ./docker/install.sh ____) \ V V / (_| | | | | |___| (_| | |_) | |_____/ \_/\_/ \__,_|_| |_|______\__,_|_.__/ - Self-Hosted Docker v3.2.0 - @SwanLab + Self-Hosted Docker v3.3.0 - @SwanLab 🎉 Wow, the installation is complete. Everything is perfect. 🥰 Congratulations, self-hosted SwanLab can be accessed using {IP}:8000 @@ -155,17 +155,17 @@ $ ./docker/install.sh ```bash $ docker compose ps -a NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS -swanlab-clickhouse ccr.ccs.tencentyun.com/self-hosted/clickhouse:24.3 "/entrypoint.sh" clickhouse 22 minutes ago Up 22 minutes (healthy) 8123/tcp, 9000/tcp, 9009/tcp -swanlab-cloud ccr.ccs.tencentyun.com/self-hosted/swanlab-cloud:v3.2.0 "/docker-entrypoint.…" swanlab-cloud 22 minutes ago Up 21 minutes 80/tcp -swanlab-fluentbit ccr.ccs.tencentyun.com/self-hosted/fluent-bit:3.0 "/fluent-bit/bin/flu…" fluent-bit 22 minutes ago Up 22 minutes 2020/tcp -swanlab-house ccr.ccs.tencentyun.com/self-hosted/swanlab-house:v3.2.0 "./app" swanlab-house 22 minutes ago Up 21 minutes (healthy) 3000/tcp -swanlab-logrotate ccr.ccs.tencentyun.com/self-hosted/logrotate:v1 "/sbin/tini -- /usr/…" logrotate 22 minutes ago Up 22 minutes -swanlab-minio ccr.ccs.tencentyun.com/self-hosted/minio:RELEASE.2025-02-28T09-55-16Z "/usr/bin/docker-ent…" minio 22 minutes ago Up 22 minutes (healthy) 9000/tcp -swanlab-next ccr.ccs.tencentyun.com/self-hosted/swanlab-next:v3.2.0 "docker-entrypoint.s…" swanlab-next 22 minutes ago Up 21 minutes 3000/tcp -swanlab-postgres ccr.ccs.tencentyun.com/self-hosted/postgres:16.1 "docker-entrypoint.s…" postgres 22 minutes ago Up 22 minutes (healthy) 5432/tcp -swanlab-redis ccr.ccs.tencentyun.com/self-hosted/redis-stack-server:7.2.0-v15 "/entrypoint.sh" redis 22 minutes ago Up 22 minutes (healthy) 6379/tcp -swanlab-server ccr.ccs.tencentyun.com/self-hosted/swanlab-server:v3.2.0 "docker-entrypoint.s…" swanlab-server 22 minutes ago Up 21 minutes (healthy) 3000/tcp -swanlab-traefik ccr.ccs.tencentyun.com/self-hosted/traefik:v3.0 "/entrypoint.sh trae…" traefik 22 minutes ago Up 22 minutes (healthy) 0.0.0.0:8000->80/tcp, [::]:8000->80/tcp +swanlab-clickhouse repo.swanlab.cn/self-hosted/clickhouse-server:24.3 "/entrypoint.sh" clickhouse 22 minutes ago Up 22 minutes (healthy) 8123/tcp, 9000/tcp, 9009/tcp +swanlab-cloud repo.swanlab.cn/self-hosted/swanlab-cloud:v3.3.0 "/docker-entrypoint.…" swanlab-cloud 22 minutes ago Up 21 minutes 80/tcp +swanlab-fluentbit repo.swanlab.cn/self-hosted/fluent-bit:3.1 "/fluent-bit/bin/flu…" fluent-bit 22 minutes ago Up 22 minutes 2020/tcp +swanlab-house repo.swanlab.cn/self-hosted/swanlab-house:v3.3.0 "./app" swanlab-house 22 minutes ago Up 21 minutes (healthy) 3000/tcp +swanlab-logrotate repo.swanlab.cn/self-hosted/logrotate:1.0 "/sbin/tini -- /usr/…" logrotate 22 minutes ago Up 22 minutes +swanlab-minio repo.swanlab.cn/self-hosted/minio/minio:RELEASE.2025-02-28T09-55-16Z "/usr/bin/docker-ent…" minio 22 minutes ago Up 22 minutes (healthy) 9000/tcp +swanlab-next repo.swanlab.cn/self-hosted/swanlab-next:v3.3.0 "docker-entrypoint.s…" swanlab-next 22 minutes ago Up 21 minutes 3000/tcp +swanlab-postgres repo.swanlab.cn/self-hosted/postgres:16.1 "docker-entrypoint.s…" postgres 22 minutes ago Up 22 minutes (healthy) 5432/tcp +swanlab-redis repo.swanlab.cn/self-hosted/redis-stack:7.2.0-v15 "/entrypoint.sh" redis 22 minutes ago Up 22 minutes (healthy) 6379/tcp +swanlab-server repo.swanlab.cn/self-hosted/swanlab-server:v3.3.0 "docker-entrypoint.s…" swanlab-server 22 minutes ago Up 21 minutes (healthy) 3000/tcp +swanlab-traefik repo.swanlab.cn/self-hosted/traefik:v3.1 "/entrypoint.sh trae…" traefik 22 minutes ago Up 22 minutes (healthy) 0.0.0.0:8000->80/tcp, [::]:8000->80/tcp ``` 通过执行 `docker compose logs ` 可以查看每个容器的日志。 diff --git a/zh/self_host/kubernetes/deploy.md b/zh/self_host/kubernetes/deploy.md index 5dd3bbd0..eed5d4fe 100644 --- a/zh/self_host/kubernetes/deploy.md +++ b/zh/self_host/kubernetes/deploy.md @@ -1,4 +1,4 @@ -# 使用Kubernetes进行部署 +# 使用Kubernetes进行部署 > 如需要从Docker版本迁移至Kubernetes版本，请参考[此文档](../docker/migration-docker-kubernetes.md)。 > Kubernetes版本支持的SwanLab Python SDK版本为 >= 0.7.4 From 502406fe0b940381197952fde5925c50e23f6f23 Mon Sep 17 00:00:00 2001 From: Nexisato <978452096@qq.com> Date: Wed, 2 Sep 2026 19:56:46 +0800 Subject: [PATCH 2/2] fix: bump app version --- Makefile | 28 +++++++++++++++------------- en/self_host/docker/deploy.md | 2 +- en/self_host/kubernetes/deploy.md | 2 +- zh/self_host/docker/deploy.md | 2 +- zh/self_host/kubernetes/deploy.md | 2 +- 5 files changed, 19 insertions(+), 17 deletions(-) diff --git a/Makefile b/Makefile index 8dd9c810..d51bd8ee 100644 --- a/Makefile +++ b/Makefile @@ -13,25 +13,27 @@ show-version: @echo "Current APP_VERSION: $(APP_VERSION)" ## Bump APP_VERSION and update all docs -## Usage: make bump-version V=v2.9.0 +## Usage: make bump-version V=v2.9.0（V=2.9.0 也可，会自动补 v 前缀；应用镜像 tag 始终带 v） bump-version: ifndef V $(error Usage: make bump-version V=v2.9.0) endif - @echo "$(V)" > $(APP_VERSION_FILE) - @echo "✅ Updated $(APP_VERSION_FILE) to $(V)" - @$(MAKE) _replace-versions NEW_V=$(V) + @case "$(V)" in v*) NV="$(V)" ;; *) NV="v$(V)" ;; esac; \ + echo "$$NV" > $(APP_VERSION_FILE); \ + echo "✅ Updated $(APP_VERSION_FILE) to $$NV"; \ + $(MAKE) _replace-versions NEW_V=$$NV ## Replace version strings in docs +## 注：sed 中 v 前缀可缺省（v\{0,1\}），用于修复历史上漏写 v 的镜像 tag _replace-versions: @for f in $(DOC_FILES); do \ if [ -f "$$f" ]; then \ - sed -i '' 's|swanlab-server:v[0-9][0-9.]*|swanlab-server:$(NEW_V)|g' "$$f"; \ - sed -i '' 's|swanlab-house:v[0-9][0-9.]*|swanlab-house:$(NEW_V)|g' "$$f"; \ - sed -i '' 's|swanlab-cloud:v[0-9][0-9.]*|swanlab-cloud:$(NEW_V)|g' "$$f"; \ - sed -i '' 's|swanlab-next:v[0-9][0-9.]*|swanlab-next:$(NEW_V)|g' "$$f"; \ - sed -i '' 's|Self-Hosted Docker v[0-9][0-9.]*|Self-Hosted Docker $(NEW_V)|g' "$$f"; \ - sed -i '' 's|||g' "$$f"; \ + sed -i '' 's|swanlab-server:v\{0,1\}[0-9][0-9.]*|swanlab-server:$(NEW_V)|g' "$$f"; \ + sed -i '' 's|swanlab-house:v\{0,1\}[0-9][0-9.]*|swanlab-house:$(NEW_V)|g' "$$f"; \ + sed -i '' 's|swanlab-cloud:v\{0,1\}[0-9][0-9.]*|swanlab-cloud:$(NEW_V)|g' "$$f"; \ + sed -i '' 's|swanlab-next:v\{0,1\}[0-9][0-9.]*|swanlab-next:$(NEW_V)|g' "$$f"; \ + sed -i '' 's|Self-Hosted Docker v\{0,1\}[0-9][0-9.]*|Self-Hosted Docker $(NEW_V)|g' "$$f"; \ + sed -i '' 's|||g' "$$f"; \ echo " ✅ Updated $$f"; \ fi; \ done @@ -42,19 +44,19 @@ verify-version: @FAILED=0; \ for f in $(DOC_FILES); do \ if [ -f "$$f" ]; then \ - MISMATCH=$$(grep -nE 'swanlab-(server|house|cloud|next):v[0-9]' "$$f" | grep -v "$(APP_VERSION)" || true); \ + MISMATCH=$$(grep -nE 'swanlab-(server|house|cloud|next):v?[0-9]' "$$f" | grep -v ":$(APP_VERSION)" || true); \ if [ -n "$$MISMATCH" ]; then \ echo "❌ Version mismatch in $$f:"; \ echo "$$MISMATCH"; \ FAILED=1; \ fi; \ - BANNER_MISMATCH=$$(grep -n 'Self-Hosted Docker v' "$$f" | grep -v "$(APP_VERSION)" || true); \ + BANNER_MISMATCH=$$(grep -nE 'Self-Hosted Docker v?[0-9]' "$$f" | grep -v " $(APP_VERSION)" || true); \ if [ -n "$$BANNER_MISMATCH" ]; then \ echo "❌ Banner version mismatch in $$f:"; \ echo "$$BANNER_MISMATCH"; \ FAILED=1; \ fi; \ - BADGE_MISMATCH=$$(grep -n '