Zen

Translation

English type: code{#1}
name
3/100 · 4

Sign in to save the translation.

English Persian Actions
offloading
 
build hook
 
When desired, the build daemon can @dfn{offload} derivation builds to other machines running Guix, using the @code{offload} @dfn{build hook}@footnote{This feature is available only when @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH} is present.}. When that feature is enabled, a list of user-specified build machines is read from @file{/etc/guix/machines.scm}; every time a build is requested, for instance via @code{guix build}, the daemon attempts to offload it to one of the machines that satisfy the constraints of the derivation, in particular its system types---e.g., @code{x86_64-linux}. A single machine can have multiple system types, either because its architecture natively supports it, via emulation (@pxref{transparent-emulation-qemu, Transparent Emulation with QEMU}), or both. Missing prerequisites for the build are copied over SSH to the target machine, which then proceeds with the build; upon success the output(s) of the build are copied back to the initial machine. The offload facility comes with a basic scheduler that attempts to select the best machine. The best machine is chosen among the available machines based on criteria such as:
 
The availability of a build slot. A build machine can have as many build slots (connections) as the value of the @code{parallel-builds} field of its @code{build-machine} object.
 
Its relative speed, as defined via the @code{speed} field of its @code{build-machine} object.
 
Its load. The normalized machine load must be lower than a threshold value, configurable via the @code{overload-threshold} field of its @code{build-machine} object.
 
Disk space availability. More than a 100 MiB must be available.
 
The @file{/etc/guix/machines.scm} file typically looks like this:
 
(list (build-machine
(name "eightysix.example.org")
(systems (list "x86_64-linux" "i686-linux"))
(host-key "ssh-ed25519 AAAAC3Nza@dots{}")
(user "bob")
(speed 2.)) ;incredibly fast!

 
(build-machine
(name "armeight.example.org")
(systems (list "aarch64-linux"))
(host-key "ssh-rsa AAAAB3Nza@dots{}")
(user "alice")

 
;; Remember 'guix offload' is spawned by
;; 'guix-daemon' as root.
(private-key "/root/.ssh/identity-for-guix")))
 
In the example above we specify a list of two build machines, one for the @code{x86_64} and @code{i686} architectures and one for the @code{aarch64} architecture.
 
In fact, this file is---not surprisingly!---a Scheme file that is evaluated when the @code{offload} hook is started. Its return value must be a list of @code{build-machine} objects. While this example shows a fixed list of build machines, one could imagine, say, using DNS-SD to return a list of potential build machines discovered in the local network (@pxref{Introduction, Guile-Avahi,, guile-avahi, Using Avahi in Guile Scheme Programs}). The @code{build-machine} data type is detailed below.
 
{Data Type} build-machine
 
This data type represents build machines to which the daemon may offload builds. The important fields are:
 
name
نام
The host name of the remote machine.
 
systems
 
The system types the remote machine supports---e.g., @code{(list "x86_64-linux" "i686-linux")}.
 
user
user
The user account on the remote machine to use when connecting over SSH. Note that the SSH key pair must @emph{not} be passphrase-protected, to allow non-interactive logins.
 
host-key
 
This must be the machine's SSH @dfn{public host key} in OpenSSH format. This is used to authenticate the machine when we connect to it. It is a long string that looks like this:
 
ssh-ed25519 AAAAC3NzaC@dots{}mde+UhL hint@@example.org
 
If the machine is running the OpenSSH daemon, @command{sshd}, the host key can be found in a file such as @file{/etc/ssh/ssh_host_ed25519_key.pub}.
 
If the machine is running the SSH daemon of GNU@tie{}lsh, @command{lshd}, the host key is in @file{/etc/lsh/host-key.pub} or a similar file. It can be converted to the OpenSSH format using @command{lsh-export-key} (@pxref{Converting keys,,, lsh, LSH Manual}):
 
$ lsh-export-key --openssh < /etc/lsh/host-key.pub
ssh-rsa AAAAB3NzaC1yc2EAAAAEOp8FoQAAAQEAs1eB46LV@dots{}
 
A number of optional fields may be specified:
 
@code{port} (default: @code{22})
 
Port number of SSH server on the machine.
 
@code{private-key} (default: @file{~root/.ssh/id_rsa})
 

Loading…

User avatar soheilkhanalipur

Translation added
name
نام
3 years ago
Browse all string changes

Things to check

Reused translation

Other source strings: “Hosting”, “Name”

Reset

Glossary

English Persian
No related strings found in the glossary.

7190424 String information

Source string description
type: code{#1}
Flags
no-wrap
Source string location
guix-git/doc/guix.texi:1129 • guix-git/doc/guix.texi:7863 • guix-git/doc/guix.texi:8932 • guix-git/doc/guix.texi:18744 • guix-git/doc/guix.texi:18843 • guix-git/doc/guix.texi:19090 • guix-git/doc/guix.texi:21351 • guix-git/doc/guix.texi:22262 • guix-git/doc/guix.texi:22590 • guix-git/doc/guix.texi:26783 • guix-git/doc/guix.texi:29972 • guix-git/doc/guix.texi:31513 • guix-git/doc/guix.texi:32310 • guix-git/doc/guix.texi:32722 • guix-git/doc/guix.texi:32777 • guix-git/doc/guix.texi:35044 • guix-git/doc/guix.texi:38226 • guix-git/doc/guix.texi:38264 • guix-git/doc/guix.texi:41478 • guix-git/doc/guix.texi:41495 • guix-git/doc/guix.texi:43208 • guix-git/doc/guix.texi:45250 • guix-git/doc/guix.texi:45608 • guix-git/doc/guix.texi:49884
String age
3 years ago
Last updated
a week ago
Source string age
4 years ago
Translation file
po/doc/guix-manual.fa.po, string 1603