SystemD
SystemD integration for Crystal applications, can notify systemd, get socket listeners and store/restore file descriptors. libsystemd is only required for storing FDs.
Man pages:
https://man7.org/linux/man-pages/man3/sd_pid_notify.3.html https://man7.org/linux/man-pages/man3/sd_listen_fds.3.html
Installation
-
Add the dependency to your
shard.yml
:dependencies: systemd: github: 84codes/systemd.cr
-
Run
shards install
Usage
require "systemd"
# Notify SystemD when the application has started
SystemD.notify_ready
# Update the status
SystemD.notify_status("Accepting connections")
# Retrive store FDs
SystemD.named_listeners do |socket, name|
case name
when .ends_with?(".socket")
spawn do
while client = socket.accept?
spawn handle_client(client)
end
end
when "stored" # stored FD without name
@connections << socket
else
...
end
end
# Store FDs with the SystemD, they will be sent back
# to the application when it restarts. Requires libsystemd
clients = Array(TCPSocket).new
SystemD.store_fds(clients.map &.fd)
Contributing
- Fork it (https://github.com/84codes/systemd.cr/fork)
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Contributors
- Carl Hörberg - creator and maintainer