bonhams/ndc-deploy-image

NDC Ansible部署镜像

镜像概述

本镜像基于Ansible构建，专门用于自动化部署NDC（Network Device Configuration/网络设备配置）。通过集成Ansible环境及NDC部署所需的基础依赖，提供开箱即用的部署工具链，解决手动部署NDC过程中环境不一致、步骤繁琐、易出错等问题，实现NDC部署的标准化、自动化和可追溯。

核心功能与特性

1. 集成完整Ansible环境

• 内置Ansible核心组件及常用模块（如ios_config、junos_config等网络设备配置模块），无需额外安装Ansible及依赖。
• 预配置Python环境及网络设备SSH连接依赖（如paramiko、netmiko），确保与主流网络设备（Cisco、Juniper等）的兼容性。

2. 提供NDC部署剧本模板

• 包含基础NDC部署Ansible Playbook模板，覆盖设备初始化、配置下发、校验等核心流程。
• 支持用户自定义剧本扩展，可通过挂载外部剧本文件实现个性化部署逻辑。

3. 灵活的配置管理

• 支持通过环境变量或配置文件自定义部署参数（如目标设备列表、认证信息、配置版本等）。
• 支持敏感信息（如设备密码）通过加密文件或环境变量注入，避免明文暴露。

4. 部署过程可审计与追溯

• 自动记录部署日志（含执行步骤、配置变更、设备响应等），日志支持挂载外部卷持久化存储。
• 支持生成部署报告，包含成功/失败设备清单、配置差异对比等信息。

5. 跨平台兼容性

• 基于轻量级Linux发行版构建，支持在x86_64、ARM等主流架构的Docker环境中运行。

使用场景

• 网络设备配置批量部署：需同时配置多台网络设备（如交换机、路由器）的NDC场景。
• NDC版本升级：需统一升级网络设备配置版本，确保配置一致性的场景。
• 标准化部署流程：需要在团队或企业内推行统一NDC部署规范，减少人为操作差异的场景。
• 快速环境重建：测试或灾备场景中，需快速重建NDC环境的场景。

使用方法

1. 获取镜像

假设镜像已发布至Docker仓库（如Docker Hub），通过以下命令拉取：

bash
docker pull ndc-ansible-deploy:latest

2. 准备配置文件

• Ansible主机清单（inventory）：定义目标网络设备列表及连接信息（IP、端口、认证方式等），示例：

  ini
  # inventory/hosts
  [ndc_targets]
  device1 ansible_host=192.168.1.1 ansible_user=admin
  device2 ansible_host=192.168.1.2 ansible_user=admin
  

• 自定义部署剧本（可选）：若需覆盖默认模板，准备自定义Playbook文件（如custom-ndc-deploy.yml）。
• 敏感信息文件（可选）：通过Ansible Vault加密的密码文件（如vault-pass.txt）。

3. 运行部署容器

通过docker run命令启动容器，挂载配置文件并指定部署参数：

bash
docker run -d \
  --name ndc-deploy \
  -v $(pwd)/inventory:/ansible/inventory \  # 挂载主机清单
  -v $(pwd)/playbooks:/ansible/playbooks \  # 挂载自定义剧本（可选）
  -v $(pwd)/logs:/ansible/logs \            # 挂载日志目录（持久化）
  -e ANSIBLE_INVENTORY=/ansible/inventory/hosts \  # 指定主机清单路径
  -e NDC_DEPLOY_PLAYBOOK=/ansible/playbooks/custom-ndc-deploy.yml \  # 自定义剧本路径（默认使用内置模板）
  -e ANSIBLE_VAULT_PASSWORD_FILE=/ansible/vault-pass.txt \  # Vault密码文件路径（可选）
  ndc-ansible-deploy:latest

4. 查看部署状态与日志

• 查看容器运行状态：docker ps -f name=ndc-deploy
• 查看实时部署日志：docker logs -f ndc-deploy
• 部署完成后，日志文件将保存在宿主机挂载的./logs目录下。

5. 停止与清理容器

部署完成后，可停止并删除容器（日志已持久化，不影响数据保留）：

bash
docker stop ndc-deploy && docker rm ndc-deploy

环境变量说明

注意事项

• 确保宿主机与目标网络设备之间网络通畅，容器需具备访问目标设备SSH端口（默认22）的权限。
• 敏感信息（如设备密码）建议通过Ansible Vault加密或环境变量注入，避免直接暴露在配置文件中。
• 自定义剧本需遵循Ansible语***范，且依赖的模块需确保已包含在镜像内置的Ansible环境中。