Bootstrappable Builds #8929

tobtoht · 2023-07-02T19:18:13Z

This PR proposes to replace Gitian with Guix to achieve bootstrappable builds for release binaries.

What?

If you have 15 minutes, please consider watching this presentation by Carl Dong linked above as it covers the migration (Gitian → Guix) this PR proposes to make. It explains why reproducibility alone is not enough.

Other resources:

Why?

Greater build system security: Bootstrappability allows us to audit and reproduce our toolchain instead of blindly trusting binary downloads. Our build environment can be built from source, all the way down. It allows us to reduce our supply chain attack surface by only including the packages that we need, and nothing else.
Easier to set up: Guix runs on any Linux distribution and on most architectures (x86_64, aarch64, riscv64). To produce reproducible release binaries, you only need to install Guix and run the build script. This hopefully leads to more participants in the pre-release verified reproduction process.
More flexibility: Unlike Gitian, we are not limited to the package set of a particular Ubuntu version. Guix allows us to pick and choose our toolchains. This allows us to use the latest compilers while targeting older versions of glibc and would, for example, make it easier to add a modern Rust compiler to our build environment. Packages that are not available in Guix can easily be defined in the manifest or upstreamed.
Better developer UX: Guix allows us to modify any detail about our build environment with ease. Debugging build issues takes less time because we have shell access to the build environment. The monero source code is bind mounted into the container, so edits to package definitions can be tested incrementally.
Future proof: Guix is actively developed, Gitian is in maintenance mode (serious bug fixes only).

How to test?

Requirements:

any Linux distribution
50 GB of free disk space
4 or more cores recommended
2 GB RAM per thread

# Install guix
$ apt install guix  # ubuntu 22.04, debian 11, or later 
or 
# use the install script: https://guix.gnu.org/manual/en/html_node/Binary-Installation.html

# Clone the repo
$ git clone https://github.com/tobtoht/monero
$ cd monero
$ git checkout guix

# Run the builds
$ ./contrib/guix/guix-build  # this will take several hours, uses all available cores
or
$ JOBS=N ./contrib/guix/guix-build # replace N with the desired maximum number of threads

# Obtain a list of hashes
$ uname --machine && find guix/guix-build-$(git rev-parse --short=12 HEAD)/output/ -type f -print0 | env LC_ALL=C sort -z | xargs -r0 sha256sum

For more information, see README.md

Notes

Environment	Guix version (NEW)	Gitian version (OLD)
Guix	`53396a22af` (28 Aug 2024)	n/a
Glibc	2.27	2.27
Binutils	2.38	2.30
GCC	12.4.0	7.5.0
Clang	11.1.0 (darwin, freebsd)	9.0.0
Linux headers	6.1.106 (LTS)*	5.4.0

* this does not affect run-time kernel requirements, see glibc docs.

The guix.yml workflow does not use caching because it uses too much space and causes evictions for other caches (10 GB limit). We only need to run it when there is a change to contrib/{depends,guix}, which happens infrequently and doesn't need to complete quickly.

This PR removes native_clang because Guix provides us with a bootstrapped package and non-guix builds can use the system clang. This PR introduces backwards incompatible compiler flags, bumping the minimum Clang version to 10 (up from 9) for depends builds. Clang >=10 is available in the package managers of all supported distros (including Ubuntu 18.04).

The minimum glibc version for all Linux targets is now 2.27 (Ubuntu 18.04, Debian 10), for more details see #9171 (comment).

The source archive now includes all submodules.

Q&A

What role does Guix serve in the build process?

Guix is used to set-up a reproducible, bootstrappable, containerized build environment. This replaces the Ubuntu 18.04 based environment we used for Gitian builds.

Monero dependencies are built using the depends build system inside the container provided by Guix. While Guix could eventually replace depends, it would be too drastic for this PR.

Can Guix run on any Linux distribution?

Yes, with few exceptions. Installing Guix on an immutable distro like Fedora SilverBlue might not be possible.

