rostainer 0.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. rostainer-0.0.1/.gitignore +213 -0
  2. rostainer-0.0.1/LICENSE +21 -0
  3. rostainer-0.0.1/PKG-INFO +85 -0
  4. rostainer-0.0.1/README.md +59 -0
  5. rostainer-0.0.1/docker/.dockerignore +24 -0
  6. rostainer-0.0.1/docker/docker-compose.gpu-amd.yml +25 -0
  7. rostainer-0.0.1/docker/docker-compose.gpu-intel.yml +19 -0
  8. rostainer-0.0.1/docker/docker-compose.gpu-nvidia.yml +30 -0
  9. rostainer-0.0.1/docker/docker-compose.runtime.yml +78 -0
  10. rostainer-0.0.1/docker/docker-compose.yml +204 -0
  11. rostainer-0.0.1/docker/docker_entrypoint.py +1150 -0
  12. rostainer-0.0.1/docker/dummy_post_build.sh +10 -0
  13. rostainer-0.0.1/docker/dummy_pre_build.sh +7 -0
  14. rostainer-0.0.1/docker/dummy_shell_setup.sh +6 -0
  15. rostainer-0.0.1/docker/extra_dirs.py +158 -0
  16. rostainer-0.0.1/docker/install.py +454 -0
  17. rostainer-0.0.1/docker/pylsp-config.json +31 -0
  18. rostainer-0.0.1/docker/pylsp-wrapper +22 -0
  19. rostainer-0.0.1/docker/ros1.Dockerfile +161 -0
  20. rostainer-0.0.1/docker/ros2.Dockerfile +177 -0
  21. rostainer-0.0.1/docker/ros_log_pruner.py +164 -0
  22. rostainer-0.0.1/docker/runtime_entrypoint.py +261 -0
  23. rostainer-0.0.1/examples/envrc.example +5 -0
  24. rostainer-0.0.1/examples/rostainer.toml.example +291 -0
  25. rostainer-0.0.1/pyproject.toml +78 -0
  26. rostainer-0.0.1/scripts/cli/rostainer_cli/__init__.py +29 -0
  27. rostainer-0.0.1/scripts/cli/rostainer_cli/_version.py +24 -0
  28. rostainer-0.0.1/scripts/cli/rostainer_cli/cli.py +146 -0
  29. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/__init__.py +40 -0
  30. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/init.py +115 -0
  31. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/logs.py +79 -0
  32. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/package.py +88 -0
  33. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/package_create.py +710 -0
  34. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/prune.py +272 -0
  35. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/rebuild.py +97 -0
  36. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/restart.py +89 -0
  37. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/shell.py +139 -0
  38. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/start.py +428 -0
  39. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/status.py +87 -0
  40. rostainer-0.0.1/scripts/cli/rostainer_cli/cmd/stop.py +88 -0
  41. rostainer-0.0.1/scripts/cli/rostainer_cli/compose_override.py +253 -0
  42. rostainer-0.0.1/scripts/cli/rostainer_cli/config.py +1020 -0
  43. rostainer-0.0.1/scripts/cli/rostainer_cli/docker_utils.py +755 -0
  44. rostainer-0.0.1/scripts/cli/rostainer_cli/extra_dirs.py +362 -0
  45. rostainer-0.0.1/scripts/cli/rostainer_cli/host_scripts.py +123 -0
  46. rostainer-0.0.1/scripts/cli/rostainer_cli/lockfile.py +106 -0
  47. rostainer-0.0.1/scripts/cli/rostainer_cli/log.py +126 -0
  48. rostainer-0.0.1/scripts/cli/rostainer_cli/mappings.py +207 -0
  49. rostainer-0.0.1/scripts/cli/rostainer_cli/ros2_daemon.py +214 -0
  50. rostainer-0.0.1/scripts/cli/rostainer_cli/update_check.py +232 -0
