aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMarius Bakke <marius@gnu.org>2020-07-17 01:04:24 +0200
committerMarius Bakke <marius@gnu.org>2020-07-17 01:04:24 +0200
commit0482ea07f9d8ee53108ef6507d15fa7a70ac1a71 (patch)
tree38eaac85af3fc66cb2b70dd6ab5a08d7112126e0 /doc
parent074814fe575ebf36049a26351cc7853967ceb0ae (diff)
downloadguix-0482ea07f9d8ee53108ef6507d15fa7a70ac1a71.tar
guix-0482ea07f9d8ee53108ef6507d15fa7a70ac1a71.tar.gz
doc: Small fixups for the Ganeti documentation.
* doc/guix.texi (Virtualization Services): Fix various inaccuracies and add markup the procedure parameters.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi30
1 files changed, 14 insertions, 16 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index a6ee679b11..40c8f06bf0 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -24982,7 +24982,7 @@ the @code{--snapshot} flag using something along these lines:
@quotation Note
This service is considered experimental. Configuration options may be changed
in a backwards-incompatible manner, and not all features have been thorougly
-tested. Users of this service are encouraged to share their experience at
+tested. Users of this service are encouraged to share their experience at
@email{guix-devel@@gnu.org}.
@end quotation
@@ -25050,7 +25050,7 @@ Users are advised to read the
administrators guide} to learn about the various cluster options and
day-to-day operations. There is also a
@url{https://guix.gnu.org/blog/2020/ganeti-on-guix/,blog post}
-describing how to configure a small cluster.
+describing how to configure and initialize a small cluster.
@defvr {Scheme Variable} ganeti-service-type
This is a service type that includes all the various services that Ganeti
@@ -25058,6 +25058,8 @@ nodes should run.
Its value is a @code{ganeti-configuration} object that defines the package
to use for CLI operations, as well as configuration for the various daemons.
+Allowed file storage paths and available guest operating systems are also
+configured through this data type.
@end defvr
@deftp {Data Type} ganeti-configuration
@@ -25124,8 +25126,8 @@ storage backend and OS variants.
@end deftp
@deftp {Data Type} ganeti-os
-This data type is suitable for passing to the @code{os} configuration of
-Ganeti. It takes the following parameters:
+This data type is suitable for passing to the @code{os} parameter of
+@code{ganeti-configuration}. It takes the following parameters:
@table @asis
@item @code{name}
@@ -25175,16 +25177,14 @@ scripts that will run when the OS is installed. It can also be a list of
@code{(name . file-like)} pairs. For example:
@lisp
-
`((99-hello-world . ,(plain-file "#!/bin/sh\necho Hello, World")))
-
@end lisp
That will create a directory with one executable named @code{99-hello-world}
and run it every time this variant is installed. If set to @code{#f}, hooks
in @file{/etc/ganeti/instance-debootstrap/hooks} will be used, if any.
@item @code{proxy} (default: @code{#f})
-HTTP proxy to use, if any.
+Optional HTTP proxy to use.
@item @code{mirror} (default: @code{#f})
The Debian mirror. Typically something like @code{http://ftp.no.debian.org/debian}.
The default varies depending on the distribution.
@@ -25213,24 +25213,24 @@ Alignment of the partition in sectors.
@end table
@end deftp
-@deffn {Scheme Procedure} debootstrap-variant
+@deffn {Scheme Procedure} debootstrap-variant @var{name} @var{configuration}
This is a helper procedure that creates a @code{ganeti-os-variant} record. It
takes two parameters: a name and a @code{debootstrap-configuration} object.
@end deffn
-@deffn {Scheme Procedure} debootstrap-os
+@deffn {Scheme Procedure} debootstrap-os @var{variants}@dots{}
This is a helper procedure that creates a @code{ganeti-os} record. It takes
a list of variants created with @code{debootstrap-variant}.
@end deffn
-@deffn {Scheme Procedure} guix-variant
+@deffn {Scheme Procedure} guix-variant @var{name} @var{configuration}
This is a helper procedure that creates a @code{ganeti-os-variant} record for
use with the Guix OS provider. It takes a name and a G-expression that returns
a ``file-like'' (@pxref{G-Expressions, file-like objects}) object containing a
Guix System configuration.
@end deffn
-@deffn {Scheme Procedure} guix-os
+@deffn {Scheme Procedure} guix-os @var{variants}@dots{}
This is a helper procedure that creates a @code{ganeti-os} record. It
takes a list of variants produced by @code{guix-variant}.
@end deffn
@@ -25243,7 +25243,7 @@ contains a single debootstrap variant with the default configuration:
@lisp
(list (debootstrap-variant
"default"
- (debootstrap-configuration))))
+ (debootstrap-configuration)))
@end lisp
@end defvr
@@ -25256,7 +25256,7 @@ server, a serial console, and authorizes the Ganeti hosts SSH keys.
(list (guix-variant
"default"
(file-append ganeti-instance-guix
- "/share/doc/ganeti-instance-guix/examples/dynamic.scm"))))
+ "/share/doc/ganeti-instance-guix/examples/dynamic.scm")))
@end lisp
@end defvr
@@ -25524,9 +25524,7 @@ When true, the daemon performs additional logging for debugging purposes.
@defvr {Scheme Variable} ganeti-metad-service-type
@command{ganeti-metad} is an optional daemon that can be used to provide
-information about the cluster to instances or OS install scripts. It is
-not included in @code{ganeti-service-type} because using it requires
-additional configuration and support in OS providers.
+information about the cluster to instances or OS install scripts.
It takes a @code{ganeti-metad-configuration} object.
@end defvr