1#===----------------------------------------------------------------------===##
2#
3# Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4# See https://llvm.org/LICENSE.txt for license information.
5# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6#
7#===----------------------------------------------------------------------===##
8
9#
10# This Dockerfile describes the base image used to run the various libc++
11# build bots. By default, the image runs the Buildkite Agent, however one
12# can also just start the image with a shell to debug CI failures.
13#
14# To start a Buildkite Agent, run it as:
15#   $ docker run --env-file secrets.env -it $(docker build -q .)
16#
17# The environment variables in `secrets.env` must be replaced by the actual
18# tokens for this to work. These should obviously never be checked in.
19#
20# To start a shell in the Docker image, use:
21#   $ docker run -it --volume "$(git rev-parse --show-toplevel):/llvm" --workdir "/llvm" $(docker build -q .) bash
22#
23# This will fire up the Docker container and mount the root of the monorepo
24# as /llvm in the container. Be careful, the state in /llvm is shared between
25# the container and the host machine.
26#
27# Finally, a pre-built version of this image is available on DockerHub as
28# ldionne/libcxx-builder. To use the pre-built version of the image, use
29#
30#   $ docker pull ldionne/libcxx-builder
31#   $ docker run -it <options> ldionne/libcxx-builder
32#
33# To update the image, rebuild it and push it to ldionne/libcxx-builder (which
34# will obviously only work if you have permission to do so).
35#
36#   $ docker build -t ldionne/libcxx-builder .
37#   $ docker push ldionne/libcxx-builder
38#
39
40FROM ubuntu:bionic
41
42# Make sure apt-get doesn't try to prompt for stuff like our time zone, etc.
43ENV DEBIAN_FRONTEND=noninteractive
44
45RUN apt-get update && apt-get install -y bash curl
46
47# Install various tools used by the build or the test suite
48RUN apt-get update && apt-get install -y ninja-build python3 python3-sphinx git
49
50# Install the most recently released LLVM
51RUN apt-get update && apt-get install -y lsb-release wget software-properties-common
52RUN bash -c "$(wget -O - https://apt.llvm.org/llvm.sh)"
53RUN ln -s $(find /usr/bin -regex '.+/clang\+\+-[a-zA-Z0-9.]+') /usr/bin/clang++
54RUN ln -s $(find /usr/bin -regex '.+/clang-[a-zA-Z0-9.]+') /usr/bin/clang
55
56# Install a recent GCC
57RUN add-apt-repository ppa:ubuntu-toolchain-r/test
58RUN apt-get update && apt install -y gcc-10 g++-10
59RUN ln -f -s /usr/bin/g++-10 /usr/bin/g++
60RUN ln -f -s /usr/bin/gcc-10 /usr/bin/gcc
61
62# Install a recent CMake
63RUN wget https://github.com/Kitware/CMake/releases/download/v3.18.2/cmake-3.18.2-Linux-x86_64.sh -O /tmp/install-cmake.sh
64RUN bash /tmp/install-cmake.sh --prefix=/usr --exclude-subdir --skip-license
65RUN rm /tmp/install-cmake.sh
66
67# Change the user to a non-root user, since some of the libc++ tests
68# (e.g. filesystem) require running as non-root. Also setup passwordless sudo.
69RUN apt-get update && apt-get install -y sudo
70RUN echo "ALL ALL = (ALL) NOPASSWD: ALL" >> /etc/sudoers
71RUN useradd --create-home libcxx-builder
72USER libcxx-builder
73WORKDIR /home/libcxx-builder
74
75# Install the Buildkite agent and dependencies. This must be done as non-root
76# for the Buildkite agent to be installed in a path where we can find it.
77RUN bash -c "$(curl -sL https://raw.githubusercontent.com/buildkite/agent/master/install.sh)"
78ENV PATH="${PATH}:/home/libcxx-builder/.buildkite-agent/bin"
79
80# By default, start the Buildkite agent (this requires a token).
81CMD buildkite-agent start --tags "queue=libcxx-builders"
82