快速参考

• 维护者：
  开源机器人基金会

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

无支持的标签

快速参考（续）

• 提交issue的位置：
  [***]

• 支持的架构：(更多信息)
  无支持的架构

• 发布的镜像工件详情：
  repo-info 仓库的 repos/gazebo/ 目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/gazebo 标签
  official-images 仓库的 library/gazebo 文件 (历史记录)

• 本描述的来源：
  docs 仓库的 gazebo/ 目录 (历史记录)

什么是 Gazebo？

机器人仿真是每个机器人专家工具箱中的必备工具。设计良好的仿真器能够快速测试算法、设计机器人，并使用真实场景进行回归测试。Gazebo能够准确高效地仿真复杂室内外环境中的机器人群体。它提供强大的物理引擎、高质量图形和便捷的编程接口。最重要的是，Gazebo是免费的，拥有活跃的社区。

***.org/wiki/Gazebo_simulator

![logo]([***]

如何使用此镜像

在Gazebo项目中创建 Dockerfile

FROM gazebo:gzserver8
# 此处放置应用程序的特定设置
CMD [ "gzserver", "my-gazebo-app-args" ]

然后可以构建并运行Docker镜像：

$ docker build -t my-gazebo-app .
$ docker run -it -v="/tmp/.gazebo/:/root/.gazebo/" --name my-running-app my-gazebo-app

部署用例

此Gazebo容器化镜像旨在提供一个简化且一致的平台，用于构建和部署基于云的机器人仿真。它基于官方Ubuntu镜像和Gazebo的官方Debian包构建，包含最新的支持版本，便于快速访问和下载。这为研究和工业领域的机器人专家提供了一种简单的方式来开发持续集成和测试，用于自主行动和任务规划训练、控制动力学和稳定区域、运动学建模和原型表征、定位和映射算法、群体行为和网络，以及一般系统集成和验证。

进行此类具有高有效性的复杂仿真仍然计算密集，通常超出普通本地工作站的能力。随着被基准测试算法的复杂性增加，我们很快会超出即使是最强大服务器的能力。因此，对于那些开始遇到集中式计算主机限制的人来说，更分布式的方法仍然具有吸引力。然而，在一组集群上构建和维护分布式测试平台的额外复杂性，长期以来需要比许多小型实验室和企业认为合适的更多时间和精力来实现。

随着软件容器的进步和标准化，机器人专家已经准备好获得一系列改进的开发工具，用于构建和交付软件。为了帮助缓解采用新实践的成长痛苦和技术挑战，我们专注于提供使用Gazebo与这些新技术的官方资源。

部署建议

gzserver标签设计为具有小占用空间和简单配置，因此仅包含所需的Gazebo依赖项。暴露标准消息端口11345以允许客户端连接和消息API。

卷

Gazebo使用~/.gazebo/目录存储日志、模型和场景信息。如果希望这些文件的生命周期超出生成它们的容器的生命周期，可以将~/.gazebo/文件夹挂载到主机上的外部卷，或者派生镜像可以指定由Docker引擎管理的卷。默认情况下，容器以root用户运行，因此/root/.gazebo/是这些文件的完整路径。

例如，如果希望使用本地主目录中已存在的.gazebo文件夹（用户名为ubuntu），只需使用额外的卷参数启动容器：

$ docker run -v "/home/ubuntu/.gazebo/:/root/.gazebo/" gazebo

需要注意的是，gzserver会记录到名为/root/.gazebo/server-<port>/*.log的文件，其中<port>是服务器监听的端口（默认11345）。如果使用相同的默认端口和相同的主机端目录运行和挂载多个容器，它们将冲突并尝试写入同一个文件。如果要在同一docker主机上运行多个gzserver，则需要对~/.gazebo/子文件夹进行更巧妙的卷挂载。

设备

从Gazebo 5.0版本开始，无头实例的gzserver下的物理仿真工作正常。但是，某些应用可能需要图像渲染相机视图和其他传感器模态的光线追踪。对于Gazebo，这需要运行X服务器来渲染和捕获场景。此外，还需要图形硬件加速以获得合理的实时帧率。为此，需要将额外的图形设备挂载到容器中并链接到运行的X服务器。为了保持通用和简约的镜像，使其不与主机系统软件和硬件紧密耦合，此处不包含具有这些额外要求和说明的标签。但是，您可以使用此仓库构建和自定义自己的镜像以适应您的软件/硬件配置。OSRF的Docker Hub组织资料包含Gazebo仓库osrf/gazebo，该仓库基于此仓库，但包含这些高级用例的额外标签。

开发

如果不仅希望运行Gazebo，还希望为其开发，即编译自定义插件或基于ROS的消息接口构建，则需要libgazebo标签中包含的开发包。如果只需要以无头服务器模式运行Gazebo，则gzserver标签的镜像大小更小。

部署示例

在这个简短示例中，我们将启动一个运行gazebo服务器的新容器，使用本地gazebo客户端连接到它，然后生成一个双倒立摆并记录仿真以供以后回放。

首先启动一个带有挂载日志卷的gazebo服务器，并将容器命名为gazebo：

$ docker run -d -v="/tmp/.gazebo/:/root/.gazebo/" --name=gazebo gazebo

现在使用相同的入口点在容器中打开一个新的bash会话来配置环境。然后下载double_pendulum模型并将其加载到仿真中。

$ docker exec -it gazebo bash
$ apt-get update && apt-get install -y curl
$ curl -o double_pendulum.sdf [***]
$ gz model --model-name double_pendulum --spawn-file double_pendulum.sdf

要开始记录运行中的仿真，只需使用gz log即可。

$ gz log --record 1

几秒钟后，通过禁用相同的标志停止记录。

$ gz log --record 0

要查看记录的日志，我们可以导航到日志目录并使用gz log打开并检查摆的运动和关节状态。这将允许您逐步查看摆连杆的位姿。

$ cd ~/.gazebo/log/*/gzserver/
$ gz log --step --hz 10 --filter *.pose/*.pose --file state.log

如果本地安装了等效版本的Gazebo，可以通过将主URI的地址设置为容器的公共地址，使用本地gazebo客户端连接到容器内的gzserver。

$ export GAZEBO_MASTER_IP=$(docker inspect --format '{{ .NetworkSettings.IPAddress }}' gazebo)
$ export GAZEBO_MASTER_URI=$GAZEBO_MASTER_IP:11345
$ gzclient --verbose

在gzclient的渲染OpenGL视图中，您应该看到之前创建的双倒立摆仍在摆动。从这里，您可以使用图形界面控制或监控仿真状态，添加更多摆，重置世界，制作更多日志等。要退出仿真，请关闭gzclient窗口并停止容器。

$ docker stop gazebo
$ docker rm gazebo

即使旧的gazebo容器已被删除，我们仍然可以看到记录的日志保存在主机卷目录中。

$ cd /tmp/.gazebo/log/
$ ls

同样，如果您的主机系统上安装了等效版本的Gazebo，可以使用记录的日志文件通过gazebo回放仿真。

$ export GAZEBO_MASTER_IP=127.0.0.1
$ export GAZEBO_MASTER_URI=$GAZEBO_MASTER_IP:11345
$ cd /tmp/.gazebo/log/*/gzserver/
$ gazebo --verbose --play state.log

更多资源

Gazebosim.org：Gazebo主网站

Answers：查找答案和提问

Wiki：一般信息和教程

邮件列表：获取新闻和公告

仿真模型：机器人、物体和其他仿真模型

博客：保持最新状态

OSRF：开源机器人基金会

许可证

Gazebo采用Apache 2.0开源许可证。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（例如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可证信息可能位于repo-info仓库的gazebo/目录中。

至于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。