技能名称: aliyun-alb-manage
详细描述:
类别: service

应用型负载均衡 (ALB)

使用此技能，通过本地 Python 脚本和兼容 OpenAPI 的工作流，进行端到端的 ALB 操作。

验证

bash
mkdir -p output/aliyun-alb-manage
for f in skills/network/slb/aliyun-alb-manage/scripts/*.py; do
python3 -m py_compile $f
done
echo pycompileok > output/aliyun-alb-manage/validate.txt

通过标准：命令退出码为 0 且生成了 output/aliyun-alb-manage/validate.txt 文件。

输出与证据

• - 将所有命令输出、请求参数和 API 响应保存到 output/aliyun-alb-manage/ 目录下。
• 对于变更操作，保留变更前后的快照以及健康检查结果。

前提条件

bash
pip install alibabacloudalb20200616 alibabacloudteaopenapi alibabacloudcredentials

凭证优先级：

1. 1. ALICLOUDACCESSKEYID / ALICLOUDACCESSKEYSECRET
2. 可选 STS Token：ALICLOUDSECURITYTOKEN
3. 共享配置文件：~/.alibabacloud/credentials

工作流程

1. 1. 确认地域、VPC 上下文、目标 ALB 资源 ID 以及预期的变更窗口。
2. 首先运行清单脚本（list、get），并保存基线输出。
3. 每次只应用一个变更（监听器/服务器组/转发规则/负载均衡实例生命周期）。
4. 必要时等待异步操作完成（scripts/waitforjob.py）。
5. 通过健康检查和状态重新查询来验证最终状态。

主要任务操作手册

1) 只读清单与快速诊断

bash
python3 scripts/list_instances.py --region cn-hangzhou --json --output output/aliyun-alb-manage/instances.json
python3 scripts/listservergroups.py --region cn-hangzhou --json --output output/aliyun-alb-manage/server-groups.json
python3 scripts/list_acls.py --region cn-hangzhou --json --output output/aliyun-alb-manage/acls.json

2) 检查单个 ALB 及监听器详情

bash
python3 scripts/getinstancestatus.py --region cn-hangzhou --lb-id alb-xxx --view detail --output output/aliyun-alb-manage/lb-detail.json
python3 scripts/list_listeners.py --region cn-hangzhou --lb-id alb-xxx --json --output output/aliyun-alb-manage/listeners.json
python3 scripts/getlistenerattribute.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/listener-attr.json

3) 验证流量路径健康状态

bash
python3 scripts/checkhealthstatus.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/health.json
python3 scripts/listservergroup_servers.py --region cn-hangzhou --server-group-id sgp-xxx --output output/aliyun-alb-manage/server-group-members.json

4) 受控变更流程（示例：更新监听器）

bash
python3 scripts/update_listener.py --region cn-hangzhou --listener-id lsn-xxx --request-timeout 120 --output output/aliyun-alb-manage/update-listener.json
python3 scripts/checkhealthstatus.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/health-after-update.json

5) 资源生命周期操作

• - ALB 生命周期：createloadbalancer.py、deleteloadbalancer.py、deletionprotection.py
• 监听器生命周期：createlistener.py、startlistener.py、stoplistener.py、deletelistener.py
• 服务器组生命周期：createservergroup.py、addservers.py、removeservers.py、deleteservergroup.py
• 转发规则生命周期：createrule.py、updaterule.py、deleterule.py

参考文档

• - API 快速映射：references/apiquickmap.md
• 脚本目录：references/scripts_catalog.md
• 故障排除：references/troubleshooting.md
• 日志与分析：references/log-analysis.md
• 依赖/顺序：references/resource-dependencies.md
• 来源：references/sources.md