CD2H gitForager

ocaml/opam-dockerfiles

Name: opam-dockerfiles

Owner: OCaml

Description: Docker base builds of OPAM in various combinations

Created: 2015-12-21 12:35:52.0

Updated: 2018-05-20 03:19:04.0

Pushed: 2017-11-18 11:18:50.0

Homepage: null

Size: 135

Language: null

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

This repository contains a set of Docker container definitions for various combination of OCaml and the OPAM package manager. The containers all come preinstalled with a working compiler and an OPAM environment. Using it as simple as:

er pull ocaml/opam
er run -ti ocaml/opam bash

…to get a working development environment. You can grab a specific distribution and test out external dependencies as well:

er run ocaml/opam:ubuntu-16.04_ocaml-4.04.0 opam depext -i cohttp lwt ssl

Distributions

The default latest tag points to the following distribution:

The latest stable distributions are summarised below. The default OCaml version available in the container is marked with a 🅳 symbol, and a system installation of OCaml (as opposed to a locally compiled switch) is marked with a 🆂 symbol.

Distribution | Available Switches | Command ———— | —————— | ——- Alpine | 4.04.1 🆂, 4.05.0 🅳 | docker pull ocaml/opam:alpine CentOS | 4.01.0 🆂, 4.05.0 🅳 | docker pull ocaml/opam:centos Debian | 4.02.3 🆂, 4.05.0 🅳 | docker pull ocaml/opam:debian Fedora | 4.02.3 🆂, 4.05.0 🅳 | docker pull ocaml/opam:fedora OpenSUSE | 4.03.0 🆂, 4.05.0 🅳 | docker pull ocaml/opam:opensuse OracleLinux | 4.05.0 🅳 | docker pull ocaml/opam:oraclelinux Ubuntu | 4.02.3 🆂, 4.05.0 🅳 | docker pull ocaml/opam:ubuntu

There are also individual containers available for each combination of an OS distribution and an OCaml revision. These should be useful for testing and continuous integration, since they will remain pinned to these versions for as long as the upstream distribution is supported. Note that older releases may have security issues if upstream stops maintaining them.

Using the Containers

Each container comes with an initialised OPAM repository pointing to the central repository. The default user in the container is called opam, and sudo is configured to allow password-less access to root.

To build an environment for the Jane Street Core library on the latest stable OCaml, a simple Dockerfile looks like this:

 ocaml/opam
 depext -i core

You can build and use this image locally for development by saving the Dockerfile and:

er build -t ocaml-core .
er run -ti ocaml-core bash

You can also use the Docker volume sharing to map in source code from your host into the container to persist the results of your build. You can also construct more specific Dockerfiles that use the full range of OPAM commands for a custom development environment. For example, to build the MirageOS bleeding edge OCaml environment, this Dockerfile will add in a custom remote:

 ocaml/opam:ubuntu-15.10_ocaml-4.02.3
 remote add dev git://github.com/mirage/mirage-dev
 depext -i mirage

Contributing

To discuss these containers, please e-mail Anil Madhavapeddy anil@recoil.org or the OPAM development list at opam-devel@lists.ocaml.org. Contributions of Dockerfiles for additional OS distributions are most welcome! The files here are all autogenerated from the ocaml-docker-scripts repository, so please do not submit any PRs directly to this location. The containers are built and hosted on the Docker Hub ocaml organisation.

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.