mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 08:20:31 +08:00
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:
@@ -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;二者语义分离。
|
||||||
|
|
||||||
|
|||||||
@@ -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)"
|
||||||
|
|||||||
Reference in New Issue
Block a user