README.md

MoveIt2 Docker Image

The MoveIt2 Docker image uses the Space ROS docker image (openrobotics/spaceros:latest) as its base image. The MoveIt2 Dockerfile installs all of the prerequisite system dependencies to build MoveIt2 (and Moveit2 tutorials) and then pulls and builds the latest MoveIt2 and Moveit2 tutorials source code.

Building the MoveIt2 Image

To build the docker image, run:

./build.sh

By default, this will build on top of the latest released version of the Space ROS base image (typically osrf/space-ros:latest). If building locally, the underlying base image can be set in the build script, or through the environment with:

# Use a locally built image as the base
SPACE_ROS_IMAGE="space-ros:main" ./build.sh

The build process will take about 30 minutes, depending on the host computer.

Running the MoveIt2 Docker Image in a Container

After building the image, you can see the newly-built image by running:

docker image list

The output will look something like this:

REPOSITORY              TAG                        IMAGE ID       CREATED        SIZE
openrobotics/moveit2    latest                     6edb2edc9643   10 hours ago   15.5GB
openrobotics/spaceros   latest                     629b13cf7b74   12 hours ago   7.8GB
nvidia/cudagl           11.4.1-devel-ubuntu20.04   336416dfcbba   1 week ago     5.35GB

The new image is named openrobotics/moveit2:latest.

There is a run.sh script provided for convenience that will run the spaceros image in a container.

./run.sh

Upon startup, the container automatically runs the entrypoint.sh script, which sources the MoveIt2 and Space ROS environment files. You'll now be running inside the container and should see a prompt similar to this:

spaceros-user@8e73b41a4e16:~/moveit2#

Running MoveIt2 Tutorials

Run the following command to launch the MoveIt2 tutorials demo launch file:

ros2 launch moveit2_tutorials demo.launch.py rviz_tutorial:=true

You should see lots of console output and the rviz2 window appear:

You can now follow the MoveIt2 Tutorial documentation.

Running the MoveIt2 Move Group C++ Interface Demo

To run the Move Group C++ Interface Demo, execute the following command:

ros2 launch moveit2_tutorials move_group.launch.py

Then, you can follow the Move Group C++ Interface Demo documentation.

Running the Space ROS Space Robots Demos

Once you have tested that MoveIt2 works, you are ready to run some of the other Space ROS space robot demos.