To install Guix, use the official install script: https://guix.gnu.org/manual/en/html_node/Binary-Installation.html

Can Guix run on macOS or Windows?

Not natively. You can run Guix builds on macOS inside a virtual machine (even on Apple Silicon). On Windows, it should be possible to install Guix on WSL2.

Can Guix run on aarch64 / riscv64 machines?

Yes. It even produces the same bit-identical release binaries as Guix run on a x86_64 machine. This isn't possible with Gitian.

Targets that don't currently build on non-x86_64: Android, FreeBSD.

Are Guix builds slower than Gitian?

Guix builds are only slower the first time, because it needs to build toolchains (or the entire package graph if --no-substitutes is used) from source. Subsequent runs just as fast (or faster) than Gitian due to caching.

Why Guix instead of Nix?

Nix packages are not bootstrappable.

What does bootstrappable mean in this context?

It means that the package graph for all packages included in our build environment is rooted in a single 357-byte heavily annotated program. We no longer have to trust binaries (downloaded from Ubuntu servers) for reproducible builds.

For more information: https://guix.gnu.org/en/blog/2023/the-full-source-bootstrap-building-from-source-all-the-way-down/

If a new version of Guix is released, does that mean our build environment is no longer reproducible?

No, builds remain reproducible indefinitely, assuming the source code for all packages is archived and remains available. The exact version of Guix, including all of its packages is pinned using time-machine.

More information:

How do we define which packages are included in the build environment?

In manifest.scm. In this file, we can choose packages that are already available in Guix or define packages ourselves.

When should we define packages in the manifest?

If a package, specific package version, or toolchain isn't available in Guix and it isn't possible to upstream or we can't we can't wait on that.

Is the build environment identical for all targets?

No, extra packages can be added for each target.

If we change the time-machine commit, does that mean our build environment changes?

Yes. The manifest generally does not specify which packages versions are included in the build environment. If a package was updated in Guix between the old and new commit, we will have the updated version in our build environment. Updating the time-machine can therefore cause breakage and should be done with caution.

How do I get shell access to the build environment for development purposes?

In contrib/guix/guix-build replace bash -c "cd /monero && bash contrib/guix/libexec/build.sh" with bash.

Then invoke with: FORCE_DIRTY_WORKTREE=1 ./contrib/guix/guix-build.

Where to start review?

contrib/guix/README.md
↓
contrib/guix/guix-build
↓
contrib/guix/manifest.scm
↓
contrib/guix/libexec/build.sh

Troubleshooting

Might segfault during compilation on first generation Ryzen processors due to a hardware fault.
Ubuntu 24.04: If you run into mount "none" on "/tmp/guix-directory.": Permission denied you need to create an apparmor profile for Guix, see: Bootstrappable Builds #8929 (comment)

Follow-up PRs

0xFFFC0000 · 2023-09-19T07:06:26Z

I cannot wait until we finalize and merge this. Thanks for your great work @tobtoht

tobtoht · 2024-02-25T11:48:53Z

I don't expect to make major changes to this PR, it's ready for testing. Reviews on any of the sub-PRs would help move this forward.

contrib/depends/Makefile

tobtoht · 2024-02-25T12:59:56Z

contrib/depends/patches/android_ndk/fix_env.patch

+             #!/bin/bash
+             if [ "$1" != "-cc1" ]; then
+-                `dirname $0`/clang{version} {flags} "$@"
+                env -u C_INCLUDE_PATH -u CPLUS_INCLUDE_PATH -u OBJC_INCLUDE_PATH -u OBJCPLUS_INCLUDE_PATH -u CPATH -u LIBRARY_PATH `dirname $0`/clang{version} {flags} "$@"


We need to unset these environment variables here because they refer to Guix profile packages. We want clang to only include headers from the NDK. We can't unset them in build.sh because native_ package builds would fail to find the necessary include headers. Unsetting these variables does not affect non-Guix builds.

This patch will be removed in #9456

contrib/depends/patches/boost/fix_coalesce.patch

