ecoppens/colmena
1
0
Fork 0
forked from DGNum/colmena
Code Pull requests Activity

manual/multi-arch: Mention remote builds

Browse source
This commit is contained in:
Zhaofeng Li 2022-02-04 20:58:17 -08:00
parent d7b5cfb2ae
commit 7772335617
1 changed files with 9 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
manual/src/examples/multi-arch.md
View file

@ -1,9 +1,11 @@
# Multi-Architecture Deployments # Multi-Architecture Deployments
You can deploy to hosts running different architectures with a single configuration. You can deploy to hosts running different architectures with a single configuration.
This requires you to either [set up remote builders](https://nixos.org/manual/nix/stable/advanced-topics/distributed-builds.html) running the foreign architecture(s), or [set up binfmt emulation](https://nixos.wiki/wiki/NixOS_on_ARM#Compiling_through_QEMU) on the host running Colmena. There are two ways to achieve this:
## `binfmt` Emulation ## Using `binfmt` Emulation
On Linux hosts, you can run builds through transparent binary emulation using [QEMU and binfmt-misc](https://nixos.wiki/wiki/NixOS_on_ARM#Compiling_through_QEMU).
This following example sets up binfmt, allowing an X86-64 host (`laptop`) to build derivations for an AArch64 host (`rpi`) through QEMU: This following example sets up binfmt, allowing an X86-64 host (`laptop`) to build derivations for an AArch64 host (`rpi`) through QEMU:
@ -34,3 +36,8 @@ For more information on what is required on the local system, see [Local Deploym
After the new configuration is activated, binfmt emulation will be set up on the local machine. After the new configuration is activated, binfmt emulation will be set up on the local machine.
You can then deploy to the `rpi` node with `colmena apply --on rpi`. You can then deploy to the `rpi` node with `colmena apply --on rpi`.
## Building Remotely
If the remote nodes are powerful enough, you may also want to execute builds on them directly.
See [Remote Builds](../features/remote-builds.md) for more details.