Update Grafana to v13, add version notes

06_repository/6.2_registry.md

@@ -15,15 +15,17 @@
 你可以使用官方 `registry` 镜像来运行。
 
 ```bash
-$ docker run -d -p 5000:5000 --restart=always --name registry registry
+$ docker run -d -p 5000:5000 --restart=always --name registry registry:2
 ```
+
+> **版本说明**：使用 `registry:2` 表示 Docker Registry 2.x 版本，这是当前推荐的版本。旧版本 Registry 1.x 已停止维护，不建议使用。
 这将使用官方的 `registry` 镜像来启动私有仓库。默认情况下，仓库会被创建在容器的 `/var/lib/registry` 目录下。你可以通过 `-v` 参数来将镜像文件存放在本地的指定路径。例如下面的例子将上传的镜像放到本地的 `/opt/data/registry` 目录。
 
 ```bash
 $ docker run -d \
     -p 5000:5000 \
     -v /opt/data/registry:/var/lib/registry \
-    registry
+    registry:2
 ```
 
 ### 6.2.2 在私有仓库上传、搜索、下载镜像

06_repository/6.3_registry_auth.md

@@ -122,11 +122,13 @@ $ mkdir auth
 
 $ docker run --rm \
     --entrypoint htpasswd \
-    httpd:alpine \
+    httpd:2.4-alpine \
     -Bbn username password > auth/nginx.htpasswd
 ```
 > 将上面的 `username` `password` 替换为你自己的用户名和密码。
 
+> **版本说明**：使用 `httpd:2.4-alpine` 基于 Apache 2.4 的精简镜像。如需其他版本，可替换为 `httpd:latest` 或指定具体版本号如 `httpd:2.4.58-alpine`。
+
 ### 6.3.4 编辑 Docker Compose 配置
 
 编辑 `compose.yaml` (或 `docker-compose.yml`) 配置如下：
@@ -134,7 +136,7 @@ $ docker run --rm \
 ```yaml
 services:
   registry:
-    image: registry
+    image: registry:2
     ports:
       - "443:443"
     volumes:
@@ -145,6 +147,8 @@ volumes:
   registry-data:
 ```
 
+> **版本说明**：Compose 配置中明确指定 `registry:2` 版本。生产环境建议固定版本号（如 `registry:2.8.3`）而非使用 `latest`，以保证部署的可重复性。
+
 ### 6.3.5 修改 Hosts 文件
 
 编辑 `/etc/hosts`
@@ -187,6 +191,8 @@ $ docker image rm docker.domain.com/username/ubuntu:24.04
 
 $ docker pull docker.domain.com/username/ubuntu:24.04
 ```
+
+> **版本说明**：示例使用 `ubuntu:24.04`，这是最新 LTS 版本。推送到私有仓库时保持了原有的版本标签，建议生产环境明确指定镜像版本号。
 如果我们退出登录，尝试推送镜像。
 
 ```bash

06_repository/6.4_nexus3_registry.md

@@ -8,8 +8,10 @@
 $ docker run -d --name nexus3 --restart=always \
     -p 8081:8081 \
     --mount src=nexus-data,target=/nexus-data \
-    sonatype/nexus3
+    sonatype/nexus3:3.69
 ```
+
+> **版本说明**：使用 `sonatype/nexus3:3.69` 指定稳定的 Nexus 版本。使用具体版本号而非 `latest` 可以避免意外升级带来的不兼容问题。
 首次运行需等待 3-5 分钟，你可以使用 `docker logs nexus3 -f` 查看日志：
 
 ```bash
@@ -18,10 +20,12 @@ $ docker logs nexus3 -f
 2021-03-11 15:31:21,990+0000 INFO  [jetty-main-1] *SYSTEM org.sonatype.nexus.bootstrap.jetty.JettyServer -
 -------------------------------------------------
 
-Started Sonatype Nexus OSS 3.30.0-01
+Started Sonatype Nexus OSS 3.69.0
 
 -------------------------------------------------
 ```
+
+> **版本说明**：上述日志中显示的是 Nexus 3.69 版本的启动日志。具体版本号会随着容器镜像版本而不同。
 如果你看到以上内容，说明 `Nexus` 已经启动成功，你可以使用浏览器打开 `http://YourIP:8081` 访问 `Nexus` 了。
 
 首次运行请通过以下命令获取初始密码：

06_repository/README.md

@@ -6,6 +6,16 @@
 
 大部分时候，并不需要严格区分这两者的概念。
 
+## 版本号说明
+
+本章涉及的 Registry 和相关工具版本说明：
+
+- **Docker Registry**：使用 `registry:2` 推荐版本，已停止维护的 `registry:1` 不建议使用
+- **Nexus 3**：建议指定具体版本（如 `sonatype/nexus3:3.69`）而非 `latest`，避免自动升级带来的兼容性问题
+- **镜像标签规范**：
+  - 生产环境推送至仓库时应明确指定版本号（如 `myapp:v1.0.0`）
+  - 避免依赖 `latest` 标签，因为其含义存在歧义且易导致版本混淆
+
 ## 为什么需要私有仓库？
 
 在讨论具体的安装和配置前，让我们先理解：**什么时候你应该建设私有仓库？**