A simple script to help programmers who want to work within Docker
This project provides a simple bash script that one can use to do programming tasks in a Docker environment capturing a standard Ubuntu distribution.
The Dockerfile sets up an image (called by default programming_station-for-yourname). The image is built once when you first call the script. It contains the compilers and build tools. It does not contain your code: your code is meant to go in the current directory. Importantly, the very same image can be used over multiple projects.
Then it passes your command: your command runs in the current directory but within the image. Docker does not copy your code to the image: everything is read and stored in the current directory. You also have only access to the current directory from within docker.
So you can do basic programming tasks:
./run-docker-station ' gcc --version '
./run-docker-station ' git clone https://github.com/simdjson/simdjson.git '
./run-docker-station ' mkdir build '
./run-docker-station ' cd build && cmake ../simdjson '
./run-docker-station ' cd build && cmake --build . '
You can even run perf though you need to know where to find it:
./run-docker-station ' /usr/lib/linux-tools/5.4.0-26-generic/perf stat ls '
For convenience, configure you system so that run-docker-station
is in your PATH. If you just want to enter in a bash shell with access to your current directory, you can do so:
run-docker-station bash
Be mindful that the shell will only have access to the current directory and its subdirectories. You should run the script from the directory of your choosing.
If you like, you can even call the script from a Makefile. It is just a regular bash script.
You can put run-docker-station
in your PATH
by adding the docker_programming_station
directory to it and
thus be able to call run-docker-station
from everywhere. Your are not limited to one instance. However, each
instance will only have access to its directory. However, the first time the image is constructed,
you might want to run it in the docker_programming_station
directory otherwise you may get
the error "The Dockerfile must be within the build context".
You can simply copy the Dockerfile and the script in any repository if you prefer to avoid messing
with the PATH
variable.
Features:
Caution:
/home/
or /usr/
as it would be unsafe.Tricks:
run-docker-station
command in your PATH, you will be able to run it from everywhere.docker system prune
, as it can help you remove unneeded images. I recommend running docker image prune -a
regularly.docker rm -vf $(docker ps -a -q) ; docker rmi -f $(docker images -a -q)
. Such a reset can solve a surprising number of otherwise mysterious problems.Under Windows and macOS, docker will only use relatively little memory. You may want to allocate more: Windows and macOS.