The opam-ci tool provides an interface to the opam 2.0 continuous integration cluster, which regularly rebuilds the package repository across a variety of OCaml compiler versions, operating system distributions and CPU architectures. These builds are done regularly in remote infrastructure and the results are pushed to a metadata repository where they are fetched by this command to give you a summary of the status of your own packages.
opam ci status command shows a dashboard of the build results
across this matrix. Packages can be filtered by maintainer substrings
or tag names in the opam package description, so you see only those
relevant to you.
opam ci logs command will show you the build errors so you can fix
them. It also generates a Dockerfile of the precise build to reproduce
the environment locally for you.
To get started, try these commands with the maintainer argument replaced with your own information or tags:
# show all the failing MirageOS packages
opam ci status -m org:mirage | less -R
# show all the packages maintained by firstname.lastname@example.org
opam ci status -m email@example.com --filter=all | less -R
# show all the packages failing on the latest RC of the OCaml compiler
opam ci status --filter=variants:rc | less -R
# display all failure logs for the mirage-xen package
opam ci logs mirage-xen
--help pages for the subcommands below for more detailed
Published: 13 Jun 2018
OCaml Build Infrastructure
This repository contains the scripts, libraries and command-line tools to access the opam2 bulk build infrastructure that checks on the health of the opam package manager.
The main services and repositories associates with this infrastructure are:
https://github.com/ocaml/infrastructure/wiki/Containers is rebuilt automatically with the latest information
GitHub: Git repositories
Docker Hub: container images
The main tool you will want to try out is
opam-ci, which provides CLI access to build results. You can get this by:
opam pin add -n obi https://github.com/ocaml/obi.git
opam pin add opam-ci https://github.com/ocaml/obi.git
and then try it out via:
opam-ci status --help
opam-ci logs --help
CHANGES.md is the repository changelog for source code and Buildkite scripts.
While we are assembling the documentation, please contact @avsm for more information.