@@ -0,0 +1,213 @@
1
+ # Created by https://www.toptal.com/developers/gitignore/api/visualstudiocode,python,emacs
2
+ # Edit at https://www.toptal.com/developers/gitignore?templates=visualstudiocode,python,emacs
3
+
4
+ # Docker ROS Tools - This is a tool repository, not a workspace
5
+ # Ignore any test workspaces or temporary files created during development
6
+ .compose_starter_info
7
+ .docker-compose.override.yml
8
+ .direnv/
9
+ builds/
10
+ # Generated from git tags by hatch-vcs at build/install time
11
+ scripts/cli/rostainer_cli/_version.py
12
+ ### Emacs ###
13
+ # -*- mode: gitignore; -*-
14
+ *~
15
+ \#*\#
16
+ /.emacs.desktop
17
+ /.emacs.desktop.lock
18
+ *.elc
19
+ auto-save-list
20
+ tramp
21
+ .\#*
22
+
23
+ # Org-mode
24
+ .org-id-locations
25
+ *_archive
26
+
27
+ # flymake-mode
28
+ *_flymake.*
29
+
30
+ # eshell files
31
+ /eshell/history
32
+ /eshell/lastdir
33
+
34
+ # elpa packages
35
+ /elpa/
36
+
37
+ # reftex files
38
+ *.rel
39
+
40
+ # AUCTeX auto folder
41
+ /auto/
42
+
43
+ # cask packages
44
+ .cask/
45
+ dist/
46
+
47
+ # Flycheck
48
+ flycheck_*.el
49
+
50
+ # server auth directory
51
+ /server/
52
+
53
+ # projectiles files
54
+ .projectile
55
+
56
+ # directory configuration
57
+ .dir-locals.el
58
+
59
+ # network security
60
+ /network-security.data
61
+
62
+
63
+ ### Python ###
64
+ # Byte-compiled / optimized / DLL files
65
+ __pycache__/
66
+ *.py[cod]
67
+ *$py.class
68
+
69
+ # C extensions
70
+ *.so
71
+
72
+ # Distribution / packaging
73
+ .Python
74
+ build/
75
+ develop-eggs/
76
+ downloads/
77
+ eggs/
78
+ .eggs/
79
+ lib/
80
+ lib64/
81
+ parts/
82
+ sdist/
83
+ var/
84
+ wheels/
85
+ share/python-wheels/
86
+ *.egg-info/
87
+ .installed.cfg
88
+ *.egg
89
+ MANIFEST
90
+
91
+ # PyInstaller
92
+ # Usually these files are written by a python script from a template
93
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
94
+ *.manifest
95
+ *.spec
96
+
97
+ # Installer logs
98
+ pip-log.txt
99
+ pip-delete-this-directory.txt
100
+
101
+ # Unit test / coverage reports
102
+ htmlcov/
103
+ .tox/
104
+ .nox/
105
+ .coverage
106
+ .coverage.*
107
+ .cache
108
+ nosetests.xml
109
+ coverage.xml
110
+ *.cover
111
+ *.py,cover
112
+ .hypothesis/
113
+ .pytest_cache/
114
+ cover/
115
+
116
+ # Translations
117
+ *.mo
118
+ *.pot
119
+
120
+ # Django stuff:
121
+ *.log
122
+ local_settings.py
123
+ db.sqlite3
124
+ db.sqlite3-journal
125
+
126
+ # Flask stuff:
127
+ instance/
128
+ .webassets-cache
129
+
130
+ # Scrapy stuff:
131
+ .scrapy
132
+
133
+ # Sphinx documentation
134
+ docs/_build/
135
+
136
+ # PyBuilder
137
+ .pybuilder/
138
+ target/
139
+
140
+ # Jupyter Notebook
141
+ .ipynb_checkpoints
142
+
143
+ # IPython
144
+ profile_default/
145
+ ipython_config.py
146
+
147
+ # pyenv
148
+ # For a library or package, you might want to ignore these files since the code is
149
+ # intended to run in multiple environments; otherwise, check them in:
150
+ # .python-version
151
+
152
+ # pipenv
153
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
154
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
155
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
156
+ # install all needed dependencies.
157
+ #Pipfile.lock
158
+
159
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow
160
+ __pypackages__/
161
+
162
+ # Celery stuff
163
+ celerybeat-schedule
164
+ celerybeat.pid
165
+
166
+ # SageMath parsed files
167
+ *.sage.py
168
+
169
+ # Environments
170
+ .env
171
+ .venv
172
+ env/
173
+ venv/
174
+ ENV/
175
+ env.bak/
176
+ venv.bak/
177
+
178
+ # Spyder project settings
179
+ .spyderproject
180
+ .spyproject
181
+
182
+ # Rope project settings
183
+ .ropeproject
184
+
185
+ # mkdocs documentation
186
+ /site
187
+
188
+ # mypy
189
+ .mypy_cache/
190
+ .dmypy.json
191
+ dmypy.json
192
+
193
+ # Pyre type checker
194
+ .pyre/
195
+
196
+ # pytype static type analyzer
197
+ .pytype/
198
+
199
+ # Cython debug symbols
200
+ cython_debug/
201
+
202
+ ### VisualStudioCode ###
203
+ .vscode/
204
+
205
+ # Local History for Visual Studio Code
206
+ .history/
207
+
208
+ ### VisualStudioCode Patch ###
209
+ # Ignore all local history of files
210
+ .history
211
+ .ionide
212
+
213
+ # End of https://www.toptal.com/developers/gitignore/api/visualstudiocode,python,emacs
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Woods Hole Oceanographic Institution
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,85 @@
1
+ Metadata-Version: 2.5
2
+ Name: rostainer
3
+ Version: 0.0.1
4
+ Summary: A flexible, distro agnostic tool for ROS (1 and 2) development using Docker containers
5
+ Project-URL: Homepage, https://git.whoi.edu/bmillerklugman/rostainer
6
+ Author: rostainer contributors
7
+ License-Expression: MIT
8
+ License-File: LICENSE
9
+ Keywords: devcontainer,docker,robotics,ros,ros2
10
+ Classifier: Environment :: Console
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: License :: OSI Approved :: MIT License
13
+ Classifier: Operating System :: POSIX :: Linux
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Topic :: Software Development :: Embedded Systems
16
+ Classifier: Topic :: System :: Systems Administration
17
+ Requires-Python: >=3.8
18
+ Requires-Dist: tomli; python_version < '3.11'
19
+ Provides-Extra: docs
20
+ Requires-Dist: myst-parser; extra == 'docs'
21
+ Requires-Dist: shibuya; extra == 'docs'
22
+ Requires-Dist: sphinx>=7; extra == 'docs'
23
+ Provides-Extra: test
24
+ Requires-Dist: coverage; extra == 'test'
25
+ Description-Content-Type: text/markdown
26
+
27
+ # rostainer
28
+
29
+ [![pipeline status](https://git.whoi.edu/bmillerklugman/rostainer/badges/main/pipeline.svg)](https://git.whoi.edu/bmillerklugman/rostainer/-/commits/main)
30
+ [![coverage report](https://git.whoi.edu/bmillerklugman/rostainer/badges/main/coverage.svg)](https://git.whoi.edu/bmillerklugman/rostainer/-/commits/main)
31
+ [![PyPI](https://img.shields.io/pypi/v/rostainer.svg)](https://pypi.org/project/rostainer/)
32
+
33
+ A flexible, distro agnostic tool for ROS (1 and 2) development using
34
+ Docker containers.
35
+
36
+ Requires Docker and Python 3 on the host; target machines for
37
+ `rostainer package` deployments need only Docker. On Python 3.11+ the
38
+ CLI is standard-library only; on older Python (e.g. Ubuntu 22.04's
39
+ default 3.10) pipx also installs the small `tomli` package, for reading
40
+ `.rostainer.toml`.
41
+
42
+ ## Full documentation
43
+
44
+ This README only covers the quick start. Everything else - the full
45
+ `.rostainer.toml` settings reference, GPU acceleration, hardware access,
46
+ volume mounts, networking, packaging for deployment, LSP setup, and the
47
+ `rostainer_cli` API reference - lives in `docs/`. Build and open it
48
+ locally:
49
+
50
+ ```bash
51
+ pip install -r docs/requirements.txt
52
+ sphinx-build -b html docs docs/_build/html
53
+ python3 -m http.server -d docs/_build/html # then open http://localhost:8000
54
+ ```
55
+
56
+ ## Quick Start
57
+
58
+ ```bash
59
+ pipx install rostainer # or: uv tool install rostainer (see docs/)
60
+
61
+ mkdir my_ros_workspace && cd my_ros_workspace
62
+ rostainer init # scaffolds .rostainer.toml and src/
63
+ rostainer start # prompts for ROS distro/middleware
64
+ rostainer shell # drop into the running container
65
+ ```
66
+
67
+ ## Commands
68
+
69
+ - **`rostainer init`** - Initialize a new ROS workspace with example configs
70
+ - **`rostainer start`** - Start ROS environment (prompts for distro/middleware)
71
+ - **`rostainer restart`** - Restart ROS environment, keeping its build (fast)
72
+ - **`rostainer rebuild`** - Rebuild the workspace from scratch (`--image`: the
73
+ Docker image too)
74
+ - **`rostainer stop`** - Stop running ROS environment, for `start` to
75
+ resume quickly (`--rm`: remove the container; the build is kept either way)
76
+ - **`rostainer shell`** - Drop into bash shell in running container
77
+ - **`rostainer logs`** - Show a running container's logs, or just its build errors
78
+ - **`rostainer status`** - Show status of ROS environment
79
+ - **`rostainer prune`** - Remove unused build caches, old images and old package
80
+ bundles
81
+ - **`rostainer package`** - Build a deployable runtime image and install it
82
+ on a target machine
83
+
84
+ ## Credits
85
+ This toolkit created with help from LLMs (Claude + Gemini)
@@ -0,0 +1,59 @@
1
+ # rostainer
2
+
3
+ [![pipeline status](https://git.whoi.edu/bmillerklugman/rostainer/badges/main/pipeline.svg)](https://git.whoi.edu/bmillerklugman/rostainer/-/commits/main)
4
+ [![coverage report](https://git.whoi.edu/bmillerklugman/rostainer/badges/main/coverage.svg)](https://git.whoi.edu/bmillerklugman/rostainer/-/commits/main)
5
+ [![PyPI](https://img.shields.io/pypi/v/rostainer.svg)](https://pypi.org/project/rostainer/)
6
+
7
+ A flexible, distro agnostic tool for ROS (1 and 2) development using
8
+ Docker containers.
9
+
10
+ Requires Docker and Python 3 on the host; target machines for
11
+ `rostainer package` deployments need only Docker. On Python 3.11+ the
12
+ CLI is standard-library only; on older Python (e.g. Ubuntu 22.04's
13
+ default 3.10) pipx also installs the small `tomli` package, for reading
14
+ `.rostainer.toml`.
15
+
16
+ ## Full documentation
17
+
18
+ This README only covers the quick start. Everything else - the full
19
+ `.rostainer.toml` settings reference, GPU acceleration, hardware access,
20
+ volume mounts, networking, packaging for deployment, LSP setup, and the
21
+ `rostainer_cli` API reference - lives in `docs/`. Build and open it
22
+ locally:
23
+
24
+ ```bash
25
+ pip install -r docs/requirements.txt
26
+ sphinx-build -b html docs docs/_build/html
27
+ python3 -m http.server -d docs/_build/html # then open http://localhost:8000
28
+ ```
29
+
30
+ ## Quick Start
31
+
32
+ ```bash
33
+ pipx install rostainer # or: uv tool install rostainer (see docs/)
34
+
35
+ mkdir my_ros_workspace && cd my_ros_workspace
36
+ rostainer init # scaffolds .rostainer.toml and src/
37
+ rostainer start # prompts for ROS distro/middleware
38
+ rostainer shell # drop into the running container
39
+ ```
40
+
41
+ ## Commands
42
+
43
+ - **`rostainer init`** - Initialize a new ROS workspace with example configs
44
+ - **`rostainer start`** - Start ROS environment (prompts for distro/middleware)
45
+ - **`rostainer restart`** - Restart ROS environment, keeping its build (fast)
46
+ - **`rostainer rebuild`** - Rebuild the workspace from scratch (`--image`: the
47
+ Docker image too)
48
+ - **`rostainer stop`** - Stop running ROS environment, for `start` to
49
+ resume quickly (`--rm`: remove the container; the build is kept either way)
50
+ - **`rostainer shell`** - Drop into bash shell in running container
51
+ - **`rostainer logs`** - Show a running container's logs, or just its build errors
52
+ - **`rostainer status`** - Show status of ROS environment
53
+ - **`rostainer prune`** - Remove unused build caches, old images and old package
54
+ bundles
55
+ - **`rostainer package`** - Build a deployable runtime image and install it
56
+ on a target machine
57
+
58
+ ## Credits
59
+ This toolkit created with help from LLMs (Claude + Gemini)
@@ -0,0 +1,24 @@
1
+ .envrc
2
+ Dockerfile
3
+ *.Dockerfile
4
+ docker-compose.yml
5
+ .dockerignore
6
+
7
+ .git # Git version control directory
8
+ .gitignore # Git ignore file
9
+ .vscode # VS Code editor configuration
10
+ .idea # IntelliJ/PyCharm IDE configuration
11
+ __pycache__/ # Python compiled bytecode
12
+ *.pyc # Python compiled bytecode files
13
+ *.log # Log files
14
+ *.tmp # Temporary files
15
+ *.swp # Vim swap files
16
+ .DS_Store # macOS specific files
17
+ npm-debug.log # Node.js debug logs
18
+ node_modules/ # Node.js dependencies (if applicable)
19
+ build/ # Common build output directory
20
+ dist/ # Common distribution output directory
21
+ *.egg-info/ # Python packaging info
22
+ .pytest_cache/ # Pytest cache directory
23
+
24
+ .env
@@ -0,0 +1,25 @@
1
+ # AMD GPU override for docker-compose.yml
2
+ # This file is automatically included when gpu_vendor = "amd" in .rostainer.toml
3
+ # Requires: ROCm drivers installed on host
4
+ # Do not edit this file directly - configure GPU support in ros_docker_config.env
5
+
6
+ services:
7
+ ros1_app:
8
+ devices:
9
+ - /dev/dri:/dev/dri
10
+ - /dev/kfd:/dev/kfd
11
+ group_add:
12
+ - video
13
+ - render
14
+ environment:
15
+ ROC_ENABLE_PRE_VEGA: 1
16
+
17
+ ros2_app:
18
+ devices:
19
+ - /dev/dri:/dev/dri
20
+ - /dev/kfd:/dev/kfd
21
+ group_add:
22
+ - video
23
+ - render
24
+ environment:
25
+ ROC_ENABLE_PRE_VEGA: 1
@@ -0,0 +1,19 @@
1
+ # Intel GPU override for docker-compose.yml
2
+ # This file is automatically included when gpu_vendor = "intel" in .rostainer.toml
3
+ # Requires: Intel compute runtime installed on host
4
+ # Do not edit this file directly - configure GPU support in ros_docker_config.env
5
+
6
+ services:
7
+ ros1_app:
8
+ devices:
9
+ - /dev/dri:/dev/dri
10
+ group_add:
11
+ - video
12
+ - render
13
+
14
+ ros2_app:
15
+ devices:
16
+ - /dev/dri:/dev/dri
17
+ group_add:
18
+ - video
19
+ - render
@@ -0,0 +1,30 @@
1
+ # NVIDIA GPU override for docker-compose.yml
2
+ # This file is automatically included when gpu_vendor = "nvidia" in .rostainer.toml
3
+ # Requires: nvidia-container-toolkit installed on host
4
+
5
+ services:
6
+ ros1_app:
7
+ environment:
8
+ NVIDIA_VISIBLE_DEVICES: all
9
+ NVIDIA_DRIVER_CAPABILITIES: all
10
+ deploy:
11
+ resources:
12
+ reservations:
13
+ devices:
14
+ - driver: cdi
15
+ device_ids:
16
+ - nvidia.com/gpu=all
17
+ capabilities: [gpu]
18
+
19
+ ros2_app:
20
+ environment:
21
+ NVIDIA_VISIBLE_DEVICES: all
22
+ NVIDIA_DRIVER_CAPABILITIES: all
23
+ deploy:
24
+ resources:
25
+ reservations:
26
+ devices:
27
+ - driver: cdi
28
+ device_ids:
29
+ - nvidia.com/gpu=all
30
+ capabilities: [gpu]
@@ -0,0 +1,78 @@
1
+ # Runtime Docker Compose file for packaged deployments.
2
+ #
3
+ # Unlike docker-compose.yml, this has no 'build:' section - it only ever
4
+ # runs an image that was already built by 'rostainer package create' and
5
+ # loaded with 'docker load'. It must never try to pull or build
6
+ # 'ros:${ROS_DISTRO}-ros-base'.
7
+ x-shared-environment: &shared-environment
8
+ RUNTIME_COMMAND: ${RUNTIME_COMMAND:-}
9
+ USER_UID: ${USER_UID:-1000}
10
+ USER_GID: ${USER_GID:-1000}
11
+ USERNAME: ${USERNAME:-rosuser}
12
+ ROS_LOG_MAX_SIZE_MB: ${ROS_LOG_MAX_SIZE_MB:-1024}
13
+ ROS_LOG_MAX_AGE_DAYS: ${ROS_LOG_MAX_AGE_DAYS:-30}
14
+ # Optional watchdog (see runtime_entrypoint.supervise).
15
+ RUNTIME_HEALTHCHECK: ${RUNTIME_HEALTHCHECK:-}
16
+ RUNTIME_HEALTHCHECK_INTERVAL: ${RUNTIME_HEALTHCHECK_INTERVAL:-30}
17
+ RUNTIME_HEALTHCHECK_RETRIES: ${RUNTIME_HEALTHCHECK_RETRIES:-3}
18
+ RUNTIME_HEALTHCHECK_START_PERIOD: ${RUNTIME_HEALTHCHECK_START_PERIOD:-60}
19
+ # ROS 2 discovery (see 'ros_discovery_range' in .rostainer.toml).
20
+ ROS_AUTOMATIC_DISCOVERY_RANGE: ${ROS_AUTOMATIC_DISCOVERY_RANGE:-SUBNET}
21
+ ROS_STATIC_PEERS: ${ROS_STATIC_PEERS:-}
22
+ ROS_DOMAIN_ID: ${ROS_DOMAIN_ID:-0}
23
+ # Humble's equivalent of ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST.
24
+ ROS_LOCALHOST_ONLY: ${ROS_LOCALHOST_ONLY:-}
25
+ # Docker keeps a container's stdout/stderr (everything 'docker logs' shows)
26
+ # without any limit by default, which on a long-running deployment
27
+ # eventually fills the disk.
28
+ x-shared-logging: &shared-logging
29
+ driver: json-file
30
+ options:
31
+ max-size: ${DOCKER_LOG_MAX_SIZE:-10m}
32
+ max-file: "${DOCKER_LOG_MAX_FILES:-5}"
33
+ # Shows the watchdog's state in 'docker ps'. Restarting is the
34
+ # entrypoint's job: Docker never restarts an unhealthy container itself.
35
+ x-shared-healthcheck: &shared-healthcheck
36
+ test: ["CMD-SHELL", "[ ! -f /tmp/.runtime_unhealthy ]"]
37
+ interval: 10s
38
+ timeout: 5s
39
+ retries: 1
40
+
41
+ services:
42
+ ros1_runtime:
43
+ image: ${ROS_DOCKER_IMAGE_TAG}
44
+ container_name: ${ROS1_CONTAINER_NAME:-ros1_container}
45
+ profiles:
46
+ - ros1
47
+ tty: true
48
+ stdin_open: true
49
+ user: "${USER_UID:-1000}:${USER_GID:-1000}"
50
+ environment:
51
+ <<: *shared-environment
52
+ network_mode: ${NETWORK_MODE:-host}
53
+ # 'restart_policy' in .rostainer.toml; packages restart by default.
54
+ restart: ${RESTART_POLICY:-always}
55
+ healthcheck: *shared-healthcheck
56
+ logging: *shared-logging
57
+ # A real PID 1 that forwards SIGTERM (the runtime command, or 'tail -f
58
+ # /dev/null', may ignore it as PID 1) and reaps the background pruner.
59
+ init: true
60
+
61
+ ros2_runtime:
62
+ image: ${ROS_DOCKER_IMAGE_TAG}
63
+ container_name: ${ROS2_CONTAINER_NAME:-ros2_container}
64
+ profiles:
65
+ - ros2
66
+ tty: true
67
+ stdin_open: true
68
+ user: "${USER_UID:-1000}:${USER_GID:-1000}"
69
+ environment:
70
+ <<: *shared-environment
71
+ network_mode: ${NETWORK_MODE:-host}
72
+ # 'restart_policy' in .rostainer.toml; packages restart by default.
73
+ restart: ${RESTART_POLICY:-always}
74
+ healthcheck: *shared-healthcheck
75
+ logging: *shared-logging
76
+ # A real PID 1 that forwards SIGTERM (the runtime command, or 'tail -f
77
+ # /dev/null', may ignore it as PID 1) and reaps the background pruner.
78
+ init: true