From 02a69857994afe608cdb08ee2c51e61afa2952c7 Mon Sep 17 00:00:00 2001 From: Franklin Wei Date: Sun, 21 Jul 2019 18:17:37 -0400 Subject: Add build code for Docker development environment This simplifies the tedious task of building all the Rockbox toolchains manually by providing a build code for a Docker container image. It's useful for quickly spinning up a build client with just a couple commands and no waiting to compile (though downloading takes a little while). I've built an image as built1n/rbclient on Docker Hub. All toolchains (even the weird ones) are included, except android16. Change-Id: I6b863628ffb397604f59ec6def2f8bb8c8c7185f --- tools/docker_rbclient/README | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 tools/docker_rbclient/README (limited to 'tools/docker_rbclient/README') diff --git a/tools/docker_rbclient/README b/tools/docker_rbclient/README new file mode 100644 index 0000000000..a514e75c28 --- /dev/null +++ b/tools/docker_rbclient/README @@ -0,0 +1,35 @@ +This directory builds a Docker container image for a rockbox build +client with all toolchains except android. + +There is a pre-built client available as built1n/rbclient on Docker +Hub if you would like to avoid having to build all the toolchains. See +the Docker documentation on how to pull and run it. + +To build from scratch: + +1. Make sure you have Docker installed and running. + +2. Run: + + docker build . -t myclient + + This will build the image and tag it as `myclient.' + +3. To run your client: + + docker run -e USER=your username -e PASS=anything -e NAME=clientname \ + myclient + + You can also run a bash shell interactively by issuing: + + docker run -it myclient bash + + This will drop you into a fully-equiped rockbox development + environment. + +It is also possible to pull straight from Docker Hub. Run: + + docker pull built1n/rbclient + +Then you can use all the commands above, with `myclient' replaced with +`built1n/rbclient'. \ No newline at end of file -- cgit v1.2.3