Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags. |
Installing Tiago Tutorial Docker
Description: How to pull and launch a docker all set up for the Tiago Tutorial with melodic or noeticTutorial Level: BEGINNER
Next Tutorial: Robots/TIAGo/Tutorials/Installation/Testing_simulation
Author: Job van Dieten < job.1994@gmail.com >, Sai Kishor Kothakota < sai.kishor@pal-robotics.com >
Maintainer: Jordi Pages < jordi.pages@pal-robotics.com >, Thomas Peyrucain < thomas.peyrucain@pal-robotics.com >
Support: tiago-support@pal-robotics.com
Source: https://github.com/pal-robotics/tiago_tutorials.git
Show EOL distros:
Docker-based installation
These instructions assume that you have a basic docker understanding and have already installed it. Please familiarize yourself using the docker tutorials.
First of all open a terminal and pull the image of tiago_tutorials:
docker pull palroboticssl/tiago_tutorials:melodic
Rocker is mandatory for the following tutorials to have a graphical user interface with docker. osrf/rocker,it is a tool to run docker images with customized local support injected for things like nvidia support, and user_id specific files for cleaner mounting file permissions. You could also find more useful information on this topic on Tooling with Docker.
- rocker with nvidia support:.
You would need first to install nvidia docker support : https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker :
distribution=$(. /etc/os-release;echo $ID$VERSION_ID) && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list sudo apt-get update sudo apt-get install -y nvidia-docker2 sudo systemctl restart docker
And then run the rockerrocker --home --user --nvidia --x11 --privileged palroboticssl/tiago_tutorials:melodic
- rocker with intel integrated graphics support:
rocker --home --user --x11 --privileged palroboticssl/tiago_tutorials:melodic --devices /dev/dri/card0
The options --home and --user are used so that the user won't be root and home directory will be mounted
If you are using a version of rocker that is lower than version 0.2.4, you would need to remove the --privileged option
Once you are inside the rocker you can do
terminator -u
To open a terminal inside the rocker that will allow you to use several terminals on the same rocker (Do not forget to source them all)
To check that everything is properly installed run the TIAGo simulation tutorial
Docker-based installation
These instructions assume that you have a basic docker understanding and have already installed it. Please familiarize yourself using the docker tutorials.
First of all, open a terminal and pull the image of tiago_tutorials:
docker pull palroboticssl/tiago_tutorials:noetic
Rocker is mandatory for the following tutorials to have a graphical user interface with docker. osrf/rocker, it is a tool to run docker images with customized local support injected for things like Nvidia support, and user_id specific files for cleaner mounting file permissions. You could also find more helpful information on this topic on Tooling with Docker.
- rocker with Nvidia support:
You would need first to install Nvidia docker support : https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker :
distribution=$(. /etc/os-release;echo $ID$VERSION_ID) && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list sudo apt-get update sudo apt-get install -y nvidia-docker2 sudo systemctl restart docker
And then run the rockerrocker --home --user --nvidia --x11 --privileged palroboticssl/tiago_tutorials:noetic
- rocker with intel-integrated graphics support:
rocker --home --user --x11 --privileged palroboticssl/tiago_tutorials:noetic --devices /dev/dri/card0
The options --home and --user are used so that the user won't be root and home directory will be mounted
If you are using a version of rocker that is lower than version 0.2.4, you would need to remove the --privileged option
Once you are inside the rocker you can do
terminator -u
To open a terminal inside the rocker that will allow you to use several terminals on the same rocker (Do not forget to source them all)
To check that everything is properly installed run the TIAGo simulation tutorial