Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sskorol/ros2-humble-docker-dev-template

This repo provides a template for a quick start with a ROS2 Humble development in Docker
https://github.com/sskorol/ros2-humble-docker-dev-template

developer-tools docker robotics ros ros2

Last synced: about 2 months ago
JSON representation

This repo provides a template for a quick start with a ROS2 Humble development in Docker

Host: GitHub
URL: https://github.com/sskorol/ros2-humble-docker-dev-template
Owner: sskorol
License: apache-2.0
Created: 2022-09-01T23:53:25.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2023-06-06T19:06:36.000Z (over 1 year ago)
Last Synced: 2024-10-13T15:47:37.695Z (3 months ago)
Topics: developer-tools, docker, robotics, ros, ros2
Language: Dockerfile
Homepage:
Size: 13.7 KB
Stars: 40
Watchers: 1
Forks: 18
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

## ROS2 Humble - docker dev template

This repo provides a template for a quick start with a ROS2 Humble development in Docker.

### Setup

```shell
git clone https://github.com/sskorol/ros2-humble-docker-dev-template.git && cd ros2-humble-docker-dev-template
./run.sh -h
```

![Help](https://user-images.githubusercontent.com/6638780/188268405-82f77eb3-1308-46ba-b6ba-1ef3f956f0af.png)

### Building

```shell
./run.sh -w dev_ws -i [YOUR_IMAGE_NAME:TAG] -b
```

### Running

- Update `.tmux.conf` if you need to enable additional `tmux` features
- Update `.session.yml` to customize Tmuxinator UI

Note that the above configs are mapped as volumes to docker image.

```shell
./run.sh -w dev_ws -i [YOUR_IMAGE_NAME:TAG] -r
```

### Development

- Follow [this guide](https://code.visualstudio.com/docs/remote/containers) to prepare VSCode for remote development in a container.
- Start the docker container via the command from the [Running](#running) section.
- Open VSCode and [attach](https://code.visualstudio.com/docs/remote/attach-container) to the running container.
- Open your ROS2 workspace and enjoy.

### Notes

- Mouse is enabled by default
- Use pageup/pagedown keys to switch between `tmux` windows (mouse click also works)
- Press shift key to select the text via mouse
- `tmux` ctrl+b prefix is remapped to ctrl+a
- ctrl+a -> x -> y series closes the `tmux` and docker session