Module Dockerfile_distro

Run Opam commands across a matrix of Docker containers. Each of these containers represents a different version of OCaml, Opam and an OS distribution (such as Debian or Alpine).

Known distributions and OCaml variants

type t = [
| `Alpine of [ `V3_3 | `V3_4 | `V3_5 | `V3_6 | `V3_7 | `Latest ]
| `CentOS of [ `V6 | `V7 | `Latest ]
| `Debian of [ `V9 | `V8 | `V7 | `Stable | `Testing | `Unstable ]
| `Fedora of [ `V21 | `V22 | `V23 | `V24 | `V25 | `V26 | `V27 | `V28 | `Latest ]
| `OracleLinux of [ `V7 | `Latest ]
| `OpenSUSE of [ `V42_1 | `V42_2 | `V42_3 | `Latest ]
| `Ubuntu of [ `V12_04 | `V14_04 | `V15_04 | `V15_10 | `V16_04 | `V16_10 | `V17_04 | `V17_10 | `V18_04 | `LTS | `Latest ]
]

Supported Docker container distributions

include sig ... end
val t_of_sexp : Sexplib.Sexp.t ‑> t
val __t_of_sexp__ : Sexplib.Sexp.t ‑> t
val sexp_of_t : t ‑> Sexplib.Sexp.t
val compare : t ‑> t ‑> int

compare a b is a lexical comparison function for t.

val resolve_alias : t ‑> t

resolve_alias t will resolve t into a concrete version. This removes versions such as Latest.

val distros : t list

Enumeration of the supported Docker container distributions

val latest_distros : t list

Enumeration of the latest stable (ideally LTS) supported distributions.

val master_distro : t

The distribution that is the top-level alias for the latest tag in the ocaml/opam2 Docker Hub build.

val builtin_ocaml_of_distro : t ‑> string option

builtin_ocaml_of_distro t will return the OCaml version supplied with the distribution packaging, and None if there is no supported version.

val tag_of_distro : t ‑> string

Convert a distribution to a Docker Hub tag. The full form of this is ocaml/TAG on the Docker Hub.

val distro_of_tag : string ‑> t option

distro_of_tag s parses s into a t distribution, and None otherwise.

val latest_tag_of_distro : t ‑> string

latest_tag_of_dsistro distro will generate a Docker Hub tag that is a convenient short form for the latest stable release of a particular distribution. This tag will be regularly rewritten to point to any new releases of the distribution.

val human_readable_string_of_distro : t ‑> string

human_readable_string_of_distro t returns a human readable version of the distribution tag, including version information.

val human_readable_short_string_of_distro : t ‑> string

human_readable_short_string_of_distro t returns a human readable short version of the distribution tag, excluding version information.

CPU architectures

type arch = [
| `X86_64
| `Aarch64
| `Ppc64le
]

CPU Architectures

include sig ... end
val arch_of_sexp : Sexplib.Sexp.t ‑> arch
val __arch_of_sexp__ : Sexplib.Sexp.t ‑> arch
val sexp_of_arch : arch ‑> Sexplib.Sexp.t
val distro_arches : Ocaml_version.t ‑> t ‑> arch list

distro_arches ov t returns the list of architectures that distribution t is supported on for OCaml compiler version ov

val distro_supported_on : arch ‑> Ocaml_version.t ‑> t ‑> bool

distro_supported_on arch ov distro returns true if the combination of CPU arch, compiler version ov is available on the distribution distro.

Opam build infrastructure support

val active_distros : arch ‑> t list

active_distros arch returns the list of currently supported distributions in the opam build infrastructure. Distributions that are end-of-life upstream will rotate out of this list regularly.

val active_tier1_distros : arch ‑> t list

Tier 1 distributions are those supported for the full matrix of compiler versions in the opam build infrastructure.

val active_tier2_distros : arch ‑> t list

Tier 2 distributions are those supported for a limited set of compiler versions in the opam build infrastructure.