ai 合并多集群kubeconfig经验

# 合并多集群kubeconfig经验

## 背景

`02-系统运维/运维系统/k8s/配置` 下有多个集群 kubeconfig，需要统一合并到本机 `~/.kube/config`，方便 `kubectl --context` 直接切换。

## 本次集群

| Context | 环境 | 源 kubeconfig | API Server |
| --- | --- | --- | --- |
| tqls-ack-prd | 食品 ACK PRD | 02-系统运维/运维系统/k8s/配置/kubernetes-ack/kubeconfig | https://10.7.9.236:6443 |
| tqls-prd | 食品 PRD | 02-系统运维/运维系统/k8s/配置/kubernetes-prd/kubeconfig | https://10.7.16.10:9443 |
| tqls-shuangliu | 双流本地 | 02-系统运维/运维系统/k8s/配置/kubernetes-sl/kubeconfig | https://10.2.8.110:9443 |
| tqls-wl-uat | 食品 UAT | 02-系统运维/运维系统/k8s/配置/kubernetes-wl-uat/kubeconfig | https://10.7.20.221:6443 |
| tqls-wl-ver | 食品 VER | 02-系统运维/运维系统/k8s/配置/kubernetes-wl-ver/kubeconfig | https://10.7.20.39:6443 |

## 推荐流程

1. 先查看每个 kubeconfig 的基本信息。

```shell
kubectl config view --kubeconfig 02-系统运维/运维系统/k8s/配置/kubernetes-ack/kubeconfig --raw=false
```

2. 对每个 kubeconfig 做 flatten，避免依赖外部证书路径。

```shell
kubectl config view \
  --kubeconfig 02-系统运维/运维系统/k8s/配置/kubernetes-ack/kubeconfig \
  --flatten \
  --raw \
  -o json
```

3. 合并前先统一重命名 cluster、user、context。

命名建议：

```text
tqls-ack-prd
tqls-prd
tqls-shuangliu
tqls-wl-uat
tqls-wl-ver
```

4. 写入本机配置。

```text
~/.kube/config
```

5. 额外保存一个索引文件，便于追溯来源。

```text
~/.kube/tqls/clusters.json
```

## 关键经验

- 不建议直接把多个 kubeconfig 拼在一起，容易出现 context 名称重复。
- 先 `--flatten --raw` 可以把证书内容内嵌进 kubeconfig，避免原文件里 `/etc/kubernetes-prd/pki/...` 这种路径在本机不存在。
- 合并前如果本机已有 `~/.kube/config`，先备份。

## 关联页面

- [[02-系统运维/运维系统/k8s/kubeconfig清单]]
- [[02-系统运维/运维系统/k8s/k8s]]
# 安装和验证aliyun-cli经验

## 背景

本机需要通过 `aliyun-cli` 连接多个阿里云账号，采集 ECS、RDS、SLB、OSS、Redis、ACK 等资源信息。

## 检查命令

```shell
command -v aliyun
aliyun version
aliyun help
aliyun configure --help
```

## 本次结果

| 项目 | 内容 |
| --- | --- |
| aliyun 路径 | /opt/homebrew/bin/aliyun |
| 版本 | 3.4.8 |
| 安装方式 | Homebrew |

## 判断标准

- `command -v aliyun` 能返回路径，说明命令存在。
- `aliyun version` 能返回版本，说明程序可执行。
- `aliyun configure --help` 能正常输出，说明配置模块可用。
- 如果 `aliyun configure list` 报 `~/.aliyun/config.json` 不存在，只说明还没配置默认账号，不代表 CLI 坏了。

## 经验结论

- 采集资源时可以不写入全局配置，直接在命令里通过 `--mode AK --access-key-id --access-key-secret` 临时连接。
- 临时连接适合多账号场景，避免切换默认 profile 时混淆账号。

## 适用位置

- [[03-平台管理/平台管理总览]]
- [[03-平台管理/食品北京阿里云/食品北京阿里云总览]]
- [[03-平台管理/食品乌兰察布阿里云/食品乌兰察布阿里云总览]]
- [[03-平台管理/实业北京阿里云/实业北京阿里云总览]]
- [[03-平台管理/圣迪乐北京阿里云/圣迪乐北京阿里云总览]]
- [[00-经验与工具/工具/工具总览]]