contrib/guix/patches/glibc-2.27-riscv64-Use-__has_include-to-include-asm-syscalls.h.patch

tobtoht · 2024-02-25T13:05:23Z

contrib/guix/patches/glibc-2.27-guix-prefix.patch

@@ -0,0 +1,22 @@
+Without ffile-prefix-map, the debug symbols will contain paths for the


Building on aarch64 should produce bit-for-bit identical release binaries.

It now does for linux, windows, and macos targets. FreeBSD and Android targets use pre-compiled x86_64 toolchains and libraries.

contrib/guix/manifest.scm

contrib/guix/libexec/build.sh

tobtoht · 2024-02-25T14:00:36Z

.gitignore

-contrib/gitian/docker/
-contrib/gitian/sigs/
+# guix
+/guix


Finished builds are available in ./guix/guix-build-<COMMIT>/

├── guix-build-222ea1a30058 │ ├── build │ │ └── distsrc-222ea1a30058-x86_64-linux-gnu # build directory │ ├── logs │ │ └── x86_64-linux-gnu # various logs for reproducibility debugging │ │ ├── depends-hashes.txt │ │ ├── depends-packages.txt │ │ ├── guix-env.txt │ │ ├── guix-hashes.txt │ │ └── SHA256SUMS.part │ ├── output │ │ └── x86_64-linux-gnu │ │ └── monero-x86_64-linux-gnu-222ea1a30058.tar.bz2 # binary tarball │ └── var │ ├── precious_dirs # directories to keep when running `./contrib/guix/guix-clean` │ └── profiles

tobtoht · 2024-02-25T14:01:21Z

contrib/depends/funcs.mk

