内容
# 网络 CI/CD 实验室
基于思科 CML 的网络实验室,配备使用 Ansible、pyATS、GitHub Actions 和 GitLab CI 的全套 CI/CD 流水线。
## 实验室
| 实验室 | ID | OOB 范围 | 目的 |
|-----|----|-----------|---------|
| 生产环境 | `7148e855-6c7e-458a-a649-c5f4ccacf4fa` | 172.30.1.x/22 | 流水线验证目标 |
| 开发环境 | `f9c13319-e511-4df8-a709-7e472a13d74d` | 172.30.2.x/22 | 活跃开发 |
## 快速开始
```bash
# 安装依赖
pip install ansible pyats genie
ansible-galaxy collection install -r ansible/collections/requirements.yml
# 启动 CML 实验室后 - 将 ISSUE-001 修复应用于 MGMT 交换机
./scripts/lab-startup.sh all
# 对开发环境运行完整流水线
ansible-playbook ansible/playbooks/pipeline.yml -i ansible/inventory/dev.yml \
-e vault_device_password=admin123 -e vault_enable_password=admin123 \
-e vault_dev_snmp_ro=devread -e vault_dev_snmp_rw=devwrite
# 只运行验证
ansible-playbook ansible/playbooks/validate.yml -i ansible/inventory/dev.yml \
-e vault_device_password=admin123 -e vault_enable_password=admin123 \
-e vault_dev_snmp_ro=devread -e vault_dev_snmp_rw=devwrite
# 运行 pyATS 测试
pyats run job tests/pyats/network_tests.py --testbed tests/pyats/testbed.yaml
```
## 仓库结构
```
.
├── .github/
│ └── workflows/
│ └── network-cicd.yml GitHub Actions 流水线
├── ansible/
│ ├── ansible.cfg
│ ├── collections/
│ │ └── requirements.yml cisco.ios, ansible.netcommon
│ ├── inventory/
│ │ ├── prod.yml 生产环境设备清单
│ │ ├── dev.yml 开发环境设备清单
│ │ └── group_vars/
│ │ ├── all/
│ │ │ ├── main.yml 公共变量
│ │ │ └── vault.yml 凭证(使用 ansible-vault 加密)
│ │ ├── prod/main.yml 生产环境特定变量
│ │ └── dev/main.yml 开发环境特定变量
│ ├── playbooks/
│ │ ├── deploy.yml 完整部署
│ │ ├── validate.yml 仅验证
│ │ ├── oob_fix.yml ISSUE-001 修复
│ │ └── pipeline.yml 完整 CI/CD 序列
│ └── roles/
│ ├── baseline/ 主机名、NTP、SNMP、SSH、日志记录
│ ├── oob_fix/ ISSUE-001 自动修复
│ ├── security/ ACL、VTY 加固
│ ├── interfaces/ 接口配置
│ ├── routing/ OSPF、静态路由、STP、DHCP 嗅探
│ └── validate/ 所有验证检查,包括 ISSUE-001
├── gitlab/
│ └── .gitlab-ci.yml GitLab CI 流水线(复制到仓库根目录)
├── tests/
│ └── pyats/
│ ├── testbed.yaml pyATS 设备测试台
│ └── network_tests.py 测试套件
├── docs/
│ └── known-issues.md ISSUE-001、ISSUE-002 文档
├── scripts/
│ └── lab-startup.sh 启动后 ISSUE-001 修复助手
└── topologies/
├── PROD-Network-Lab.yaml CML 拓扑导出
└── DEV-Network-Lab.yaml CML 拓扑导出
```
## 流水线流程
```
feature/* 或 dev/* 分支推送
│
▼
┌─────────┐
│ 代码检查 │ yamllint + ansible-lint + 语法检查
└────┬────┘
│
▼
┌──────────┐
│ oob_fix │ ISSUE-001 修复应用于 MGMT 交换机
└────┬─────┘
│
▼
┌───────────┐
│ 预检查 │ 验证当前状态(非阻塞)
└─────┬─────┘
│
▼
┌────────┐
│ 部署 │ 基线 → 安全 → 接口 → 路由
└────┬───┘
│
▼
┌──────────────┐
│ 验证后 │ Ansible 验证 + pyATS 测试
└──────────────┘
│
│ (合并到 main 分支 - 手动审批)
▼
┌──────────────┐
│ 生产环境部署 │ 相同的序列,手动关口
└──────────────┘
```
## 已知问题
参见 [docs/known-issues.md](docs/known-issues.md)。
**ISSUE-001 — MGMT 交换机 Vlan99 SVI 关闭:** `PROD-MGMT-SW` 和 `DEV-MGMT-SW` 都需要在每次全新启动后应用手动 `ip routing`。`oob_fix` 角色和 `oob_fix.yml` 剧本自动执行此操作。在启动 CML 实验室后始终运行 `lab-startup.sh`。
## GitHub 设置
1. 添加仓库机密:`DEVICE_PASSWORD`、`ENABLE_PASSWORD`、`PROD_SNMP_RO`、`PROD_SNMP_RW`、`DEV_SNMP_RO`、`DEV_SNMP_RW`
2. 在设置 → 环境中创建环境 `dev` 和 `prod`
3. 为 `prod` 环境添加所需的审阅者以进行手动审批
4. 确保您的 GitHub Actions 运行器具有访问 `172.30.x.x` 的网络权限
## GitLab 设置
1. 将 `gitlab/.gitlab-ci.yml` 复制到仓库根目录作为 `.gitlab-ci.yml`
2. 在设置 → CI/CD → 变量中添加 CI/CD 变量:与 GitHub 机密相同的集合
3. 注册一个带有标签 `network-lab` 和访问 `172.30.x.x` 网络权限的 GitLab Runner
## 设备凭证
| 字段 | 值 |
|-------|-------|
| 用户名 | admin |
| 密码 | admin123 |
| 启用 | admin123 |
| 生产环境 SNMP RO | prodread |
| 开发环境 SNMP RO | devread |