Tuesday, September 5, 2017

Set docker image username at container creation time?

Leave a Comment

I have an OpenSuse 42.3 docker image that I've configured to run a code. The image has a single user(other than root) called "myuser" that I create during the initial Image generation via the Dockerfile. I have three script files that generate a container from the image based on what operating system a user is on.

Question: Can the username "myuser" in the container be set to the username of the user that executes the container generation script?

My goal is to let a user pop into the container interactively and be able to run the code from within the container. The code is just a single binary that executes and has some IO, so I want the user's directory to be accessible from within the container so that they can navigate to a folder on their machine and run the code to generate output in their filesystem.

Below is what I have constructed so far. I tried setting the USER environment variable during the linux script's call to docker run, but that didn't change the user from "myuser" to say "bob" (the username on the host machine that started the container). The mounting of the directories seems to work fine. I'm not sure if it is even possible to achieve my goal.

Linux Container script:

username="$USER" userID="$(id -u)" groupID="$(id -g)" home="${1:-$HOME}"  imageName="myImage:ImageTag" containerName="version1Image"  docker run  -it -d --name ${containerName}  -u $userID:$groupID     \             -e USER=${username} --workdir="/home/myuser"            \             --volume="${home}:/home/myuser" ${imageName} /bin/bash  \ 

Mac Container script:

username="$USER" userID="$(id -u)" groupID="$(id -g)" home="${1:-$HOME}"  imageName="myImage:ImageTag" containerName="version1Image"  docker run  -it -d --name ${containerName}                          \             --workdir="/home/myuser"            \             --v="${home}:/home/myuser" ${imageName} /bin/bash  \ 

Windows Container script:

ECHO OFF SET imageName="myImage:ImageTag" SET containerName="version1Image"  docker run -it -d --name %containerName% --workdir="/home/myuser" -v="%USERPROFILE%:/home/myuser" %imageName% /bin/bash   echo "Container %containerName% was created." echo "Run the ./startWindowsLociStream script to launch container" 

2 Answers

Answers 1

First of all (https://docs.docker.com/engine/reference/builder/#arg):

Warning: It is not recommended to use build-time variables for passing secrets like github keys, user credentials etc. Build-time variable values are visible to any user of the image with the docker history command.

But if you still need to do this, read https://docs.docker.com/engine/reference/builder/#arg:

A Dockerfile may include one or more ARG instructions. For example, the following is a valid Dockerfile:

FROM busybox ARG user1 ARG buildno ... 

and https://docs.docker.com/engine/reference/builder/#user:

The USER instruction sets the user name (or UID) and optionally the user group (or GID) to use when running the image and for any RUN, CMD and ENTRYPOINT instructions that follow it in the Dockerfile.

USER <user>[:<group>] or USER <UID>[:<GID>] 

Answers 2

Usernames are not important. What is important are the uid and gid values.

User myuser inside your container will have a uid of 1000 (first non-root user id). Thus when you start your container and look at the container process from the host machine, you will see that the container is owned by whatever user having a uid of 1000 on the host machine.

You can override this by specifying the user once you run your container using:

docker run --user 1001 ... 

Therefore if you want the user inside the container, to be able to access files on the host machine owned by a user having a uid of 1005 say, just run the container using --user 1005.

To better understand how users map between the container and host take a look at this wonderful article. https://medium.com/@mccode/understanding-how-uid-and-gid-work-in-docker-containers-c37a01d01cf

If You Enjoyed This, Take 5 Seconds To Share It

0 comments:

Post a Comment