Lines Matching +full:built +full:- +full:docs
12 We currently provide Dockerfiles with ``debian12`` and ``nvidia-cuda`` base images.
17 ----
24 -------------
37 Docker images are built from a so-called *Dockerfile*, a source file written in
40 documentation <https://docs.docker.com/engine/reference/builder/>`_ for more
44 read-only and then add a writable overlay on top of it to keep track of all
77 .. code-block:: bash
80 --source debian12 \
81 --docker-repository clang-debian12 --docker-tag "staging" \
82 -p clang -i install-clang -i install-clang-resource-headers \
83 -- \
84 -DCMAKE_BUILD_TYPE=Release
86 Note that a build like that doesn't use a 2-stage build process that
87 you probably want for clang. Running a 2-stage build is a little more intricate,
90 .. code-block:: bash
92 # Run a 2-stage build.
96 --source debian12 \
97 --docker-repository clang-debian12 --docker-tag "staging" \
98 -p clang -i stage2-install-clang -i stage2-install-clang-resource-headers \
99 -- \
100 -DLLVM_TARGETS_TO_BUILD=Native -DCMAKE_BUILD_TYPE=Release \
101 -DBOOTSTRAP_CMAKE_BUILD_TYPE=Release \
102 -DCLANG_ENABLE_BOOTSTRAP=ON -DCLANG_BOOTSTRAP_TARGETS="install-clang;install-clang-resource-headers"
104 This will produce a new image ``clang-debian12:staging`` from the latest
106 After the image is built you can run bash inside a container based on your image
109 .. code-block:: bash
111 docker run -ti clang-debian12:staging bash
115 .. code-block:: bash
117 root@80f351b51825:/# clang -v
119 Target: x86_64-unknown-linux-gnu
120 Target: x86_64-unknown-linux-gnu
127 We currently provide two images: Debian12-based and nvidia-cuda-based. They
129 preinstalled binaries. Debian8 is very minimal, nvidia-cuda is larger, but has
134 you should try Debian12-based image.
137 you should choose nvidia-cuda-based image and use `nvidia-docker
138 <https://github.com/NVIDIA/nvidia-docker>`_ to run your docker containers. Note
139 that you don't need nvidia-docker to build the images, but you need it in order
140 to have an access to GPU from a docker container that is running the built
143 If you have a different use-case, you could create your own image based on
146 Any docker image can be built and run using only the docker binary, i.e. you can
155 Debian12-based image using the latest ``google/stable`` sources for you:
157 .. code-block:: bash
160 -s debian12 --d clang-debian12 -t "staging" \
161 --branch branches/google/stable \
162 -p clang -i install-clang -i install-clang-resource-headers \
163 -- \
164 -DCMAKE_BUILD_TYPE=Release
171 To minimize the resulting image size we use `multi-stage Docker builds
172 <https://docs.docker.com/develop/develop-images/multistage-build/>`_.
177 The second image is our resulting image. It contains only the built binaries
179 (specified by -d and -t flags).