This project is unofficial project. You can develop ros2 application without native ros2 environment. This is support script for easily ros2 with docker development.
- Docker
- Operation system is macOS or Linux
Do don't need install. only build docker image for ros2.
$git clone https://github.com/masato-ka/ros2-docker.git
$cd ros2-docker/app_build_container
$docker build -t <Own image name> .
$cd ../
$sudo chmod +x ros2-docker.sh
$export PATH=$PATH:$PWD/ros2-docker.sh
$ros-docker.sh [Options] <workspace> <command> [Command Options]
| Options | Description |
|---|---|
| -i [container image name] | Set a custom Docker image to be used when executing the command. |
| -g | Used to run ros2 run or launch with GUI. |
| -t [container image name] | Set the name of the docker image to be created when rosdep is executed. |
| command | Description |
|---|---|
| create | create ros pkg. |
| build | build ros pkg. |
| run | run ros node. |
| launch | launch ros launch file |
| bundle | bundle ros package. |
| vcs | run vcs |
| rosdep | run rosdep |
| rviz | run rviz |
| gazebo | run gazebo |
- 1.Running ROS2 tutorial Trying dummy robot demo.
$mkdir -p ros_ws/src
$git clone clone https://github.com/ros2/demos.git ./ros_ws/src
$cd ros_ws/src/demo && git checkout foxy
$cd ../../
$ros2-docker.sh -o ros2-sample-image:latest ros_ws rosdep install --from-paths src --ignore-src -r -y
$ros2-docker.sh -i ros2-sample-image ros_ws build
$ros2-docker.sh ros_ws launch dummy_robot_bringup dummy_robot_bringup.launch.py
## Other terminal
$ros2-docker.sh ros_ws rviz
## You can see rviz by VNC (localhost:5900).
$mkdir -p moveit_ws/src
$curl wget https://raw.githubusercontent.com/ros-planning/moveit2/main/moveit2.repos -o moveit_ws/.rosintall
$ros2-docker moveit_ws vcs
## Attention: You need all download directory move to src folder manually.
## rosdep subcommand create new docker image that is resolve dependencies for moveit.
$ros2-docker -t moveit_depends_image moveit_ws rosdep install -r --from-paths . --ignore-src --rosdistro foxy -y
## Take many time for build.
## Attention: Builded pkg is not contain in docker image. Therefor if you need moveit for your own pkg, create new docker image manually.
$ros2-docker -i moveit_depends_image moveit_ws build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release
## You
$ros20docker -i moveit_depends_image -g ros2 launch run_moveit_cpp run_moveit_cpp.launch.py
## You can see rviz by VNC (localhost:5900).
- Attention
If VNC show black screen you need change rviz setting.
Please open file moveit_ws/install/run_moveit_cpp/share/run_moveit_cpp/launch/run_moveit_cpp.rviz with some editor.
Then change to 0 Window Geometry X and Y.
Execute ros2 create commmand to workspace/src directory.
$mkdir -p workspace/src
$ros2-docker.sh workspace create <pkg_name> --build-type ament_cmake --node-name own_node
Execute ros2 build command to workspace.
$ros2-docker.sh workspace build
Execute ros2 run command to run your own node.
$ros2-docker.sh workspace run <pkg_name> <node_name>
If your own node need X display.
$ros2-docker -g workspace run <pkg_name> <node_name>
After connect localhost:5900 by VNC tool(macOS recommend Tiger VNC.)
Execute ros2 launch command to run your own launch file.
$ros2-docker.sh workspace launch <pkg_name> <launch file>
If you contain gui application in your launch file.
$ros2-docker.sh -g workspace launch <pkg_name> <node_name>
After connect localhost:5900 by VNC tool(macOS recommend Tiger VNC.)
Execute the rviz command to run the rviz GUI, which will be drawn on a virtual buffer in X Window and served outside the container via VNC from port 5900.
$ros2-docker.sh workspace rviz
After connect localhost:5900 by VNC tool(macOS recommend Tiger VNC.)
Execute the gazebo command to run the gazebo GUI, which will be drawn on a virtual buffer in X Window and served outside the container via VNC from port 5900.
$ros2-docker.sh workspace gazebo
After connect localhost:5900 by VNC tool(macOS recommend Tiger VNC.)
Run vcs import < .rosinstall under the specified workspace. The current version will only process .rosinstall files under the workspace.
.rosinstall if it exists directly under the workspace
$ros2-docker.sh workspace vcs
Run the rosdep command under the workspace to resolve the dependency. Create a new Docker image containing the resolved dependencies with the name specified by -o.
$ros2-docker.sh -o <new docker image name> <workspacename> \
rosdep install -r --from-paths . --ignore-src --rosdistro foxy -y
- 2021/01/30 version 0.1.0 First release shell script version.
If you find bug or want to new functions, please write issue.
If you fix your self, please fork and send pull request.
This software license under MIT licence.