docs: fix stale references post v2.0.17 alignment

- Update deploy/README.md: remove NincaCrkStdRibbonConfiguration ref,
  update JAR naming, add v2.0.17 config instructions
- Update elevator-v1-v2-init-timing-config-audit.md: add baseline note
- Update org-policy-verify-manual.md: JAR path + AppApplication class
- Update release script comment with current baseline version
- docs/AGENTS.md and service-discovery spec already updated in v2.0.17
This commit is contained in:
反编译工作区
2026-05-05 19:08:33 +08:00
parent ec05aa777d
commit c5febc9905
4 changed files with 23 additions and 10 deletions
@@ -2,7 +2,7 @@
## 前置条件 ## 前置条件
- V2 JAR 已构建:`cw-elevator-application-2.0.9.jar` - V2 JAR 已构建:`deploy/v2-maven/cw-elevator-application-V1.0.0.20211103.jar`v2.0.17
- 配置文件:`/tmp/v2-redis-fix.properties` - 配置文件:`/tmp/v2-redis-fix.properties`
- Redis Docker`v2-test-redis`(端口 6380,密码 `1qaz!QAZ` - Redis Docker`v2-test-redis`(端口 6380,密码 `1qaz!QAZ`
- 桩服务脚本:`stub_org_service.py` - 桩服务脚本:`stub_org_service.py`
@@ -15,11 +15,11 @@
```bash ```bash
/usr/lib/jvm/java-8-openjdk-amd64/bin/java \ /usr/lib/jvm/java-8-openjdk-amd64/bin/java \
-jar /media/zebra/9e8fa357-7db6-4d70-88ed-d5de5a059a663/星河湾星中星/源码/maven-cw-elevator-application/cw-elevator-application-starter/target/cw-elevator-application-2.0.9.jar \ -jar /media/zebra/9e8fa357-7db6-4d70-88ed-d5de5a059a663/星河湾星中星/源码/maven-cw-elevator-application/deploy/v2-maven/cw-elevator-application-V1.0.0.20211103.jar \
--spring.config.location=file:/tmp/v2-redis-fix.properties --spring.config.location=file:/tmp/v2-redis-fix.properties
``` ```
等待约 **35 秒**,看到 `Started ElevatorApplication` 后验证: 等待约 **35 秒**,看到 `Started AppApplication` 后验证:
```bash ```bash
curl http://127.0.0.1:18081/health curl http://127.0.0.1:18081/health
@@ -19,9 +19,13 @@
## 2. 应用入口与 Ribbon 绑定(代码层,与属性文件无关) ## 2. 应用入口与 Ribbon 绑定(代码层,与属性文件无关)
- 入口:[`ElevatorApplication`](../../maven-cw-elevator-application/cw-elevator-application-starter/src/main/java/cn/cloudwalk/elevator/ElevatorApplication.java) > **基线更新**v2.0.17 已清理 `@RibbonClient` 和 `NincaCrkStdRibbonConfiguration`Ribbon 配置完全通过 `application.properties` 控制。下文为 v2.0.16 之前的状态,保留供参考。
- `@RibbonClient(name = "${feign.ninca-crk-std.name:ninca-crk-std}", configuration = NincaCrkStdRibbonConfiguration.class)`
- `ninca-crk-std` 专用配置:[`NincaCrkStdRibbonConfiguration`](../../maven-cw-elevator-application/cw-elevator-application-starter/src/main/java/cn/cloudwalk/ribbon/NincaCrkStdRibbonConfiguration.java) - 入口(当前):[`AppApplication`](../../maven-cw-elevator-application/cw-elevator-application-starter/src/main/java/cn/cloudwalk/elevator/AppApplication.java)
-`@RibbonClient`/`@RibbonClients` 注解。
- 入口(历史 v2.0.16 前):`ElevatorApplication.java`
- 曾存在 `@RibbonClient(name = "${feign.ninca-crk-std.name:ninca-crk-std}", configuration = NincaCrkStdRibbonConfiguration.class)`
- `ninca-crk-std` 配置(历史):`NincaCrkStdRibbonConfiguration.java`(已删除)
- 使用 **`ConfigurationBasedServerList`**`initWithNiwsConfig`**Ribbon 约定键**(如 `ninca-crk-std.ribbon.listOfServers`)取列表。 - 使用 **`ConfigurationBasedServerList`**`initWithNiwsConfig`**Ribbon 约定键**(如 `ninca-crk-std.ribbon.listOfServers`)取列表。
- 业务键 **`ninca-crk-std.ip`**(如 `AcsElevatorRecordServiceImpl`**不自动写入** Ribbon ServerList;二者语义分离。 - 业务键 **`ninca-crk-std.ip`**(如 `AcsElevatorRecordServiceImpl`**不自动写入** Ribbon ServerList;二者语义分离。
+12 -4
View File
@@ -13,7 +13,7 @@
| 目录 | JAR | 端口(见配置首行) | | 目录 | JAR | 端口(见配置首行) |
|------|-----|-------------------| |------|-----|-------------------|
| `v1-legacy/` | `cw-elevator-application-V1.0.0.20211103.jar` | **18080** | | `v1-legacy/` | `cw-elevator-application-V1.0.0.20211103.jar` | **18080** |
| `v2-maven/` | `cw-elevator-application-2.0.7.jar` | **18081** | | `v2-maven/` | `cw-elevator-application-V1.0.0.20211103.jar`(固定名,与 V1 一致) | **18081** |
**`application.properties`**:在验证环境常用的 JDBC / Redis / Ribbon / Kafka / 端口等覆盖(数据库为生产还原时,请把 **jdbc-url、账号** 指到承载还原库的实例)。 **`application.properties`**:在验证环境常用的 JDBC / Redis / Ribbon / Kafka / 端口等覆盖(数据库为生产还原时,请把 **jdbc-url、账号** 指到承载还原库的实例)。
@@ -56,11 +56,19 @@ cd v2-maven && ./run.sh
验证 Consul`curl -s http://192.168.3.12:8500/v1/status/leader`。浏览器打开 **`http://192.168.3.12:8500`** 可看 UI。 验证 Consul`curl -s http://192.168.3.12:8500/v1/status/leader`。浏览器打开 **`http://192.168.3.12:8500`** 可看 UI。
**说明**jar 内 **Dubbo / ZooKeeper** 仍可能指向旧 IP(如 `10.128.161.95:2181`);若启动报 ZK 连接失败,需在 **`application.properties`** 中另行改 Dubbo 注册中心(本次仅处理 Consul) **Dubbo 属性说明**`bootstrap.properties` 中的 `dubbo.*` 属性为历史遗留(V1 携带),当前运行时**未启用 Dubbo**(POM 中无 Dubbo 依赖),这些属性不生效
### Feign `ninca-crk-std`Ribbon ### Feign 上游服务Ribbon 静态列表
**`spring.cloud.consul.discovery.enabled=false`**(与 V1 对齐)时,不从 Consul 拉 **`ninca-crk-std`** 实例,需在 **`application.properties`** 中配置 **Ribbon 静态列表**`ninca-crk-std.ribbon.*``ninca-crk-std.ip`),按环境改成可访问的 **`主机:端口`**。Maven 构建的 `cw-elevator-application-2.0.7.jar` 另含 `NincaCrkStdRibbonConfiguration`,避免 Edgware 下静态列表被忽略。 **`spring.cloud.consul.discovery.enabled=false`**(与 V1 对齐)时,不从 Consul 拉取上游服务实例。Feign 通过 **Ribbon + ConfigurationBasedServerList****`application.properties`** 中 **`{服务名}.ribbon.listOfServers`** 读取静态 IP 列表,按环境配置:
```properties
ninca-crk-std.ribbon.listOfServers=10.0.22.102:16106
ninca-common-component-organization.ribbon.listOfServers=...
ninca-common.ribbon.listOfServers=...
```
V2 v2.0.17 起不再需要 `NIWSServerListClassName``NincaCrkStdRibbonConfiguration`Ribbon 默认 `ConfigurationBasedServerList`。)
## Redis 与 `SPRING_APPLICATION_JSON` ## Redis 与 `SPRING_APPLICATION_JSON`
@@ -4,6 +4,7 @@
# cw-elevator-application-V<版本>.<日期>(日期默认当天 YYYYMMDD,可用 RELEASE_DATE_LABEL 覆盖)。 # cw-elevator-application-V<版本>.<日期>(日期默认当天 YYYYMMDD,可用 RELEASE_DATE_LABEL 覆盖)。
# 用法:在仓库根执行 ./scripts/release-cw-elevator-application.sh [版本号] # 用法:在仓库根执行 ./scripts/release-cw-elevator-application.sh [版本号]
# JAR 命名对齐 V1 运行包 cw-elevator-application-V1.0.0.20211103.jar。 # JAR 命名对齐 V1 运行包 cw-elevator-application-V1.0.0.20211103.jar。
# 当前基线版本 v2.0.17,构建时传入新版本号:./release-cw-elevator-application.sh 2.0.x
set -euo pipefail set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)" ROOT="$(cd "$(dirname "$0")/.." && pwd)"