2274d71f94
* gnu/services/admin.scm (file-database-configuration)[excluded-directories]: Mention that these are regexps. (%default-file-database-excluded-directories): Likewise. * doc/guix.texi (File Search Services): Adjust accordingly.
536 lines
21 KiB
Scheme
536 lines
21 KiB
Scheme
;;; GNU Guix --- Functional package management for GNU
|
||
;;; Copyright © 2016 Jan Nieuwenhuizen <janneke@gnu.org>
|
||
;;; Copyright © 2016-2023 Ludovic Courtès <ludo@gnu.org>
|
||
;;; Copyright © 2020 Brice Waegeneire <brice@waegenei.re>
|
||
;;; Copyright © 2023 Giacomo Leidi <goodoldpaul@autistici.org>
|
||
;;;
|
||
;;; This file is part of GNU Guix.
|
||
;;;
|
||
;;; GNU Guix is free software; you can redistribute it and/or modify it
|
||
;;; under the terms of the GNU General Public License as published by
|
||
;;; the Free Software Foundation; either version 3 of the License, or (at
|
||
;;; your option) any later version.
|
||
;;;
|
||
;;; GNU Guix is distributed in the hope that it will be useful, but
|
||
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;;; GNU General Public License for more details.
|
||
;;;
|
||
;;; You should have received a copy of the GNU General Public License
|
||
;;; along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
(define-module (gnu services admin)
|
||
#:use-module (gnu packages admin)
|
||
#:use-module ((gnu packages base)
|
||
#:select (canonical-package findutils coreutils sed))
|
||
#:use-module (gnu packages certs)
|
||
#:use-module (gnu packages package-management)
|
||
#:use-module (gnu services)
|
||
#:use-module (gnu services configuration)
|
||
#:use-module (gnu services mcron)
|
||
#:use-module (gnu services shepherd)
|
||
#:use-module (gnu system accounts)
|
||
#:use-module ((gnu system shadow) #:select (account-service-type))
|
||
#:use-module ((guix store) #:select (%store-prefix))
|
||
#:use-module (guix gexp)
|
||
#:use-module (guix modules)
|
||
#:use-module (guix packages)
|
||
#:use-module (guix records)
|
||
#:use-module (srfi srfi-1)
|
||
#:use-module (ice-9 match)
|
||
#:use-module (ice-9 vlist)
|
||
#:export (%default-rotations
|
||
%rotated-files
|
||
|
||
log-rotation
|
||
log-rotation?
|
||
log-rotation-frequency
|
||
log-rotation-files
|
||
log-rotation-options
|
||
log-rotation-post-rotate
|
||
%default-log-rotation-options
|
||
|
||
rottlog-configuration
|
||
rottlog-configuration?
|
||
rottlog-service
|
||
rottlog-service-type
|
||
|
||
log-cleanup-service-type
|
||
log-cleanup-configuration
|
||
log-cleanup-configuration?
|
||
log-cleanup-configuration-directory
|
||
log-cleanup-configuration-expiry
|
||
log-cleanup-configuration-schedule
|
||
|
||
file-database-service-type
|
||
file-database-configuration
|
||
file-database-configuration?
|
||
file-database-configuration-package
|
||
file-database-configuration-schedule
|
||
file-database-configuration-excluded-directories
|
||
%default-file-database-update-schedule
|
||
%default-file-database-excluded-directories
|
||
|
||
package-database-service-type
|
||
package-database-configuration
|
||
package-database-configuration?
|
||
package-database-configuration-package
|
||
package-database-configuration-schedule
|
||
package-database-configuration-method
|
||
package-database-configuration-channels
|
||
|
||
unattended-upgrade-service-type
|
||
unattended-upgrade-configuration
|
||
unattended-upgrade-configuration?
|
||
unattended-upgrade-configuration-operating-system-file
|
||
unattended-upgrade-configuration-operating-system-expression
|
||
unattended-upgrade-configuration-channels
|
||
unattended-upgrade-configuration-schedule
|
||
unattended-upgrade-configuration-services-to-restart
|
||
unattended-upgrade-configuration-system-expiration
|
||
unattended-upgrade-configuration-maximum-duration
|
||
unattended-upgrade-configuration-log-file))
|
||
|
||
;;; Commentary:
|
||
;;;
|
||
;;; This module implements configuration of rottlog by writing
|
||
;;; /etc/rottlog/{rc,hourly|daily|weekly}. Example usage
|
||
;;;
|
||
;;; (mcron-service)
|
||
;;; (service rottlog-service-type)
|
||
;;;
|
||
;;; Code:
|
||
|
||
(define-record-type* <log-rotation> log-rotation make-log-rotation
|
||
log-rotation?
|
||
(files log-rotation-files) ;list of strings
|
||
(frequency log-rotation-frequency ;symbol
|
||
(default 'weekly))
|
||
(post-rotate log-rotation-post-rotate ;#f | gexp
|
||
(default #f))
|
||
(options log-rotation-options ;list of strings
|
||
(default %default-log-rotation-options)))
|
||
|
||
(define %default-log-rotation-options
|
||
;; Default log rotation options: append ".gz" to file names.
|
||
'("storefile @FILENAME.@COMP_EXT"
|
||
"notifempty"))
|
||
|
||
(define %rotated-files
|
||
;; Syslog files subject to rotation.
|
||
'("/var/log/messages" "/var/log/secure" "/var/log/debug"
|
||
"/var/log/maillog" "/var/log/mcron.log"))
|
||
|
||
(define %default-rotations
|
||
(list (log-rotation ;syslog files
|
||
(files %rotated-files)
|
||
|
||
(frequency 'weekly)
|
||
(options `(;; These files are worth keeping for a few weeks.
|
||
"rotate 16"
|
||
;; Run post-rotate once per rotation
|
||
"sharedscripts"
|
||
|
||
,@%default-log-rotation-options))
|
||
;; Restart syslogd after rotation.
|
||
(post-rotate #~(let ((pid (call-with-input-file "/var/run/syslog.pid"
|
||
read)))
|
||
(kill pid SIGHUP))))
|
||
(log-rotation
|
||
(files '("/var/log/guix-daemon.log"))
|
||
(options `("rotate 4" ;don't keep too many of them
|
||
,@%default-log-rotation-options)))))
|
||
|
||
(define (log-rotation->config rotation)
|
||
"Return a string-valued gexp representing the rottlog configuration snippet
|
||
for ROTATION."
|
||
(define post-rotate
|
||
(let ((post (log-rotation-post-rotate rotation)))
|
||
(and post
|
||
(program-file "rottlog-post-rotate.scm" post))))
|
||
|
||
#~(let ((post #$post-rotate))
|
||
(string-append (string-join '#$(log-rotation-files rotation) ",")
|
||
" {"
|
||
#$(string-join (log-rotation-options rotation)
|
||
"\n " 'prefix)
|
||
(if post
|
||
(string-append "\n postrotate\n " post
|
||
"\n endscript\n")
|
||
"")
|
||
"\n}\n")))
|
||
|
||
(define (log-rotations->/etc-entries rotations)
|
||
"Return the list of /etc entries for ROTATIONS, a list of <log-rotation>."
|
||
(define (frequency-file frequency rotations)
|
||
(computed-file (string-append "rottlog." (symbol->string frequency))
|
||
#~(call-with-output-file #$output
|
||
(lambda (port)
|
||
(for-each (lambda (str)
|
||
(display str port))
|
||
(list #$@(map log-rotation->config
|
||
rotations)))))))
|
||
|
||
(let* ((frequencies (delete-duplicates
|
||
(map log-rotation-frequency rotations)))
|
||
(table (fold (lambda (rotation table)
|
||
(vhash-consq (log-rotation-frequency rotation)
|
||
rotation table))
|
||
vlist-null
|
||
rotations)))
|
||
(map (lambda (frequency)
|
||
`(,(symbol->string frequency)
|
||
,(frequency-file frequency
|
||
(vhash-foldq* cons '() frequency table))))
|
||
frequencies)))
|
||
|
||
(define (default-jobs rottlog)
|
||
(list #~(job '(next-hour '(0)) ;midnight
|
||
#$(file-append rottlog "/sbin/rottlog"))
|
||
#~(job '(next-hour '(12)) ;noon
|
||
#$(file-append rottlog "/sbin/rottlog"))))
|
||
|
||
(define-record-type* <rottlog-configuration>
|
||
rottlog-configuration make-rottlog-configuration
|
||
rottlog-configuration?
|
||
(rottlog rottlog-rottlog ;file-like
|
||
(default rottlog))
|
||
(rc-file rottlog-rc-file ;file-like
|
||
(default (file-append rottlog "/etc/rc")))
|
||
(rotations rottlog-rotations ;list of <log-rotation>
|
||
(default %default-rotations))
|
||
(jobs rottlog-jobs ;list of <mcron-job>
|
||
(default #f)))
|
||
|
||
(define (rottlog-etc config)
|
||
`(("rottlog"
|
||
,(file-union "rottlog"
|
||
(cons `("rc" ,(rottlog-rc-file config))
|
||
(log-rotations->/etc-entries
|
||
(rottlog-rotations config)))))))
|
||
|
||
(define (rottlog-jobs-or-default config)
|
||
(or (rottlog-jobs config)
|
||
(default-jobs (rottlog-rottlog config))))
|
||
|
||
(define rottlog-service-type
|
||
(service-type
|
||
(name 'rottlog)
|
||
(description
|
||
"Periodically rotate log files using GNU@tie{}Rottlog and GNU@tie{}mcron.
|
||
Old log files are removed or compressed according to the configuration.")
|
||
(extensions (list (service-extension etc-service-type rottlog-etc)
|
||
(service-extension mcron-service-type
|
||
rottlog-jobs-or-default)
|
||
|
||
;; Add Rottlog to the global profile so users can access
|
||
;; the documentation.
|
||
(service-extension profile-service-type
|
||
(compose list rottlog-rottlog))))
|
||
(compose concatenate)
|
||
(extend (lambda (config rotations)
|
||
(rottlog-configuration
|
||
(inherit config)
|
||
(rotations (append (rottlog-rotations config)
|
||
rotations)))))
|
||
(default-value (rottlog-configuration))))
|
||
|
||
|
||
;;;
|
||
;;; Build log removal.
|
||
;;;
|
||
|
||
(define-record-type* <log-cleanup-configuration>
|
||
log-cleanup-configuration make-log-cleanup-configuration
|
||
log-cleanup-configuration?
|
||
(directory log-cleanup-configuration-directory) ;string
|
||
(expiry log-cleanup-configuration-expiry ;integer (seconds)
|
||
(default (* 6 30 24 3600)))
|
||
(schedule log-cleanup-configuration-schedule ;string or gexp
|
||
(default "30 12 01,08,15,22 * *")))
|
||
|
||
(define (log-cleanup-program directory expiry)
|
||
(program-file "delete-old-logs"
|
||
(with-imported-modules '((guix build utils))
|
||
#~(begin
|
||
(use-modules (guix build utils))
|
||
|
||
(let* ((now (car (gettimeofday)))
|
||
(logs (find-files #$directory
|
||
(lambda (file stat)
|
||
(> (- now (stat:mtime stat))
|
||
#$expiry)))))
|
||
(format #t "deleting ~a log files from '~a'...~%"
|
||
(length logs) #$directory)
|
||
(for-each delete-file logs))))))
|
||
|
||
(define (log-cleanup-mcron-jobs configuration)
|
||
(match-record configuration <log-cleanup-configuration>
|
||
(directory expiry schedule)
|
||
(list #~(job #$schedule
|
||
#$(log-cleanup-program directory expiry)))))
|
||
|
||
(define log-cleanup-service-type
|
||
(service-type
|
||
(name 'log-cleanup)
|
||
(extensions
|
||
(list (service-extension mcron-service-type
|
||
log-cleanup-mcron-jobs)))
|
||
(description
|
||
"Periodically delete old log files.")))
|
||
|
||
|
||
;;;
|
||
;;; File databases.
|
||
;;;
|
||
|
||
(define %default-file-database-update-schedule
|
||
;; Default mcron schedule for the periodic 'updatedb' job: once every
|
||
;; Sunday.
|
||
"10 23 * * 0")
|
||
|
||
(define %default-file-database-excluded-directories
|
||
;; Regexps of directories excluded from the 'locate' database.
|
||
(list (%store-prefix)
|
||
"/tmp" "/var/tmp" "/var/cache" ".*/\\.cache"
|
||
"/run/udev"))
|
||
|
||
(define (string-or-gexp? obj)
|
||
(or (string? obj) (gexp? obj)))
|
||
|
||
(define string-list?
|
||
(match-lambda
|
||
(((? string?) ...) #t)
|
||
(_ #f)))
|
||
|
||
(define-configuration/no-serialization file-database-configuration
|
||
(package
|
||
(file-like (let-system (system target)
|
||
;; Unless we're cross-compiling, avoid pulling a second copy
|
||
;; of findutils.
|
||
(if target
|
||
findutils
|
||
(canonical-package findutils))))
|
||
"The GNU@tie{}Findutils package from which the @command{updatedb} command
|
||
is taken.")
|
||
(schedule
|
||
(string-or-gexp %default-file-database-update-schedule)
|
||
"String or G-exp denoting an mcron schedule for the periodic
|
||
@command{updatedb} job (@pxref{Guile Syntax,,, mcron, GNU@tie{}mcron}).")
|
||
(excluded-directories
|
||
(string-list %default-file-database-excluded-directories)
|
||
"List of regular expressions of directories to ignore when building the
|
||
file database. By default, this includes @file{/tmp} and @file{/gnu/store};
|
||
the latter should instead be indexed by @command{guix locate} (@pxref{Invoking
|
||
guix locate}). This list is passed to the @option{--prunepaths} option of
|
||
@command{updatedb} (@pxref{Invoking updatedb,,, find, GNU@tie{}Findutils})."))
|
||
|
||
(define (file-database-mcron-jobs configuration)
|
||
(match-record configuration <file-database-configuration>
|
||
(package schedule excluded-directories)
|
||
(let ((updatedb (program-file
|
||
"updatedb"
|
||
#~(begin
|
||
;; 'updatedb' is a shell script that expects various
|
||
;; commands in $PATH.
|
||
(setenv "PATH"
|
||
(string-append #$package "/bin:"
|
||
#$(canonical-package coreutils)
|
||
"/bin:"
|
||
#$(canonical-package sed)
|
||
"/bin"))
|
||
(execl #$(file-append package "/bin/updatedb")
|
||
"updatedb"
|
||
#$(string-append "--prunepaths="
|
||
(string-join
|
||
excluded-directories)))))))
|
||
(list #~(job #$schedule #$updatedb)))))
|
||
|
||
(define file-database-service-type
|
||
(service-type
|
||
(name 'file-database)
|
||
(extensions (list (service-extension mcron-service-type
|
||
file-database-mcron-jobs)))
|
||
(description
|
||
"Periodically update the file database used by the @command{locate} command,
|
||
which lets you search for files by name. The database is created by running
|
||
the @command{updatedb} command.")
|
||
(default-value (file-database-configuration))))
|
||
|
||
(define %default-package-database-update-schedule
|
||
;; Default mcron schedule for the periodic 'guix locate --update' job: once
|
||
;; every Monday.
|
||
"10 23 * * 1")
|
||
|
||
(define-configuration/no-serialization package-database-configuration
|
||
(package (file-like guix)
|
||
"The Guix package to use.")
|
||
(schedule (string-or-gexp
|
||
%default-package-database-update-schedule)
|
||
"String or G-exp denoting an mcron schedule for the periodic
|
||
@command{guix locate --update} job (@pxref{Guile Syntax,,, mcron,
|
||
GNU@tie{}mcron}).")
|
||
(method (symbol 'store)
|
||
"Indexing method for @command{guix locate}. The default value,
|
||
@code{'store}, yields a more complete database but is relatively expensive in
|
||
terms of CPU and input/output.")
|
||
(channels (gexp #~%default-channels)
|
||
"G-exp denoting the channels to use when updating the database
|
||
(@pxref{Channels})."))
|
||
|
||
(define (package-database-mcron-jobs configuration)
|
||
(match-record configuration <package-database-configuration>
|
||
(package schedule method channels)
|
||
(let ((channels (scheme-file "channels.scm" channels)))
|
||
(list #~(job #$schedule
|
||
;; XXX: The whole thing's running as "root" just because it
|
||
;; needs write access to /var/cache/guix/locate.
|
||
(string-append #$(file-append package "/bin/guix")
|
||
" time-machine -C " #$channels
|
||
" -- locate --update --method="
|
||
#$(symbol->string method)))))))
|
||
|
||
(define package-database-service-type
|
||
(service-type
|
||
(name 'package-database)
|
||
(extensions (list (service-extension mcron-service-type
|
||
package-database-mcron-jobs)))
|
||
(description
|
||
"Periodically update the package database used by the @code{guix locate} command,
|
||
which lets you search for packages that provide a given file.")
|
||
(default-value (package-database-configuration))))
|
||
|
||
|
||
;;;
|
||
;;; Unattended upgrade.
|
||
;;;
|
||
|
||
(define-record-type* <unattended-upgrade-configuration>
|
||
unattended-upgrade-configuration make-unattended-upgrade-configuration
|
||
unattended-upgrade-configuration?
|
||
(operating-system-file unattended-upgrade-operating-system-file
|
||
(default "/run/current-system/configuration.scm"))
|
||
(operating-system-expression unattended-upgrade-operating-system-expression
|
||
(default #f))
|
||
(schedule unattended-upgrade-configuration-schedule
|
||
(default "30 01 * * 0"))
|
||
(channels unattended-upgrade-configuration-channels
|
||
(default #~%default-channels))
|
||
(services-to-restart unattended-upgrade-configuration-services-to-restart
|
||
(default '(mcron)))
|
||
(system-expiration unattended-upgrade-system-expiration
|
||
(default (* 3 30 24 3600)))
|
||
(maximum-duration unattended-upgrade-maximum-duration
|
||
(default 3600))
|
||
(log-file unattended-upgrade-configuration-log-file
|
||
(default %unattended-upgrade-log-file)))
|
||
|
||
(define %unattended-upgrade-log-file
|
||
"/var/log/unattended-upgrade.log")
|
||
|
||
(define (unattended-upgrade-mcron-jobs config)
|
||
(define channels
|
||
(scheme-file "channels.scm"
|
||
(unattended-upgrade-configuration-channels config)))
|
||
|
||
(define log
|
||
(unattended-upgrade-configuration-log-file config))
|
||
|
||
(define services
|
||
(unattended-upgrade-configuration-services-to-restart config))
|
||
|
||
(define expiration
|
||
(unattended-upgrade-system-expiration config))
|
||
|
||
(define config-file
|
||
(unattended-upgrade-operating-system-file config))
|
||
|
||
(define expression
|
||
(unattended-upgrade-operating-system-expression config))
|
||
|
||
(define arguments
|
||
(if expression
|
||
#~(list "-e" (object->string '#$expression))
|
||
#~(list #$config-file)))
|
||
|
||
(define code
|
||
(with-imported-modules (source-module-closure '((guix build utils)
|
||
(gnu services herd)))
|
||
#~(begin
|
||
(use-modules (guix build utils)
|
||
(gnu services herd)
|
||
(srfi srfi-19)
|
||
(srfi srfi-34))
|
||
|
||
(define log
|
||
(open-file #$log "a0"))
|
||
|
||
(define (timestamp)
|
||
(date->string (time-utc->date (current-time time-utc))
|
||
"[~4]"))
|
||
|
||
(define (alarm-handler . _)
|
||
(format #t "~a time is up, aborting upgrade~%"
|
||
(timestamp))
|
||
(exit 1))
|
||
|
||
;; 'guix time-machine' needs X.509 certificates to authenticate the
|
||
;; Git host.
|
||
(setenv "SSL_CERT_DIR"
|
||
#$(file-append nss-certs "/etc/ssl/certs"))
|
||
|
||
;; Make sure the upgrade doesn't take too long.
|
||
(sigaction SIGALRM alarm-handler)
|
||
(alarm #$(unattended-upgrade-maximum-duration config))
|
||
|
||
;; Redirect stdout/stderr to LOG to save the output of 'guix' below.
|
||
(redirect-port log (current-output-port))
|
||
(redirect-port log (current-error-port))
|
||
|
||
(format #t "~a starting upgrade...~%" (timestamp))
|
||
(guard (c ((invoke-error? c)
|
||
(report-invoke-error c)))
|
||
(apply invoke #$(file-append guix "/bin/guix")
|
||
"time-machine" "-C" #$channels
|
||
"--" "system" "reconfigure" #$arguments)
|
||
|
||
;; 'guix system delete-generations' fails when there's no
|
||
;; matching generation. Thus, catch 'invoke-error?'.
|
||
(guard (c ((invoke-error? c)
|
||
(report-invoke-error c)))
|
||
(invoke #$(file-append guix "/bin/guix")
|
||
"system" "delete-generations"
|
||
#$(string-append (number->string expiration)
|
||
"s")))
|
||
|
||
(format #t "~a restarting services...~%" (timestamp))
|
||
(for-each restart-service '#$services)
|
||
|
||
;; XXX: If 'mcron' has been restarted, perhaps this isn't
|
||
;; reached.
|
||
(format #t "~a upgrade complete~%" (timestamp))))))
|
||
|
||
(define upgrade
|
||
(program-file "unattended-upgrade" code))
|
||
|
||
(list #~(job #$(unattended-upgrade-configuration-schedule config)
|
||
#$upgrade)))
|
||
|
||
(define (unattended-upgrade-log-rotations config)
|
||
(list (log-rotation
|
||
(files
|
||
(list (unattended-upgrade-configuration-log-file config))))))
|
||
|
||
(define unattended-upgrade-service-type
|
||
(service-type
|
||
(name 'unattended-upgrade)
|
||
(extensions
|
||
(list (service-extension mcron-service-type
|
||
unattended-upgrade-mcron-jobs)
|
||
(service-extension rottlog-service-type
|
||
unattended-upgrade-log-rotations)))
|
||
(description
|
||
"Periodically upgrade the system from the current configuration.")
|
||
(default-value (unattended-upgrade-configuration))))
|
||
|
||
;;; admin.scm ends here
|