coreos-home-server/config/service/redis
Alex Palaistras a85ead28b6 Add basic, initial documentation on services
This includes initial coverage for Redis and MariaDB, and establishes a
template for future work. There's a lot of ground left to cover, however.
2021-12-19 14:14:12 +00:00
..
container/config Simplify systemd services, use volumes 2021-06-27 18:36:06 +01:00
systemd Update to latest CoreOS version 2021-09-08 18:45:04 +01:00
Containerfile Set generic Podman defaults and per-service log IDs 2021-08-28 22:27:54 +01:00
README.md Add basic, initial documentation on services 2021-12-19 14:14:12 +00:00
spec.bu Move from FCCT to Butane 2021-05-09 13:05:34 +01:00

Redis

This directory contains a simple systemd service for running a disk-backed instance of Redis.

Deployment

Including the spec.bu file here in your host configuration is enough to have Redis enabled on the system -- no other configuration is needed. The following commands will manage the service accordingly:

  • Starting Redis: sudo systemctl start redis
  • Stopping Redis: sudo systemctl stop redis
  • Getting logs for the running service: journalctl -feu redis

By default, Redis listens on the internal network under the redis hostname, port 6379. Any services that wish to connect to Redis for that hostname and port need to also be included in the internal network.

By default, a named volume is created for redis which is used for restoring databases on service restart.

Use

Depending on Redis from other systemd services is as simple as declaring an ordered dependency in the systemd service file, for example:

[Unit]
Description=Service That Uses Redis
Wants=container-build@example.service redis.service
After=container-build@example.service redis.service

Redis will then be guaranteed to be running before the example service is.