dok is a command line tool that helps streamline your workflow with containerized dev environments. Inspired by conda, dok wraps around docker and docker-compose to help you seamlessly swap between bare-metal and containerized environments.
Docker is great. Using docker containers as dev environments is a brilliant idea. But it can also be a just a little bit annoying -- we all go through the tedious docker run -it's, the --user's, the --volumes ./:, followed by the more-than-long-enough list of arguments to create containers. We are all familiar with the small mental gymnatistics we had to excercise to get a partiular image working as a dev env, the little frustraions when the container auto exits or the tty simply won't respond to inputs.
Fine, maybe you are smart and organized, and you use docker compose, so it is all good and managed. But it still can be an annoying to configure volumes, stdin, tty, user everytime in the yaml, oh and don't forget to put a /bin/bash -c "sleep infinity" in the command to keep the container alive! After all the work, you still have to run docker compose up -d && docker exec -it <name> /bin/bash just to run it, then cd to the directory to finally get some work done.
Okay, maybe this is not that bad, but it can be much simpler still. dok simplifies dev environments management; all you need is dok c, a name for the environemnt, and the base image or a docker compose file to create an environment. dok automatically ensures containers do not auto exit and are attached to appropriate shells. Activate an envionemnt with dok a <name> and attach to it from anywhere in on your host with dok t. dok makes the experience of using docker images as dev much simpler.
docker >= 27.0.0 and python >= 3.8
git clone https://github.com/timchenggu123/dok.git && cd dok && pip install .create a dok named mydok from ubuntu
dok c mydok ubuntuOnce it is ready, activate and attach to mydok with.
dok at mydokTo exit the environment, simply type exit.
To attach to the dev environemnt again, just type
dok tAlternatively, if you just want to execute something without having to attach to the container, run
dok e <your command>For example,
dok e echo "Hello World!"