cinience/alicloud-skills/aliyun-alb-manage

Category: service

Application Load Balancer (ALB)

Use this skill for end-to-end ALB operations via local Python scripts and OpenAPI-compatible workflows.

Validation

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 "py_compile_ok" > output/aliyun-alb-manage/validate.txt

Pass criteria: command exits 0 and output/aliyun-alb-manage/validate.txt is generated.

Output And Evidence

• Save all command outputs, request parameters, and API responses under output/aliyun-alb-manage/.
• For change operations, keep before/after snapshots plus health-check results.

Prerequisites

pip install alibabacloud_alb20200616 alibabacloud_tea_openapi alibabacloud_credentials

Credential priority:

1. ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET
2. Optional STS token: ALIBABACLOUD_SECURITY_TOKEN
3. Shared config: ~/.alibabacloud/credentials

Workflow

1. Confirm region, VPC context, target ALB resource IDs, and expected change window.
2. Run inventory scripts first (list_*, get_*) and save baseline outputs.
3. Apply one change at a time (listener/server-group/rule/lb lifecycle).
4. Wait for async completion when needed (scripts/wait_for_job.py).
5. Validate final state with health checks and state re-query.

Top task playbooks

1) Read-only inventory and quick diagnosis

python3 scripts/list_instances.py --region cn-hangzhou --json --output output/aliyun-alb-manage/instances.json
python3 scripts/list_server_groups.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) Inspect one ALB and listener details

python3 scripts/get_instance_status.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/get_listener_attribute.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/listener-attr.json

3) Validate traffic path health

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

4) Controlled change flow (example: update listener)

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/check_health_status.py --region cn-hangzhou --listener-id lsn-xxx --output output/aliyun-alb-manage/health-after-update.json

5) Resource lifecycle operations

• ALB lifecycle: create_load_balancer.py, delete_load_balancer.py, deletion_protection.py
• Listener lifecycle: create_listener.py, start_listener.py, stop_listener.py, delete_listener.py
• Server-group lifecycle: create_server_group.py, add_servers.py, remove_servers.py, delete_server_group.py
• Rule lifecycle: create_rule.py, update_rule.py, delete_rule.py

References

• API quick map: references/api_quick_map.md
• Script catalog: references/scripts_catalog.md
• Troubleshooting: references/troubleshooting.md
• Logs and analysis: references/log-analysis.md
• Dependencies/order: references/resource-dependencies.md
• Sources: references/sources.md