如何快速搭建ONIE开发环境？Docker镜像构建完整指南

【免费下载链接】onieOpen Network Install Environment项目地址: https://gitcode.com/gh_mirrors/on/onie

ONIE（Open Network Install Environment）是一款开源网络安装环境工具，本文将为新手和普通用户提供使用Docker快速搭建ONIE开发环境的完整指南，帮助你轻松进入ONIE的开发世界。

准备工作：安装Docker环境

要搭建ONIE开发环境，首先需要在你的主机系统上安装Docker。对于基于Debian的系统，可以通过以下命令进行安装：

sudo apt-get update sudo apt-get install docker.io

安装完成后，为了避免每次使用Docker都需要sudo权限，可以将你的用户添加到docker组：

sudo adduser $USER docker

添加用户到docker组后，需要注销并重新登录，或者使用su - $USER命令使更改生效。

构建ONIE Docker镜像

ONIE项目提供了专门的Dockerfile来构建开发环境。在项目的contrib/build-env目录下可以找到相关文件。进入该目录后，执行以下命令构建Docker镜像：

docker build -t debian:build-env .

如果后续修改了Dockerfile需要重新构建镜像，可以先停止并删除已有的容器：

docker stop onie docker rm onie

然后再重新执行docker build命令。

创建共享目录

为了方便在主机和Docker容器之间共享文件，需要创建一个可写的目录。在主机上执行以下命令：

mkdir --mode=0777 -p ${HOME}/src

这个目录在Docker容器中会被挂载为/home/build/src，用于存放ONIE的源代码和构建产物。

登录到Docker容器

使用以下命令创建并登录到ONIE开发容器：

docker run -it -v ${HOME}/src:/home/build/src --name onie debian:build-env

登录成功后，你会看到类似build@f1063a996da6:~$的命令提示符。如果不小心断开了与容器的连接，可以使用docker attach onie命令重新连接。

克隆ONIE代码库

在容器中，作为build用户，可以使用提供的clone-onie脚本克隆ONIE代码库：

./clone-onie

这会将ONIE代码库克隆到/home/build/src/onie目录下。如果你需要手动克隆，可以使用以下命令：

git clone https://gitcode.com/gh_mirrors/on/onie /home/build/src/onie

构建ONIE镜像

进入ONIE的build-config目录：

cd src/onie/build-config

现在你可以开始构建ONIE镜像了。对于不同的目标平台，构建命令有所不同：

• 构建KVM平台的ONIE镜像：

  make -j4 MACHINE=kvm_x86_64 all

• 构建Accton平台的ONIE镜像（以accton_as7816_64x为例）：

  make -j4 MACHINEROOT=../machine/accton MACHINE=accton_as7816_64x all

构建完成后，ONIE的镜像文件会保存在主机的${HOME}/src/onie/build/images目录下。你可以在主机上查看这些文件：

ls -l ${HOME}/src/onie/build/images

注意事项

.gitconfig配置

Docker环境中默认设置了一个假的.gitconfig，用户名是Build User，邮箱是build@example.com。如果你需要进行实际的开发工作，建议修改这些信息为你自己的用户名和邮箱。

用户/组ID问题

容器内的build用户和组ID在主机环境中可能没有意义，这也是为什么我们将构建目录设置为世界可写权限的原因。这确保了在主机和容器之间可以正常地共享文件。

通过以上步骤，你已经成功搭建了ONIE的Docker开发环境。现在你可以开始探索ONIE的各种功能，进行定制化开发了。如果你需要更详细的构建步骤，可以参考项目中machine目录下各个平台对应的INSTALL文件。

【免费下载链接】onieOpen Network Install Environment项目地址: https://gitcode.com/gh_mirrors/on/onie