OSRF Docker Images环境搭建从源码到容器的完整步骤【免费下载链接】docker_imagesA repository to hold definitions of docker images maintained by OSRF项目地址: https://gitcode.com/gh_mirrors/doc/docker_imagesGitHub 加速计划 / doc / docker_images 项目是由 OSRF 维护的 Docker 镜像定义仓库提供了 Gazebo、ROS、ROS2 等机器人开发相关的官方镜像构建方案。本指南将带你完成从源码克隆到容器运行的全流程帮助新手快速搭建专业的机器人开发环境。 准备工作环境与工具检查在开始前请确保你的系统已安装以下工具Docker Engine (20.10 版本)GitPython 3.6 (用于运行镜像生成脚本)你可以通过以下命令验证 Docker 是否安装正确docker --version docker run hello-world # 测试Docker基础功能 第一步获取项目源码通过 Git 克隆仓库到本地git clone https://gitcode.com/gh_mirrors/doc/docker_images cd docker_images项目结构清晰主要包含以下核心目录gazebo/: Gazebo 仿真器各版本镜像定义ros/: ROS 1 各发行版镜像 (如 melodic, noetic)ros2/: ROS 2 镜像 (如 foxy, galactic)doc/: 官方文档 (doc/environment_setup.md)️ 第二步配置构建环境进入项目根目录后先安装构建所需的依赖cd docker pip install --no-cache-dir -r requirements.txtrequirements.txt 文件中包含了构建脚本所需的 Python 依赖如 Jinja2 模板引擎和 PyYAML 配置解析库。️ 第三步生成 Dockerfile (可选)项目提供了自动化脚本用于生成不同版本的 Dockerfile# 生成ROS镜像Dockerfile示例 cd ros python create_dockerfiles.py脚本会根据manifest.yaml配置文件和模板自动生成各版本的 Dockerfile。例如ROS 2 Humble 版本的核心镜像定义位于 ros/humble/ubuntu/jammy/ros-core/Dockerfile。 第四步构建 Docker 镜像以 Gazebo 11 为例构建基础镜像cd gazebo/11/ubuntu/focal/gzserver11 docker build -t osrf/gazebo:11-focal .Dockerfile 采用分层构建策略基础镜像是 Ubuntu 20.04 (focal)FROM ubuntu:focal RUN echo Etc/UTC /etc/timezone \ ln -s /usr/share/zoneinfo/Etc/UTC /etc/localtime \ apt-get update apt-get install -q -y --no-install-recommends tzdata构建过程中会自动添加 OSRF 软件源并安装 Gazebo 依赖RUN apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys D2486D2DD83DB69272AFE98867170598AF249743 RUN . /etc/os-release \ echo deb http://packages.osrfoundation.org/gazebo/$ID-stable $VERSION_CODENAME main /etc/apt/sources.list.d/gazebo-latest.list RUN apt-get update apt-get install -y --no-install-recommends gazebo11 第五步运行容器镜像构建完成后启动 Gazebo 服务器容器docker run -it --rm osrf/gazebo:11-focal gzserverGazebo 镜像默认配置了入口点脚本自动处理环境变量设置ENTRYPOINT [/gzserver_entrypoint.sh] CMD [gzserver]如果需要图形界面可以运行 Gazebo 客户端容器需配置 X11 转发docker run -it --rm \ -e DISPLAY$DISPLAY \ -v /tmp/.X11-unix:/tmp/.X11-unix \ osrf/gazebo:11-focal gzclient 常用镜像构建与运行示例ROS 2 Humble 开发环境cd ros/humble/ubuntu/jammy/desktop docker build -t osrf/ros:humble-desktop-jammy . docker run -it --rm osrf/ros:humble-desktop-jammyROS Noetic 基础镜像cd ros/noetic/ubuntu/focal/ros-core docker build -t osrf/ros:noetic-ros-core-focal . docker run -it --rm osrf/ros:noetic-ros-core-focal roscore 项目核心文件说明create_dockerfiles.py: 镜像生成主脚本 (ros/create_dockerfiles.py)manifest.yaml: 镜像版本配置 (ros/manifest.yaml)ros_entrypoint.sh: ROS 环境初始化脚本 (ros/noetic/ubuntu/focal/ros-core/ros_entrypoint.sh)Makefile: 构建自动化工具 (gazebo/11/ubuntu/focal/Makefile)❓ 常见问题解决构建速度慢可修改 Dockerfile 中的软件源为国内镜像如将http://packages.osrfoundation.org替换为国内镜像权限问题运行容器时添加--user $(id -u):$(id -g)参数避免文件权限冲突图形界面显示确保主机已安装xhost并执行xhost local:docker允许容器访问 X 服务器通过本指南你已掌握从源码构建 OSRF 官方 Docker 镜像的完整流程。这些镜像为机器人开发提供了标准化环境无论是学习 ROS、Gazebo 仿真还是开发实际机器人应用都能显著提升开发效率。更多高级配置可参考项目文档 doc/maintaining_repo.md。【免费下载链接】docker_imagesA repository to hold definitions of docker images maintained by OSRF项目地址: https://gitcode.com/gh_mirrors/doc/docker_images创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
