amaharaneko/guix-mirrors
1
1
Fork 0
mirror of https://codeberg.org/guix/guix.git synced 2025-10-02 02:15:12 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

home: Add home-oci-service-type.

Browse source 
* gnu/home/service/containers.scm: New file;
* gnu/local.mk (GNU_SYSTEM_MODULES): Add it.
* doc/guix.texi (OCI backed services): Document it.

Change-Id: I8ce5b301e8032d0a7b2a9ca46752738cdee1f030
Signed-off-by: Maxim Cournoyer <maxim@guixotic.coop>
This commit is contained in:
Giacomo Leidi 2025-08-24 16:59:47 +02:00 • committed by Maxim Cournoyer
parent cc07ecd7cc
commit 57386498b6
No known key found for this signature in database
GPG key ID: 1260E46482E63562
3 changed files with 164 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

114
doc/guix.texi
View file

@ -53002,6 +53002,120 @@ For details about @code{readymedia-configuration}, check out the
documentation of the system service (@pxref{Miscellaneous Services,
@code{readymedia-service-type}}).
@subsubheading OCI backed services
@cindex OCI-backed, for Home
The @code{(gnu home services containers)} module provides the following service:
@defvar home-oci-service-type
This is the type of the service that allows to manage your OCI containers with
the same consistent interface you use for your other Home Shepherd services.
@end defvar
This service is a direct mapping of the @code{oci-service-type} system
service (@pxref{Miscellaneous Services, OCI backed services}). You can
use it like this:
@lisp
(use-modules (gnu services containers)
(gnu home services containers))
(simple-service 'home-oci-provisioning
home-oci-service-type
(oci-extension
(volumes
(list
(oci-volume-configuration (name "prometheus"))
(oci-volume-configuration (name "grafana"))))
(networks
(list
(oci-network-configuration (name "monitoring"))))
(containers
(list
(oci-container-configuration
(network "monitoring")
(image
(oci-image
(repository "guile")
(tag "3")
(value (specifications->manifest '("guile")))
(pack-options '(#:symlinks (("/bin/guile" -> "bin/guile"))
#:max-layers 2))))
(entrypoint "/bin/guile")
(command
'("-c" "(display \"hello!\n\")")))
(oci-container-configuration
(image "prom/prometheus")
(network "monitoring")
(ports
'(("9000" . "9000")
("9090" . "9090")))
(volumes
(list
'(("prometheus" . "/var/lib/prometheus")))))
(oci-container-configuration
(image "grafana/grafana:10.0.1")
(network "monitoring")
(volumes
'(("grafana:/var/lib/grafana"))))))))
@end lisp
You may specify a custom configuration by providing a
@code{oci-configuration} record, exactly like for
@code{oci-service-type}, but wrapping it in @code{for-home}:
@lisp
(use-modules (gnu services)
(gnu services containers)
(gnu home services containers))
(service home-oci-service-type
(for-home
(oci-configuration
(runtime 'podman)
(verbose? #t))))
(simple-service 'home-oci-provisioning
home-oci-service-type
(oci-extension
(volumes
(list
(oci-volume-configuration (name "prometheus"))
(oci-volume-configuration (name "grafana"))))
(networks
(list
(oci-network-configuration (name "monitoring"))))
(containers
(list
(oci-container-configuration
(network "monitoring")
(image
(oci-image
(repository "guile")
(tag "3")
(value (specifications->manifest '("guile")))
(pack-options '(#:symlinks (("/bin/guile" -> "bin/guile"))
#:max-layers 2))))
(entrypoint "/bin/guile")
(command
'("-c" "(display \"hello!\n\")")))
(oci-container-configuration
(image "prom/prometheus")
(network "monitoring")
(ports
'(("9000" . "9000")
("9090" . "9090")))
(volumes
(list
'(("prometheus" . "/var/lib/prometheus")))))
(oci-container-configuration
(image "grafana/grafana:10.0.1")
(network "monitoring")
(volumes
'(("grafana:/var/lib/grafana"))))))))
@end lisp
@node Invoking guix home
@section Invoking @command{guix home}