117 lines
2.5 KiB
Markdown
117 lines
2.5 KiB
Markdown
---
|
||
sidebar_position: 3
|
||
---
|
||
|
||
# Registry 配置管理
|
||
|
||
kit 可对接 [Registry](https://git.honor3.com/Fullstack/registry) 配置管理中心，通过命令行管理微服务配置。
|
||
|
||
## 配置连接
|
||
|
||
使用 `kit config` 设置 Registry 地址和认证信息：
|
||
|
||
```shell
|
||
# 设置 Registry 服务地址
|
||
kit config registryUrl http://your-registry-host:8008
|
||
|
||
# 设置认证 Token（Registry 设置中获取）
|
||
kit config registryToken your-token-here
|
||
```
|
||
|
||
验证连接：
|
||
|
||
```shell
|
||
kit registry list
|
||
```
|
||
|
||
## 查看项目
|
||
|
||
```shell
|
||
# 列出所有项目
|
||
kit registry list
|
||
|
||
# 输出示例：
|
||
# ID 名称 维度
|
||
# proj-abc-123 CommonExternalService IDC=✓ Env=✓ Group=✓
|
||
# proj-def-456 OrderService IDC=✗ Env=✓ Group=✓
|
||
```
|
||
|
||
## 管理配置
|
||
|
||
`kit registry config` 支持查看和修改配置项。
|
||
|
||
### 查看配置
|
||
|
||
```shell
|
||
# 查看整个项目的所有配置
|
||
kit registry config CommonExternalService
|
||
|
||
# 查看指定路径下的配置
|
||
kit registry config CommonExternalService:data/windows
|
||
|
||
# 获取单个配置值
|
||
kit registry config CommonExternalService:CF_R2_BUCKET
|
||
```
|
||
|
||
### 设置配置值
|
||
|
||
```shell
|
||
kit registry config CommonExternalService:CF_R2_BUCKET new-value
|
||
```
|
||
|
||
### 路径语法
|
||
|
||
`project:path` 中的 `path` 对应配置的路径前缀：
|
||
|
||
| 语法 | 含义 |
|
||
|------|------|
|
||
| `project` | 整个项目 |
|
||
| `project:data` | 路径以 `data` 开头的配置 |
|
||
| `project:data/windows` | 路径以 `data/windows` 开头的配置 |
|
||
| `project:data/windows/kit.exe` | 精确匹配单个配置 |
|
||
|
||
## 导入导出
|
||
|
||
### 导出
|
||
|
||
```shell
|
||
# 导出整个项目到文件
|
||
kit registry export CommonExternalService ./backup.json
|
||
|
||
# 仅导出指定路径下的配置
|
||
kit registry export CommonExternalService:data/windows ./backup-windows.json
|
||
```
|
||
|
||
导出文件包含项目名、路径、时间戳和配置列表：
|
||
|
||
```json
|
||
{
|
||
"project": "CommonExternalService",
|
||
"path": "data/windows",
|
||
"exportedAt": "2026-09-11T02:00:00Z",
|
||
"configs": [
|
||
{
|
||
"key": "kit.exe",
|
||
"value": "https://pub-xxx.r2.dev/data/windows/kit.exe",
|
||
"type": "string",
|
||
"description": "Windows 二进制下载地址"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 导入
|
||
|
||
```shell
|
||
# 从备份文件导入
|
||
kit registry import CommonExternalService ./backup.json
|
||
|
||
# 导入到指定路径下
|
||
kit registry import CommonExternalService:data ./backup.json
|
||
```
|
||
|
||
导入规则：
|
||
- 已存在的 key → 更新值
|
||
- 不存在的 key → 新增
|
||
- 远程有但本地没有的 → 保留不动
|