New User Question (using the Docker containers)

14 views
Skip to first unread message

Peter Smith

unread,
Apr 17, 2020, 6:21:15 AM4/17/20
to OSv Development
Please excuse if this a stupid question. I have started to investigate OSv and set about building the Docker containers. The instructions are a little confusing, for example they suggest using the builder containers to build stuff but the osv sources pulled from Github are deleted, whereas in the runner containers the sources remain. Another thing I noted was the by default the containers refer to Ubuntu 19.04 (the ubuntu ones) which I think should be replaced with 19.10 as aup-get update fails when using 19.04. If someone can explain how these are supposed to work I can perhaps update the docs etc.

Thanks
Peter

Fotis Xenakis

unread,
Apr 17, 2020, 12:36:15 PM4/17/20
to OSv Development
Hello! I have sent out a patch here for updating the default distribution images to the latest supported by the setup script and also tried to minimally update the documentation in that. Even without it though, you can override the default using the --build-args flag to docker build.

I will try to provide some info on the various dockerfiles, but I think Waldek is the most suited to give insight into them:
  • If you wish to develop OSv itself, then you want to go for the "builder" images (which contain all the dependencies for building the kernel). Use "Dockerfile.builder" (as per the README) to get a full dev environment, with all dependencies plus the code to get going immediately. Use the "-base" images to get an environment with just the dependencies installed (useful e.g. for having the code on the host and mounting it as a volume).
  • If you wish to just test OSv out, with one of the included apps or your own, then you want to go for the "runner" images. These include the OSv sources and the run dependencies (mainly QEMU), but not the build dependencies and are thus significantly smaller. In this case, you should look into Capstan and this relevant wiki page.
Hope this helps a little,
Fotis

Waldek Kozaczuk

unread,
Apr 17, 2020, 1:13:14 PM4/17/20
to OSv Development
Fotis.

Thanks for the patch. I will review and commit. You are right we need to see if it does not break the CI.

Peter,

Also if you do not want to build your own docker image, you can pull them from docker hub - https://hub.docker.com/repository/docker/osvunikernel/osv-fedora-31-builder-base and https://hub.docker.com/repository/docker/osvunikernel/osv-ubuntu-19.10-builder-base. This is what I described in here - https://groups.google.com/d/msg/osv-dev/4xnzHlnK3j4/aFHFA-8cAQAJ. This is pretty new so it is not well advertised anywhere yet nor documented clearly enough. As I am working on new release as we speak I will try to update the documentation as much as I can. 

If you want to revise any of the docs we have please sent us a patch or feel free to add new wiki page (anybody with github account can add a wiki I think).

Welcome and regards,
Waldek

Peter Smith

unread,
Apr 17, 2020, 1:19:20 PM4/17/20
to Fotis Xenakis, OSv Development
That’s great thanks, it’s all a bit clearer now. I’ll forge on. Peter 

--
You received this message because you are subscribed to the Google Groups "OSv Development" group.
To unsubscribe from this group and stop receiving emails from it, send an email to osv-dev+u...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/osv-dev/915dc54d-a06d-4547-b3c7-b523626fbdfe%40googlegroups.com.
--
Best Regards
Peter

Peter Smith

unread,
Apr 17, 2020, 2:58:31 PM4/17/20
to Waldek Kozaczuk, OSv Development
...and that explains everything, thanks very much

--
You received this message because you are subscribed to the Google Groups "OSv Development" group.
To unsubscribe from this group and stop receiving emails from it, send an email to osv-dev+u...@googlegroups.com.
--
Best Regards
Peter

Peter Smith

unread,
Apr 18, 2020, 5:07:47 AM4/18/20
to OSv Development
Both, thanks for the hints and tips, a bit of study together with the info has got me up and running.
To unsubscribe from this group and stop receiving emails from it, send an email to osv-dev+unsubscribe@googlegroups.com.
--
Best Regards
Peter
Reply all
Reply to author
Forward
0 new messages