diff --git a/docs/config-file/v2.rst b/docs/config-file/v2.rst index c559fafc90f..2de0411ae94 100644 --- a/docs/config-file/v2.rst +++ b/docs/config-file/v2.rst @@ -69,7 +69,7 @@ This is to avoid typos and provide feedback on invalid configurations. .. contents:: :local: - :depth: 1 + :depth: 3 version ~~~~~~~ @@ -303,6 +303,9 @@ Configuration for the documentation build process. build: image: latest + apt_packages: + - libclang + - cmake python: version: 3.7 @@ -323,6 +326,32 @@ as defined here: * `stable `_: :buildpyversions:`stable` * `latest `_: :buildpyversions:`latest` +build.apt_packages +`````````````````` + +List of `APT packages`_ to install. +Our build servers run Ubuntu 18.04, with the default set of package repositories installed. +We don't currently support PPA's or other custom repositories. + +.. _APT packages: https://packages.ubuntu.com/ + +:Type: ``list`` +:Default: ``[]`` + +.. code-block:: yaml + + version: 2 + + build: + apt_packages: + - libclang + - cmake + +.. note:: + + When possible avoid installing Python packages using apt (``python3-numpy`` for example), + :ref:`use pip or Conda instead `. + sphinx ~~~~~~ diff --git a/docs/guides/reproducible-builds.rst b/docs/guides/reproducible-builds.rst index 485ec1ec2a1..0e0ed854b2f 100644 --- a/docs/guides/reproducible-builds.rst +++ b/docs/guides/reproducible-builds.rst @@ -173,6 +173,6 @@ or our Conda docs about :ref:`environment files