doc: Remove Simple Cuirass section.
This is no longer needed as the Cuirass specification mechanism has been rewritten. * doc/guix.texi (Continuous Integration): Remove Simple Cuirass section.
This commit is contained in:
parent
5802858be3
commit
8ac7fae8b0
112
doc/guix.texi
112
doc/guix.texi
@ -27215,118 +27215,6 @@ The Cuirass package to use.
|
||||
@end table
|
||||
@end deftp
|
||||
|
||||
@cindex simple cuirass
|
||||
@subsubheading Simple Cuirass
|
||||
|
||||
The Cuirass service configuration described above can be a little
|
||||
intimidating. In particular, getting the right @code{specifications}
|
||||
can prove difficult. The @code{simple-cuirass-configuration->specs}
|
||||
procedure offers a way to generate those @code{specifications} and thus
|
||||
setup a continuous integration server more readily.
|
||||
|
||||
@deffn {Scheme Procedure} simple-cuirass-configuration->specs @var{configuration}
|
||||
This procedure takes a @code{simple-cuirass-configuration} record as
|
||||
argument and returns the corresponding Cuirass specifications gexp.
|
||||
@end deffn
|
||||
|
||||
@deftp {Data Type} simple-cuirass-configuration
|
||||
Data type representing the configuration of a simple Cuirass instance.
|
||||
|
||||
@table @asis
|
||||
@item @code{build} (default: @code{all})
|
||||
The packages to be built by Cuirass. It defaults to @code{all}, which
|
||||
means that all the discovered packages in the subsequent @code{channels}
|
||||
field are to be selected.
|
||||
|
||||
It is also possible to set this field to a list of @code{build-manifest}
|
||||
records, so that only the packages that are part of the declared
|
||||
manifests are built. This record is described below.
|
||||
|
||||
@deftp {Data Type} build-manifest
|
||||
@table @asis
|
||||
@item @code{channel-name}
|
||||
The name of the channel where the manifest is located.
|
||||
|
||||
@item @code{manifest}
|
||||
The manifest path inside the channel.
|
||||
|
||||
@end table
|
||||
@end deftp
|
||||
|
||||
@item @code{channels} (default: @code{%default-channels})
|
||||
The channels to be fetched by Cuirass (@pxref{Channels}).
|
||||
|
||||
@item @code{non-package-channels} (default: @code{'()})
|
||||
List the channel names that must not be searched for packages. That is
|
||||
often the case for the channel containing the manifest.
|
||||
|
||||
@item @code{systems} (default: @code{(list (%current-system))})
|
||||
Build every discovered package for each system in this list. By default
|
||||
only the current system is selected.
|
||||
|
||||
@end table
|
||||
@end deftp
|
||||
|
||||
Here is an example of how to setup a Cuirass instance that builds all
|
||||
the packages declared by Guix and a user repository. The package list
|
||||
is re-evaluated each time a commit is pushed in one of the declared
|
||||
channels.
|
||||
|
||||
@lisp
|
||||
(service cuirass-service-type
|
||||
(cuirass-configuration
|
||||
(specifications
|
||||
(simple-cuirass-configuration->specs
|
||||
(simple-cuirass-configuration
|
||||
(build 'all)
|
||||
(channels (cons (channel
|
||||
(name 'my-guix)
|
||||
(url "https://my-git-repo/guix.git"))
|
||||
%default-channels)))))))
|
||||
@end lisp
|
||||
|
||||
In the same spirit, this builds all the packages that are part of the
|
||||
@code{guix} or @code{my-guix} channels and declared in the manifest
|
||||
located in the @code{conf} channel.
|
||||
|
||||
@lisp
|
||||
(service cuirass-service-type
|
||||
(cuirass-configuration
|
||||
(specifications
|
||||
(simple-cuirass-configuration->specs
|
||||
(simple-cuirass-configuration
|
||||
(build (list
|
||||
(build-manifest
|
||||
(channel-name 'conf)
|
||||
(manifest "guix/manifest.scm"))))
|
||||
(channels (cons* (channel
|
||||
(name 'my-guix)
|
||||
(url "https://my-git-repo/guix.git"))
|
||||
(channel
|
||||
(name 'conf)
|
||||
(url "https://my-git-repo/conf.git"))
|
||||
%default-channels))
|
||||
(non-package-channels '(conf)))))))
|
||||
@end lisp
|
||||
|
||||
Finally, @code{simple-cuirass-services} takes as a second optional
|
||||
argument a @code{cuirass-configuration} record. It can be used to
|
||||
customize the configuration of the Cuirass instance.
|
||||
|
||||
@lisp
|
||||
(simple-cuirass-services
|
||||
(simple-cuirass-configuration
|
||||
(build 'all)
|
||||
(channels (cons (channel
|
||||
(name 'my-guix)
|
||||
(url "https://my-git-repo/guix.git"))
|
||||
%default-channels))
|
||||
(non-package-channels '(conf)))
|
||||
(cuirass-configuration
|
||||
(inherit %default-cuirass-config)
|
||||
(host "0.0.0.0"))) ;listen on all interfaces.
|
||||
@end lisp
|
||||
|
||||
@node Power Management Services
|
||||
@subsection Power Management Services
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user