Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/toshikinakamura0412/dockerfiles
Development environment using Docker for some Linux distributions
https://github.com/toshikinakamura0412/dockerfiles
alpine bash cuda debian devcontainer devcontainers docker docker-compose fedora opencv opensuse ros ros-humble ros-noetic ros2 ubuntu ubuntu2004 ubuntu2204 vscode zsh
Last synced: 26 days ago
JSON representation
Development environment using Docker for some Linux distributions
- Host: GitHub
- URL: https://github.com/toshikinakamura0412/dockerfiles
- Owner: ToshikiNakamura0412
- License: mit
- Created: 2024-04-30T10:12:50.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-09-15T08:37:07.000Z (about 2 months ago)
- Last Synced: 2024-09-30T05:03:32.228Z (about 1 month ago)
- Topics: alpine, bash, cuda, debian, devcontainer, devcontainers, docker, docker-compose, fedora, opencv, opensuse, ros, ros-humble, ros-noetic, ros2, ubuntu, ubuntu2004, ubuntu2204, vscode, zsh
- Language: Shell
- Homepage:
- Size: 105 KB
- Stars: 0
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dockerfiles
[](https://opensource.org/licenses/MIT)
- Development environment using Docker for [some Linux distributions](#docker)
- You can use GUI applications without setting up xhost.
- Linux Only
- You use macOS, you need to set up xhost.
- [dotfiles](https://github.com/ToshikiNakamura0412/dotfiles.git) is included in the image
- tmux prefix set to `C-q`
## Environment
### OS
- Linux
- macOS (Not support GPU)
- Prerequisite: [XQuartz](https://www.xquartz.org/)
### Architecture
- x86_64
- arm64
### Editor
- VSCode
- Neovim (Not support completion: ROS2)
- CentOS Stream: Not support Neovim. Please use Vim.
## Prerequisites
### Common
- make
- [docker](https://docs.docker.com/engine/install/ubuntu/#installation-methods)
### GPU
#### Use
- nvidia-container-runtime
- If you can't install this package, install [nvidia-container-toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html#installing-with-apt) before installing this package.
- If you can't use GPU, execute the following command:
```bash
sudo systemctl restart docker
```
#### Not use
- Please disable GPU by [custom](#custom) setup
## Installation
### Clone
Please clone to your home directory
```bash
git clone https://github.com/ToshikiNakamura0412/dockerfiles.git ~/dockerfiles
```
### Setup
#### Default
create directories (e.g. [workspace](#workspace))
```bash
cd ~/dockerfiles
make setup # create directories
```
#### Custom
```bash
cd ~/dockerfiles
make [target] [arg=]
...
make setup # create directories
```
- show help of make: `make help`
- show help of target: `make [target] arg=-h`
- target: `change_root_dir`, `disable_gpu`, `select_shell`, `setup`, `sync_git_user`
**If you already start the container, you need to execute the following command to reflect the changes.**
```bash
docker compose up [option -d]
```
## Clean
- remove directories (e.g. [workspace](#workspace)) and revert to the default state
- **If the directories are not empty, they will not be deleted**
```bash
cd ~/dockerfiles
make clean
```
## Docker
| | Distro | Default Shell | Base Image | Contents | README |
|---|---|---|---|---|---|
| [alpine3.17](alpine3.17) | Alpine3.17 | zsh | [alpine (Official)](https://hub.docker.com/_/alpine) | | |
| [archlinux](archlinux) | ArchLinux | zsh | [archlinux (Official)](https://hub.docker.com/_/archlinux) | | |
| [centos-stream9](centos-stream9) | CentOS Stream9 | zsh | [centos (Official)](https://quay.io/repository/centos/centos) | | |
| [debian12](debian12) | Debian12 | zsh | [debian (Official)](https://hub.docker.com/_/debian) | | |
| [fedora40](fedora40) | Fedora40 | zsh | [fedora (Official)](https://hub.docker.com/_/fedora) | | |
| [humbe](humble) | Ubuntu22.04 | zsh | [ros (Official)](https://hub.docker.com/_/ros) | ROS2 Humble | |
| [noetic](noetic) | Ubuntu20.04 | zsh | [ros (Official)](https://hub.docker.com/_/ros) | ROS1 Noetic | |
| [noetic-cuda](noetic-cuda) | Ubuntu20.04 | zsh | [cuda (Official)](https://hub.docker.com/r/nvidia/cuda) | ROS1 Noetic + CUDA-11.6.1-devel | |
| [noetic-cuda-opencv](noetic-cuda-opencv) | Ubuntu20.04 | zsh | noetic-cuda (Custom) | ROS1 Noetic + CUDA-11.6.1-devel + OpenCV-5.x | [README](noetic-cuda-opencv/README.md) |
| [noetic-pcl10](noetic-pcl10) | Ubuntu20.04 | zsh | noetic (Custom) | ROS1 Noetic + PCL10 | [README](noetic-pcl10/README.md) |
| [noetic-pcl14](noetic-pcl14) | Ubuntu20.04 | zsh | noetic (Custom) | ROS1 Noetic + PCL14 | [README](noetic-pcl14/README.md) |
| [opensuse-leap15.6](opensuse-leap15.6) | OpenSUSE Leap15.6 | zsh | [opensuse/leap (Official)](https://hub.docker.com/r/opensuse/leap) | | |
| [ubuntu20.04](ubuntu20.04) | Ubuntu20.04 | zsh | [ubuntu (Official)](https://hub.docker.com/_/ubuntu) | | |
| [ubuntu22.04](ubuntu22.04) | Ubuntu22.04 | zsh | [ubuntu (Official)](https://hub.docker.com/_/ubuntu) | | |
- Alpine does not yet support nvidia-container-runtime
- macOS does not support ROS, so please use virtual machines like [UTM](https://mac.getutm.app/)
### Workspace
- host:
- default: `~/ws`
- ROS1: `~/ros1_ws`
- ROS2: `~/ros2_ws`
- container:
- all: `~/ws`
### Usage
#### Basic usage
```bash
cd
docker compose up [option -d] # create and start (-d: detached)
docker compose start # start
docker compose stop # stop
docker compose down # stop and remove
```
If you want to create different containers of the same environment, execute the following:
```bash
docker compose -p up [option -d]
```
#### Use Shell
```bash
cd
docker compose exec ws # e.g. zsh, bash, tmux
```
- bash: All Distro Support
- zsh: Only Ubuntu Support
#### Use VSCode
prerequisite: extension `ms-vscode-remote.remote-containers`
```bash
cd
code .
```
- Click on `Reopen in container` to run container
- If you don't click on `Reopen in container`, execute `~/install_vscode_extensions.sh` in the container to install the extension
## Recommendation
- If you are creating a new IMAGE, it is recommended that you build the provided image and create an image based on it.
- Use `docker compose up` to check if the build is done correctly.
## References
- https://docs.ros.org/en/rolling/How-To-Guides/Setup-ROS-2-with-VSCode-and-Docker-Container.html