avinetworks/avitools

avinetworks/avitools Docker镜像文档

镜像概述

avinetworks/avitools镜像旨在提供现场所需的所有迁移和验证工具。具体包含的工具列表可参考Dockerfile。该镜像主要用于Avi Vantage的部署、测试、维护及故障排查工作。

拉取镜像

该镜像没有latest标签，需指定具体版本拉取，示例：

bash
docker pull avinetworks/avitools:$VERSION

例如拉取20.1.3版本：

bash
docker pull avinetworks/avitools:20.1.3

使用方法

通过run.sh脚本使用

可通过git仓库中的run.sh脚本使用该镜像：

bash
# 下载run.sh脚本
curl -O https://raw.githubusercontent.com/avinetworks/avitools/master/run.sh
# 添加执行权限
chmod a+x run.sh
# 查看帮助
./run.sh -h

脚本参数说明

• -v string: 指定AVI_VERSION，默认值为20.1.3
• -c string: 指定要执行的命令，在此模式下容器会在命令执行后创建并销毁，默认值为avitools-list
• -d string: 指定工作目录（配置文件所在位置），默认值为/Users/smarunich/GitHub/avitools/scripts/avi
• -u: 更新Docker镜像（尝试重新拉取镜像）
• -b: 后台运行模式，创建avitools容器并保留，脚本执行后可通过docker exec -it avitools bash访问容器
• -n: 使用主机网络而非Docker默认网络（即docker run --net=host）

查看支持的命令

显示avitools支持的命令：

bash
# 使用默认版本
./run.sh -c avitools-list 或 ./run.sh
# 指定版本
./run.sh -v 20.1.3 -c avitools-list

运行具体命令

基本使用格式：

bash
sh run.sh -v <AVI_VERSION> -d <DIR> -c <COMMAND>

示例：

bash
# 查看f5_converter.py帮助
./run.sh -c "f5_converter.py -h"
# 执行f5_converter.py转换文件
./run.sh -c "f5_converter.py -f <filename>"
# 指定版本和工作目录
./run.sh -v 20.1.3 -d /home/aviuser -c "f5_converter.py -h"
./run.sh -v 20.1.3 -d /home/aviuser -c "f5_converter.py -f <filename>"

运行Ansible Playbook

bash
./run.sh -c "ansible-playbook <playbook-name> -v"

后台运行容器

bash
# 创建后台容器
./run.sh -v 20.1.3 -c bash -d /home/aviuser/workspace -b
# 进入容器
docker exec -it avitools bash

使用主机网络

支持在后台和前台/命令模式下使用主机网络：

bash
# 后台模式
./run.sh -v 20.1.3 -n -c bash -d /home/aviuser/workspace -b
# 前台命令模式
./run.sh -v 20.1.3 -n -d /home/aviuser -c "f5_converter.py -h"

可选操作

构建镜像

bash
cd build
docker build -t avinetworks/avitools:20.1.3 .

使用migrationtools镜像

1. 首先构建Docker镜像
2. 运行scripts目录下的run.sh脚本来使用avitools