技术文档丨如何构建和释放你的Docker容器

Docker是一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移植的镜像中，然后发布到任何流行的 Linux或Windows 机器上，也可以实现虚拟化。

 

  以下，ENJOY  

 

安装Docker

 

构建Apollo的系统需求是Ubuntu 14.04。使用Docker容器是为Apollo项目设置构建环境的最简单方法。一个详细的Docker教程可以在《这里》找到。

 

要安装Docker，可以参考《官方的安装指南Docker-ce》。不要忘记使用《Linux安装后步骤》对其进行测试。

 

构建Apollo

 

启动容器

我们提供了一个名为dev-latest的构建映像。该容器将安装到您本地的Apollo镜像地址 /Apollo。

 

bash docker/scripts/dev_start.sh

进入容器

 

bash docker/scripts/dev_into.sh

 

构建模块

bash apollo.sh build

注意：如果你没有GPU，你可以采用以下的脚本。

 

bash apollo.sh build_cpu

注意：如果你的电脑很慢，你可以输入以下命令来限制CPU。

 

bash apollo.sh build --local_resources 2048,1.0,1.0

 

1. 如果在这一点上，你没有一个可以设置的车辆或者你想确认Apollo已经正确地构建出来，请继续《如何启动并运行Apollo》。

 

2. 如果您有可安装的车辆，请继续回到我们的《软件安装指南》。

在Visual Studio Code中构建

 

安装基于Debian/Ubuntu发行版的最简单方法是从https://code.visualstudio.com下载并安装。deb包(64位)，如果有的话，可以通过图形软件中心安装，也可以通过以下命令行安装：

 

sudo dpkg -i .deb
sudo apt-get install -f # Install dependencies

 

启动VSCode

 

使用以下命令启动VSCode。

 

code

 

在VSCode中打开Apollo项目

 

使用键盘快捷键(Ctrl+K Ctrl+0)打开Apollo项目。

 

在VSCode中进行Apollo项目的所有单元测试

 

使用键盘快捷键(Ctrl+Shift+B)来构建Apollo项目。

 

选择“任务->运行任务...”菜单命令，并点击“运行所有单元测试的Apollo Proiect”从弹出菜单检查代码风格的Apollo项目。

 

如果您目前正在开发16.04，您将得到一个构建错误。如下图所示，进行了两次感知测试。为了避免这个构建错误，请参考如何构建《Apollo using Ubuntu 16》。

 

 

选择“任务->运行任务...”菜单命令，从弹出菜单中点击“Apollo项目的代码样式检查”，检查Apollo项目的代码样式。

 

在VSCode中清零Apollo项目

 

选择“任务->运行任务...”菜单命令，并点击“清理Apollo项目”从弹出菜单中清理Apollo项目。

 

更改构建选项

 

您可以将“Build”选项更改为另一个选项，比如“Build GPU”(详情请参考“Apollo.sh”文件)在"vscode/tasks.json"中。

 

测试

 

bash docker/scripts/release_start.sh [release tag]

HMI将自动启动，您可以通过输入IP地址和端口号(如localhost:8887)，通过任何Web浏览器控制每个Apollo模块。如果需要修复，您可以进入发布容器。

 

bash docker/scripts/release_into.sh

 

法律免责声明

 

您所建立的Docker映像可能包含ESD电子公司(以下简称ESD)提供的ESD CAN库文件，您应该通过与ESD的许可协议获得这些文件。许可协议授予您(作为个人或商业实体)使用ESD提供的上述软件的权利；但是，您可能(很有可能)需要ESD提供明确的重新发布许可，以便发布Docker映像供其他第三方使用。该许可协议仅在您和ESD之间，不受Apollo项目许可条款的约束(见Apollo top目录下的文件许可)。

 

本文部分内容参考链接

*《这里》

https://docs.docker.com/

*《官方安装指南Docker-ce》

https://docs.docker.com/install/linux/docker-ce/ubuntu/

*《Linux安装后步骤》

https://docs.docker.com/install/linux/linux-postinstall/

*《如何启动并运行Apollo》

https://github.com/ApolloAuto/apollo/blob/master/docs/howto/how_to_launch_Apollo.md

*《软件安装指南》

https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_software_installation_guide.md

*《Apollo using Ubuntu 16》

https://github.com/ApolloAuto/apollo/blob/master/docs/howto/how_to_run_apollo_2.5_with_ubuntu16.md