Adore cli
ADORe command line interface (CLI)
The ADORe CLI is a docker runtime context that provides a complete set of tools for execution and development within adore. For more information on this tool please visit https://github.com/DLR-TS/adore_cli
The ADORe CLI context provides the following features: * Execution environment for all ADORe related binaries * A pre-generated catkin workspace located at adore/catkin_workspace * Reuse of previously generated binaries and build artifacts. All build artifacts generated previously with make build can be executed in this environment * Headless, native or windowed plotlab server running as a docker compose service. The display mode for plotlab server can be configured with the docker-compose.yaml. For more information on plotlab server please review the README.md provided by that module at plotlabserver/README.md server can be configured * ros master running as a docker compose service * All ROS tools preinstalled * some basic development and debugging tools * ZSH
ADORe CLI Usage
Change directory to the root of the ADORe project and run:
make cli
On first run of the ADORe CLI the system will be built including all core modules. Initial build can take 10-15 minutes depending on system and network.
Once the ADORe CLI context builds and starts you will be presented with a zsh shell context:
Welcome to the ADORe Development CLI Ubuntu 20.04.6 LTS (GNU/Linux 5.19.0-45-generic x86_64)
____
__/ |_\__
| -.
......'-(_)---(_)--'
Type 'help' for more information.
Waiting for plotlab server ... plotlab server ready
Vehicle environment set to: Development
ADORe CLI: adore git:(main) (0)>
⚠ WARNING: Any changes to the adore cli context require manually invoking a build for it to take effect! The ADORE CLI is only built on first invocation of 'make cli'
This will build all necessary ADORe components and launch a docker context.
How do I know if I am in the ADORe CLI context?
- If you are in the ADORe CLI context you should have a shell prompt similar to
the following:
ADORe CLI: adore git:(master) (0)>
- you can also check your current user with:
whoami
should report:
adore-cli
Persistence
When running the ADORe CLI the adore source directory is mounted as a volume. It will be mounted with the same path as the parent context. Any changes made in the adore source tree will persist on the host/parent file system.