Docker 容器
Docker 容器被提供用于完整的 PX4 开发工具链,包括基于 NuttX 和 Linux 的硬件,Gazebo Simulation 和 ROS。
本主题说明如何使用 available docker containers 访问本地 Linux 计算机中的构建环境。
为您的 Linux 计算机 Install Docker,最好使用 Docker 维护的一个软件包存储库来获取最新的稳定版本。 您可以使用 Enterprise Edition 或(free)Community Edition。 :::
系统必备组件
默认安装要求您以 root 用户身份调用 * Docker*(即使用sudo
)。 如果您希望 use Docker as a non-root user,您可以选择将用户添加到“docker”组,然后注销或者登陆:
下面列出了可用的本地编辑(来自 Github):
可以使用 latest
标记访问最新版本:px4io/px4-dev-ros:latest
(为 hub.docker.com 上的每个容器列出可用标记。 例如,px4-dev-ros 标签可以在 here)。 That way, your build folder won't be owned by root after using docker.
本地编辑层次结构
The available containers are on Github here.
使用容器的最简单方法是通过 docker_run.sh 帮助程序脚本。 此脚本将 PX4 构建命令作为参数(例如 make tests
)。 For example, below you can see that the docker container with nuttx build tools (px4-dev-nuttx-focal
) does not include ROS 2, while the simulation containers do:
px4io/px4-dev-base-focal
px4io/px4-dev-nuttx-focal
px4io/px4-dev-simulation-focal
px4io/px4-dev-ros-noetic
px4io/px4-dev-ros2-foxy
The most recent version can be accessed using the latest
tag: px4io/px4-dev-nuttx-bionic:latest
(available tags are listed for each container on hub.docker.com. For example, the px4io/px4-dev-nuttx-bionic
tags can be found here).
Typically you should use a recent container, but not necessarily the latest
(as this changes too often).
使用 Docker 容器
典型命令的语法如下所示。 这将运行一个支持 X 指令的 Docker 容器(使容器内部的模拟 GUI 可用)。
助手脚本(docker_run.sh)
The easiest way to use the containers is via the docker_run.sh helper script. This script takes a PX4 build command as an argument (e.g. make tests
). It starts up docker with a recent version (hard coded) of the appropriate container and sensible environment settings.
下面的具体示例显示了如何打开 bash shell 并在主机上共享目录 〜/src/Firmware。
Or to start a bash session using the NuttX toolchain:
docker run
命令只能用于创建新容器。 要重新进入此容器(将保留您的更改),只需执行以下操作: The manual approach discussed in the section below is more flexible and should be used if you have any problems with the script. :::
手动调用 Docker
The syntax of a typical command is shown below. This runs a Docker container that has support for X forwarding (makes the simulation GUI available from inside the container). It maps the directory <host_src>
from your computer to <container_src>
inside the container and forwards the UDP port needed to connect QGroundControl. With the -–privileged
option it will automatically have access to the devices on your host (e.g. a joystick and GPU). If you connect/disconnect a device you have to restart the container.
Where,
<host_src>
: The host computer directory to be mapped to<container_src>
in the container. This should normally be the PX4-Autopilot directory.<container_src>
: The location of the shared (source) directory when inside the container.<local_container_name>
: A name for the docker container being created. This can later be used if we need to reference the container again.<container>:<tag>
: The container with version tag to start - e.g.:px4io/px4-dev-ros:2017-10-23
.<build_command>
: The command to invoke on the new container. E.g.bash
is used to open a bash shell in the container.
The concrete example below shows how to open a bash shell and share the directory ~/src/PX4-Autopilot on the host computer.
运行模拟实例时,例如在 docker 容器内的 SITL 并通过 QGroundControl 从主机控制它,必须手动设置通信链接。 QGroundControl 的自动连接功能在此处不起作用。
重新进入容器
The docker run
command can only be used to create a new container. To get back into this container (which will retain your changes) simply do:
If you need multiple shells connected to the container, just open a new shell and execute that last command again.
清理容器
Sometimes you may need to clear a container altogether. You can do so using its name:
If you can't remember the name, then you can list inactive container ids and then delete them, as shown below:
QGroundControl
在这种情况下,必须安装主机系统的本机图形驱动程序。 下载正确的驱动程序并将其安装在容器中。
In QGroundControl, navigate to Settings and select Comm Links. Create a new link that uses the UDP protocol. The port depends on the used configuration e.g. port 14570 for the SITL config. The IP address is the one of your docker container, usually 172.17.0.1/16 when using the default network. The IP address of the docker container can be found with the following command (assuming the container name is mycontainer
):
:正在创建的 docker 容器的名称 如果我们需要再次引用容器,以后可以使用它。
故障处理
权限错误
The container creates files as needed with a default user - typically "root". This can lead to permission errors where the user on the host computer is not able to access files created by the container.
The example above uses the line --env=LOCAL_USER_ID="$(id -u)"
to create a user in the container with the same UID as the user on the host. This ensures that all files created within the container will be accessible on the host.
图形驱动问题
It's possible that running Gazebo will result in a similar error message like the following:
In that case the native graphics driver for your host system must be installed. Download the right driver and install it inside the container. For Nvidia drivers the following command should be used (otherwise the installer will see the loaded modules from the host and refuse to proceed):
如果编译失败,则出现以下错误:
虚拟机支持
尝试禁用并行构建。
The following configuration is tested:
OS X with VMWare Fusion and Ubuntu 14.04 (Docker container with GUI support on Parallels make the X-Server crash).
Memory
Use at least 4GB memory for the virtual machine.
Compilation problems
If compilation fails with errors like this:
Try disabling parallel builds.
Allow Docker Control from the VM Host
Edit /etc/defaults/docker
and add this line:
You can then control docker from your host OS:
Last updated