@@ -267,4 +275,4 @@ $(foreach package,$(all_packages),$(eval $(call int_config_attach_build_config,$
 $(foreach package,$(all_packages),$(eval $(call int_add_cmds,$(package))))

 #special exception: if a toolchain package exists, all non-native packages depend on it
-$(foreach package,$(packages),$(eval $($(package)_unpacked): |$($($(host_arch)_$(host_os)_native_toolchain)_cached) ))
+$(foreach package,$(packages),$(eval $($(package)_extracted): |$($($(host_arch)_$(host_os)_native_toolchain)_cached) ))


_unpacked target doesn't exist.

contrib/guix/manifest.scm

contrib/guix/libexec/build.sh

tobtoht · 2024-02-25T14:21:26Z

contrib/depends/funcs.mk

+$(1)_cc=$$($$($(1)_type)_CC)
+$(1)_cxx=$$($$($(1)_type)_CXX)
+$(1)_objc=$$($$($(1)_type)_OBJC)
+$(1)_objcxx=$$($$($(1)_type)_OBJCXX)
+$(1)_ar=$$($$($(1)_type)_AR)
+$(1)_ranlib=$$($$($(1)_type)_RANLIB)
+$(1)_libtool=$$($$($(1)_type)_LIBTOOL)
+$(1)_nm=$$($$($(1)_type)_NM)
+$(1)_cflags=$$($$($(1)_type)_CFLAGS) \
+            $$($$($(1)_type)_$$(release_type)_CFLAGS)
+$(1)_cxxflags=$$($$($(1)_type)_CXXFLAGS) \
+              $$($$($(1)_type)_$$(release_type)_CXXFLAGS)
+$(1)_arflags=$$($$($(1)_type)_ARFLAGS) \
+             $$($$($(1)_type)_$(release_type)_ARFLAGS)
+$(1)_ldflags=$$($$($(1)_type)_LDFLAGS) \
+             $$($$($(1)_type)_$$(release_type)_LDFLAGS) \
+             -L$$($($(1)_type)_prefix)/lib
+$(1)_cppflags=$$($$($(1)_type)_CPPFLAGS) \
+              $$($$($(1)_type)_$$(release_type)_CPPFLAGS) \
+              -I$$($$($(1)_type)_prefix)/include


Delay expansion of package variables.

tobtoht · 2024-02-25T14:23:45Z

.github/workflows/guix.yml

@@ -0,0 +1,63 @@
+name: ci/gh-actions/guix
+
+on: [push, pull_request]


I removed guix and depends package caching from the CI workflow because it uses too much space and causes evictions for other caches (10 GB limit). We only need to run it when there is a change to contrib/{depends,guix}, which happens infrequently and doesn't need to complete quickly.

on: [push, pull_request] is temporary for testing.

tobtoht · 2024-02-25T14:24:39Z

.github/workflows/guix.yml

+          path: contrib/depends/sources
+          key: sources-${{ hashFiles('contrib/depends/packages/*') }}
+      - name: install dependencies
+        run: sudo apt update; sudo apt -y install guix git ca-certificates


It may be worth investigating if using the installer script is faster.

https://guix.gnu.org/manual/en/html_node/Installation.html

tobtoht · 2024-02-25T14:27:59Z

contrib/guix/manifest.scm

+                 (("-rpath=") "-rpath-link="))
+               #t))))))))
+
+(define-public glibc-2.27


The minimum glibc version for all Linux targets is now 2.27 (Ubuntu 18.04, Debian 10).

For more context, see: #9171 (comment)

contrib/guix/libexec/build.sh

contrib/depends/packages/darwin_sdk.mk

tobtoht · 2024-02-25T17:21:32Z

contrib/depends/toolchain.cmake.in

-  SET(CMAKE_C_COMPILER @prefix@/native/bin/clang)
+  SET(CMAKE_C_COMPILER @CC@)
  SET(CMAKE_C_COMPILER_TARGET ${CLANG_TARGET})
  SET(CMAKE_C_FLAGS_INIT -B${_CMAKE_TOOLCHAIN_PREFIX})
-  SET(CMAKE_CXX_COMPILER @prefix@/native/bin/clang++ -stdlib=libc++)
+  SET(CMAKE_CXX_COMPILER @CXX@ -stdlib=libc++)


We're now using the system / guix-provided clang for darwin builds.

tobtoht · 2024-02-25T17:26:09Z

contrib/depends/toolchain.cmake.in

+  SET(CMAKE_ASM_COMPILER clang)
+  SET(CMAKE_ASM-ATT_COMPILER as)


CMake automatically reduces CMAKE_CXX_COMPILER to the first command to derive CMAKE_ASM_COMPILER. This happens to be env instead of clang, so we need to set it explicitly.

contrib/guix/libexec/build.sh

tobtoht · 2024-02-26T11:17:06Z

contrib/depends/funcs.mk

-final_build_id_long+=$($(package)_build_id_long)
+final_build_id_long+=:[recipe]:$(1)-$($(1)_version)-$($(1)_recipe_hash)-$(release_type):[deps]$(foreach dep,$($(1)_build_id_deps),$(shell echo ":$(dep)")):[$($(1)_type)_id]:$($($(1)_type)_id_string):


Increase verbosity of final_build_id_long to ease debugging reproducibility issues.

tobtoht · 2024-02-26T11:19:17Z

contrib/depends/Makefile

+build_id_string:=$(realpath $(GUIX_ENVIRONMENT))
+$(host_arch)_$(host_os)_id_string:=$(realpath $(GUIX_ENVIRONMENT))


Any change to manifest.scm invalidates the cache.

iamamyth · 2024-10-26T17:34:31Z

@tobtoht I think I'll have time to review this within the next week (i.e. 7 days). I've already been fiddling with the build system on a local branch (have code ready to automate make job count, but don't want to PR it because there's a huge backlog as-is) and inspecting other build system PRs, so I should have enough context.

.github/workflows/guix.yml

contrib/guix/libexec/prelude.bash

contrib/guix/guix-attest

iamamyth · 2024-10-31T16:06:06Z

Just an FYI, I'm ~70% done reviewing this PR. I'll post a summary comment when I complete my first pass review, but, so, far, everything looks good.

contrib/depends/Makefile

contrib/guix/libexec/build.sh

contrib/guix/guix-build

contrib/guix/guix-clean

contrib/guix/libexec/prelude.bash

contrib/guix/guix-verify

iamamyth · 2024-11-03T17:25:38Z

Full review complete. The only concerning issue I saw was the under_dir logic.

iamamyth · 2024-12-09T00:48:12Z

contrib/guix/guix-attest

+################
+
+cmd_usage() {
+cat <<EOF


Just going to post this here as a line comment, but it applies throughout: Some folks have very strong opinions on using cat rather than echo/printf in these situations; I don't really care, but I will just note that

cat <<EOF ... EOF

can be expressed as:

echo -n "\ ... "

where ... is a placeholder for a multi-line string.

plowsof mentioned this pull request Jul 4, 2023

Monero Community Workgroup Meeting: Saturday 8th July 2023 @ 15:00 UTC monero-project/meta#857

Closed

tobtoht force-pushed the guix branch 2 times, most recently from 09e44ca to ee3964a Compare July 6, 2023 15:02

tobtoht mentioned this pull request Jul 6, 2023

depends: use macOS 11 SDK with libc++ headers #8933

Merged

tobtoht force-pushed the guix branch from 3cbd1da to 4903fe2 Compare February 13, 2024 14:49

tobtoht mentioned this pull request Feb 13, 2024

build: remove glibc backcompat #9171

Open

tobtoht force-pushed the guix branch from 769e2c2 to 058bd64 Compare February 14, 2024 11:08

tobtoht force-pushed the guix branch 5 times, most recently from 7ff7aca to 008cf5e Compare February 24, 2024 19:01

tobtoht mentioned this pull request Feb 24, 2024

depends: add command to print variables #9202

Merged

tobtoht force-pushed the guix branch 3 times, most recently from a8ea3d2 to bf1b97d Compare February 25, 2024 11:47

tobtoht commented Feb 25, 2024

View reviewed changes

tobtoht force-pushed the guix branch 6 times, most recently from 817fcae to 9ea73c0 Compare February 26, 2024 11:14

tobtoht commented Feb 26, 2024

View reviewed changes

tobtoht marked this pull request as ready for review February 26, 2024 13:46

tobtoht mentioned this pull request Feb 27, 2024

guix: static-pie {x86_64,aarch64}-linux-gnu builds #9207

Draft

plowsof mentioned this pull request Feb 29, 2024

Monero Community Workgroup Meeting: Saturday 2nd March 15:00UTC monero-project/meta#974

Closed

DiosDelRayo mentioned this pull request Oct 23, 2024

Bootstrappable Builds DiosDelRayo/DiosDelRayo.github.io#69

Open

tobtoht mentioned this pull request Oct 25, 2024

daemonizer: replace boost chrono/thread with std lib #9544

Open

iamamyth reviewed Oct 28, 2024

View reviewed changes

.github/workflows/guix.yml Outdated Show resolved Hide resolved

iamamyth reviewed Oct 28, 2024

View reviewed changes

contrib/guix/libexec/prelude.bash Outdated Show resolved Hide resolved

iamamyth reviewed Oct 29, 2024

View reviewed changes

contrib/guix/guix-attest Outdated Show resolved Hide resolved

tobtoht force-pushed the guix branch from f0800bf to a4a2d5a Compare October 29, 2024 12:32

iamamyth reviewed Oct 31, 2024

View reviewed changes

contrib/depends/Makefile Show resolved Hide resolved

iamamyth reviewed Oct 31, 2024

View reviewed changes

contrib/guix/libexec/build.sh Outdated Show resolved Hide resolved

iamamyth reviewed Oct 31, 2024

View reviewed changes

contrib/guix/libexec/build.sh Outdated Show resolved Hide resolved

iamamyth reviewed Oct 31, 2024

View reviewed changes

contrib/guix/libexec/build.sh Show resolved Hide resolved

tobtoht force-pushed the guix branch 2 times, most recently from c0e7638 to 52bf427 Compare November 1, 2024 19:13