fork/rust

git clone https://git.julia.blue/fork/rust

borsAuto merge of #103046 - JanBeh:PR_clarify_cmp_terminology, r=workingjubilee3bcad65fbf6

master
4 folders2 files

files

host-aarch64/aarch64-gnu/
host-x86_64/
scripts/
static/
README.md16.5 KiB
run.sh9.3 KiB

Docker images for CI

This folder contains a bunch of docker images used by the continuous integration (CI) of Rust. An script is accompanied (run.sh) with these images to actually execute them. To test out an image execute:

./src/ci/docker/run.sh $image_name

for example:

./src/ci/docker/run.sh x86_64-gnu

Images will output artifacts in an obj dir at the root of a repository. Note that the script will overwrite the contents of this directory.

To match conditions in rusts CI, also set the environment variable DEPLOY=1, e.g.:

DEPLOY=1 ./src/ci/docker/run.sh x86_64-gnu

NOTE: Re-using the same obj dir with different docker images with the same target triple (e.g. dist-x86_64-linux and dist-various-1) may result in strange linker errors, due shared library versions differing between platforms.

If you encounter any issues when using multiple Docker images, try deleting your obj directory before running your command.

Filesystem layout

Docker Toolbox on Windows

For Windows before Windows 10, the docker images can be run on Windows via Docker Toolbox. There are several preparation needs to be made before running a Docker image.

  1. Stop the virtual machine from the terminal with docker-machine stop

  2. If your Rust source is placed outside of C:\Users\**, e.g. if you place the repository in the E:\rust folder, please add a shared folder from VirtualBox by:

    1. Select the "default" virtual machine inside VirtualBox, then click "Settings"

    2. Go to "Shared Folders", click "Add shared folder" (the folder icon with a plus sign), fill in the following information, then click "OK":

      • Folder path: E:\rust
      • Folder name: e/rust
      • Read-only: ☐ unchecked
      • Auto-mount: ☑ checked
      • Make Permanent: ☑ checked
  3. VirtualBox might not support creating symbolic links inside a shared folder by default. You can enable it manually by running these from cmd.exe:

    cd "C:\Program Files\Oracle\VirtualBox"
    VBoxManage setextradata default VBoxInternal2/SharedFoldersEnableSymlinksCreate/e/rust 1
    ::                                                                              ^~~~~~
    ::                                                                              folder name
  4. Restart the virtual machine from terminal with docker-machine start.

To run the image,

  1. Launch the "Docker Quickstart Terminal".
  2. Execute ./src/ci/docker/run.sh $image_name as explained at the beginning.

Cross toolchains

A number of these images take quite a long time to compile as they're building whole gcc toolchains to do cross builds with. Much of this is relatively self-explanatory but some images use crosstool-ng which isn't quite as self explanatory. Below is a description of where these *.defconfig files come form, how to generate them, and how the existing ones were generated.

Generating a .defconfig file

NOTE: Existing Dockerfiles can also be a good guide for the process and order of script execution.

If you have a linux-cross image lying around you can use that and skip the next two steps.

# Note: We use ubuntu:22.04 because that's the "base" of linux-cross Docker
# image, or simply run ./src/ci/docker/run.sh once, which will download the correct
# one and you can check it out with `docker images`
$ docker run -it ubuntu:22.04 bash
# in another terminal:
$ docker ps
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
cfbec05ed730        ubuntu:22.04        "bash"              16 seconds ago      Up 15 seconds                           drunk_murdock
$ docker cp src/ci/docker/scripts drunk_murdock:/tmp/
$ cd /tmp/scripts
# Download packages necessary for building
$ bash ./cross-apt-packages.sh
# Download and build crosstool-ng
$ bash ./crosstool-ng.sh
$ docker cp arm-linux-gnueabi.defconfig drunk_murdock:/tmp/.config
$ cd /tmp/
$ ct-ng olddefconfig
$ ct-ng menuconfig
$ ct-ng savedefconfig
$ docker cp drunk_murdock:/tmp/defconfig arm-linux-gnueabi.defconfig

Toolchain configuration

Changes on top of the default toolchain configuration used to generate the .defconfig files in this directory. The changes are formatted as follows:

$category > $option = $value -- $comment

arm-linux-gnueabi.defconfig

For targets: arm-unknown-linux-gnueabi

arm-linux-gnueabihf.defconfig

For targets: arm-unknown-linux-gnueabihf

armv7-linux-gnueabihf.defconfig

For targets: armv7-unknown-linux-gnueabihf

(*) These options have been selected to match the configuration of the arm toolchains shipped with Ubuntu 15.10 (+) These options have been selected to match the gcc flags we use to compile C libraries like jemalloc. See the mk/cfg/arm(v7)-unknown-linux-gnueabi{,hf}.mk file in Rust's source code.

aarch64-linux-gnu.defconfig

For targets: aarch64-unknown-linux-gnu

i586-linux-gnu.defconfig

For targets: i586-unknown-linux-gnu

(*) Compressed debug is enabled by default for gas (assembly) on Linux/x86 targets, but that makes our compiler_builtins incompatible with binutils < 2.32.

loongarch64-linux-gnu.defconfig

For targets: loongarch64-unknown-linux-gnu

mips-linux-gnu.defconfig

For targets: mips-unknown-linux-gnu

mipsel-linux-gnu.defconfig

For targets: mipsel-unknown-linux-gnu

mips64-linux-gnu.defconfig

For targets: mips64-unknown-linux-gnuabi64

mips64el-linux-gnu.defconfig

For targets: mips64el-unknown-linux-gnuabi64

powerpc-linux-gnu.defconfig

For targets: powerpc-unknown-linux-gnu

powerpc64-linux-gnu.defconfig

For targets: powerpc64-unknown-linux-gnu

(+) These CPU options match the configuration of the toolchains in RHEL6.

riscv64-unknown-linux-gnu.defconfig

For targets: riscv64-unknown-linux-gnu

s390x-linux-gnu.defconfig

For targets: s390x-unknown-linux-gnu