Next: Сервисы управления питанием, Previous: Samba Services, Up: Сервисы [Contents][Index]
Cuirass is a continuous integration tool for Guix. It can be used both for development and for providing substitutes to others (see Подстановки).
The (gnu services cuirass)
module provides the following service.
The type of the Cuirass service. Its value must be a
cuirass-configuration
object, as described below.
To add build jobs, you have to set the specifications
field of the
configuration. For instance, the following example will build all the
packages provided by the my-channel
channel.
(define %cuirass-specs #~(list (specification (name "my-channel") (build '(channels my-channel)) (channels (cons (channel (name 'my-channel) (url "https://my-channel.git")) %default-channels))))) (service cuirass-service-type (cuirass-configuration (specifications %cuirass-specs)))
To build the linux-libre
package defined by the default Guix channel,
one can use the following configuration.
(define %cuirass-specs #~(list (specification (name "my-linux") (build '(packages "linux-libre"))))) (service cuirass-service-type (cuirass-configuration (specifications %cuirass-specs)))
The other configuration possibilities, as well as the specification record itself are described in the Cuirass manual (see Specifications in Cuirass).
While information related to build jobs is located directly in the
specifications, global settings for the cuirass
process are
accessible in other cuirass-configuration
fields.
Data type representing the configuration of Cuirass.
cuirass
(default: cuirass
)The Cuirass package to use.
log-file
(default: "/var/log/cuirass.log"
)Location of the log file.
daemon-socket
(default: "/var/guix/daemon-socket/socket"
)Location of the log file used by the web interface.
cache-directory
(default: "/var/cache/cuirass"
)Location of the repository cache.
user
(default: "cuirass"
)Owner of the cuirass
process.
group
(default: "cuirass"
)Owner’s group of the cuirass
process.
interval
(default: 60
)Number of seconds between the poll of the repositories followed by the Cuirass jobs.
port
(default: 22
)Read parameters from the given parameters file. The supported parameters are described here (see Parameters in Cuirass).
features
(default: '()
)A cuirass-remote-server-configuration
record to use the build remote
mechanism or #f
to use the default build mechanism.
port
(default: 22
)Use database as the database containing the jobs and the past build
results. Since Cuirass uses PostgreSQL as a database engine, database
must be a string such as "dbname=cuirass host=localhost"
.
port
(default: 8081
)Port number used by the HTTP server.
host
(default: "localhost"
)Listen on the network interface for host. The default is to accept connections from localhost.
specifications
(default: #~'()
)A gexp (see G-Expressions) that evaluates to a list of specifications records. The specification record is described in the Cuirass manual (see Specifications in Cuirass).
use-substitutes?
(default: #f
)This allows using substitutes to avoid building every dependencies of a job from source.
one-shot?
(default: #f
)Only evaluate specifications and build derivations once.
fallback?
(default: #f
)When substituting a pre-built binary fails, fall back to building packages locally.
extra-options
(default: '()
)Extra options to pass when running the Cuirass processes.
Cuirass supports two mechanisms to build derivations.
To enable this build mode a cuirass-remote-server-configuration
record must be passed as remote-server
argument of the
cuirass-configuration
record. The
cuirass-remote-server-configuration
record is described below.
This build mode scales way better than the default build mode. This is the build mode that is used on the GNU Guix build farm at https://ci.guix.gnu.org. It should be preferred when using Cuirass to build large amount of packages.
Управление конфигурацией операционной системы.
port
(default: 22
)The TCP port for communicating with remote-worker
processes using
ZMQ. It defaults to 5555
.
port
(default: 22
)The TCP port of the log server. It defaults to 5556
.
port
(default: 22
)The TCP port of the publish server. It defaults to 5557
.
daemon-socket
(default: "/var/guix/daemon-socket/socket"
)Location of the log file.
daemon-socket
(default: "/var/guix/daemon-socket/socket"
)Use cache directory to cache build log files.
features
(default: '()
)Once a substitute is successfully fetched, trigger substitute baking at trigger-url.
publish?
(default: #t
)If set to false, do not start a publish server and ignore the
publish-port
argument. This can be useful if there is already a
standalone publish server standing next to the remote server.
public-key
private-key
Use the specific files as the public/private key pair used to sign the store items being published.
At least one remote worker must also be started on any machine of the local network to actually perform the builds and report their status.
Управление конфигурацией операционной системы.
cuirass
(default: cuirass
)The Cuirass package to use.
features
(default: '()
)Start workers parallel workers.
features
(default: '()
)Do not use Avahi discovery and connect to the given server
IP address
instead.
port
(default: 22
)Only request builds for the given systems.
daemon-socket
(default: "/var/guix/daemon-socket/socket"
)Location of the log file.
port
(default: 22
)The TCP port of the publish server. It defaults to 5558
.
port
(default: 22
)The list of URLs where to look for substitutes by default.
public-key
private-key
Use the specific files as the public/private key pair used to sign the store items being published.
Laminar is a lightweight and modular Continuous Integration service. It doesn’t have a configuration web UI instead uses version-controllable configuration files and scripts.
Laminar encourages the use of existing tools such as bash and cron instead of reinventing them.
The type of the Laminar service. Its value must be a
laminar-configuration
object, as described below.
All configuration values have defaults, a minimal configuration to get Laminar running is shown below. By default, the web interface is available on port 8080.
Управление конфигурацией операционной системы.
port
(default: 22
)Используемый пакет Mumi.
port
(default: 22
)The directory for job configurations and run directories.
port
(default: 22
)The interface/port or unix socket on which laminard should listen for incoming connections to the web frontend.
port
(default: 22
)The interface/port or unix socket on which laminard should listen for incoming commands such as build triggers.
port
(default: 22
)Сервис rottlog.
features
(default: '()
)Set to an integer defining how many rundirs to keep per job. The lowest-numbered ones will be deleted. The default is 0, meaning all run dirs will be immediately deleted.
features
(default: '()
)The web frontend served by laminard will use this URL to form links to artefacts archived jobs.
features
(default: '()
)URI для использования в базе данных.
Next: Сервисы управления питанием, Previous: Samba Services, Up: Сервисы [Contents][Index]