187 lines
4.0 KiB
Markdown
187 lines
4.0 KiB
Markdown
# unitdore
|
|
|
|
> *A door you open and close for container units.*
|
|
|
|
Unitdore bridges your container runtime (Podman, Docker) and systemd. It discovers running containers, stores them in a config file, and generates + manages systemd `.service` units for each one.
|
|
|
|
## Install
|
|
|
|
**Arch Linux (AUR)**
|
|
|
|
```bash
|
|
yay -S unitdore
|
|
```
|
|
|
|
**Debian / Ubuntu**
|
|
|
|
Download the `.deb` from the [releases page](https://git.warky.dev/wdevs/unitdore/releases) and install:
|
|
|
|
```bash
|
|
sudo dpkg -i unitdore_*.deb
|
|
```
|
|
|
|
**CentOS / AlmaLinux / Rocky Linux**
|
|
|
|
Download the `.rpm` from the [releases page](https://git.warky.dev/wdevs/unitdore/releases) and install:
|
|
|
|
```bash
|
|
sudo rpm -i unitdore-*.rpm
|
|
# or with dnf:
|
|
sudo dnf install unitdore-*.rpm
|
|
```
|
|
|
|
**From source**
|
|
|
|
```bash
|
|
make build
|
|
sudo make install
|
|
```
|
|
|
|
Or manually:
|
|
|
|
```bash
|
|
go build -o unitdore .
|
|
sudo cp unitdore /usr/local/bin/
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Discover running containers
|
|
|
|
```bash
|
|
sudo unitdore syncup
|
|
```
|
|
|
|
Queries Podman and Docker for running containers, adds new ones to the config, and reconciles any that have disappeared (marking them disabled).
|
|
|
|
### Edit the config
|
|
|
|
```bash
|
|
sudo unitdore edit
|
|
```
|
|
|
|
Opens `/etc/unitdore/units.yaml` in `$EDITOR` (falls back to `vi`).
|
|
|
|
### Install systemd unit files
|
|
|
|
```bash
|
|
sudo unitdore install
|
|
```
|
|
|
|
Generates `.service` files for all enabled units and writes them to systemd. Use `--dry-run` to preview without writing.
|
|
|
|
```bash
|
|
sudo unitdore install --dry-run
|
|
```
|
|
|
|
### Enable and start units
|
|
|
|
```bash
|
|
sudo unitdore active
|
|
```
|
|
|
|
Runs `systemctl enable --now` for all installed, enabled units in startup order.
|
|
|
|
### Check status
|
|
|
|
```bash
|
|
sudo unitdore status
|
|
```
|
|
|
|
Prints a summary table:
|
|
|
|
```
|
|
NAME RUNTIME USER ENABLED INSTALLED STATE REASON
|
|
nginx podman root yes yes active
|
|
myapp docker hein yes yes active
|
|
oldthing podman hein no no — container not found
|
|
```
|
|
|
|
## Config file
|
|
|
|
**Location:** `/etc/unitdore/units.yaml`
|
|
|
|
```yaml
|
|
prefix: "" # optional: prepended to all service names, e.g. "prod-"
|
|
suffix: "" # optional: appended to all service names, e.g. "-svc"
|
|
|
|
units:
|
|
- name: nginx
|
|
runtime: podman # podman | docker
|
|
user: "" # empty = root/system unit
|
|
command: "" # optional: override ExecStart entirely
|
|
order: 1 # startup order (lower = earlier)
|
|
delay: 0s # delay after previous order group
|
|
enabled: true
|
|
disabled_reason: "" # auto-set by syncup reconciliation
|
|
|
|
- name: myapp
|
|
runtime: docker
|
|
user: hein # rootless: generates user unit for this user
|
|
order: 2
|
|
delay: 5s
|
|
enabled: true
|
|
```
|
|
|
|
### Prefix and suffix
|
|
|
|
Set `prefix` and/or `suffix` to namespace your service files:
|
|
|
|
```yaml
|
|
prefix: prod-
|
|
suffix: ""
|
|
```
|
|
|
|
Generates: `unitdore-prod-nginx.service`, `unitdore-prod-myapp.service`, etc.
|
|
Prefix/suffix apply to the **service file name only** — container names are unchanged.
|
|
|
|
### Unnamed containers
|
|
|
|
If a container has no name, `syncup` uses its short container ID (first 12 chars) as the unit name.
|
|
You can rename it later with `unitdore edit`.
|
|
|
|
## Generated unit files
|
|
|
|
See **[docs/generated-units.md](docs/generated-units.md)** for full examples covering:
|
|
- System units (root)
|
|
- User units (rootless)
|
|
- Docker vs Podman
|
|
- Custom commands
|
|
- Prefix/suffix naming
|
|
- Startup ordering
|
|
- Unnamed containers (short ID fallback)
|
|
|
|
Quick example:
|
|
|
|
```ini
|
|
# /etc/systemd/system/unitdore-nginx.service
|
|
# Generated by unitdore — do not edit manually
|
|
|
|
[Unit]
|
|
Description=Unitdore: nginx (podman)
|
|
After=network.target
|
|
|
|
[Service]
|
|
Type=simple
|
|
ExecStart=/usr/bin/podman start -a nginx
|
|
ExecStop=/usr/bin/podman stop nginx
|
|
Restart=on-failure
|
|
RestartSec=5
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
## Flags
|
|
|
|
```
|
|
--config string path to units config file (default "/etc/unitdore/units.yaml")
|
|
```
|
|
|
|
## Requirements
|
|
|
|
- Go 1.21+
|
|
- systemd
|
|
- Podman and/or Docker (only what you have installed is used)
|
|
- Root for system units; the relevant user for rootless units
|