This repo is to create an image that is able to run bitbake/poky. The main difference between it and https://github.com/crops/yocto-dockerfiles is that it has helpers to create users and groups within the container. This is so that the output generated in the container will be readable by the user on the host.
The instructions will be slightly different depending on whether Linux, Windows or Mac is used. There are setup instructions for using Windows/Mac at https://github.com/crops/docker-win-mac-docs/wiki. When referring to Windows/Mac in the rest of the document, it is assumed the instructions at https://github.com/crops/docker-win-mac-docs/wiki were followed.
Here a very simple but usable scenario for using the container is described. It is by no means the only way to run the container, but is a great starting point.
Create a workdir or volume
The workdir you create will be used for the output created while using the container. For example a user could create a directory using the command
mkdir -p /home/myuser/mystuff
It is important that you are the owner of the directory. The owner of the directory is what determines the user id used inside the container. If you are not the owner of the directory, you may not have access to the files the container creates.
For the rest of the Linux instructions we'll assume the workdir chosen was
/home/myuser/mystuff
.
On Windows or Mac a workdir isn't needed. Instead the volume called myvolume will be used. This volume should have been created when following the instructions at https://github.com/crops/docker-win-mac-docs/wiki.
The docker command
Assuming you used the workdir from above, the command to run a container for the first time would be:
docker run --rm -it -v /home/myuser/mystuff:/workdir crops/poky --workdir=/workdir
or, if you have SELinux in enforcing mode:
docker run --rm -it -v /home/myuser/mystuff:/workdir:Z crops/poky --workdir=/workdir
docker run --rm -it -v myvolume:/workdir crops/poky --workdir=/workdir
Let's discuss the options:
This should put you at a prompt similar to:
pokyuser@3bbac563cacd:/workdir$
At this point you should be able to follow the same instructions as described in https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html