Compare commits
No commits in common. "master" and "routeros" have entirely different histories.
232 changed files with 1636 additions and 13849 deletions
4
.envrc
4
.envrc
|
|
@ -2,6 +2,6 @@
|
||||||
|
|
||||||
PATH_add bin
|
PATH_add bin
|
||||||
|
|
||||||
layout uv
|
source_env ~/.local/share/direnv/pyenv
|
||||||
|
source_env ~/.local/share/direnv/venv
|
||||||
source_env ~/.local/share/direnv/bundlewrap
|
source_env ~/.local/share/direnv/bundlewrap
|
||||||
|
|
|
||||||
5
.gitignore
vendored
5
.gitignore
vendored
|
|
@ -2,8 +2,3 @@
|
||||||
.venv
|
.venv
|
||||||
.cache
|
.cache
|
||||||
*.pyc
|
*.pyc
|
||||||
.bw_debug_history
|
|
||||||
# CocoIndex Code (ccc)
|
|
||||||
/.cocoindex_code/
|
|
||||||
# bundlewrap git_deploy local-mirror map (operator-specific paths)
|
|
||||||
git_deploy_repos
|
|
||||||
|
|
|
||||||
108
AGENTS.md
108
AGENTS.md
|
|
@ -1,108 +0,0 @@
|
||||||
# ckn-bw — agent & contributor guide
|
|
||||||
|
|
||||||
## What this repo is
|
|
||||||
|
|
||||||
A [BundleWrap](https://bundlewrap.org/) configuration-management repo
|
|
||||||
for ~22 personal/family-infra nodes. Nodes, groups, and bundles are
|
|
||||||
defined in plain Python; `bw apply` deploys the resulting state to
|
|
||||||
real machines.
|
|
||||||
|
|
||||||
Note: the root `README.md` is the maintainer's personal scratchpad,
|
|
||||||
not project documentation. Onboarding lives **here**, in `AGENTS.md`.
|
|
||||||
|
|
||||||
## Quickstart for agents
|
|
||||||
|
|
||||||
Five rules; follow these and you won't break things:
|
|
||||||
|
|
||||||
1. **Read-only by default.** Never run `bw apply`, `bw run`, or
|
|
||||||
`bw lock` without explicit user request — even with `-i`. Stick
|
|
||||||
to `bw test`, `bw nodes`, `bw groups`, `bw items`,
|
|
||||||
`bw metadata`, `bw hash`, `bw verify`, `bw debug`. See
|
|
||||||
[`docs/agents/commands.md`](docs/agents/commands.md) and the
|
|
||||||
fork's [safety envelope](https://github.com/CroneKorkN/bundlewrap/blob/main/AGENTS.md).
|
|
||||||
2. **Never echo decrypted secrets.** Don't print, paste, or log the
|
|
||||||
value behind a `!password_for:`, `!decrypt:`, or
|
|
||||||
`!32_random_bytes_as_base64_for:` magic string — not even from
|
|
||||||
`bw debug` exploration. See
|
|
||||||
[`conventions.md#secrets`](docs/agents/conventions.md#secrets).
|
|
||||||
3. **Don't touch the do-not-modify list.** `.secrets.cfg*`, `.venv`,
|
|
||||||
`.cache`, `.bw_debug_history`, root `README.md`. Treat
|
|
||||||
`hooks/` and `items/` (custom item types) with extra care: a
|
|
||||||
broken hook or item type breaks every `bw` command repo-wide.
|
|
||||||
4. **Use the fork.** Bundlewrap is pinned to the `main` branch of
|
|
||||||
[`github.com/CroneKorkN/bundlewrap`](https://github.com/CroneKorkN/bundlewrap)
|
|
||||||
via `[tool.uv.sources]` in `pyproject.toml`; `uv sync` (run by
|
|
||||||
direnv on entry) installs it. Behavior tracks the fork's `main`;
|
|
||||||
the fork's
|
|
||||||
[`AGENTS.md`](https://github.com/CroneKorkN/bundlewrap/blob/main/AGENTS.md)
|
|
||||||
is the canonical bundlewrap-language reference. See
|
|
||||||
[`conventions.md#bundlewrap-version`](docs/agents/conventions.md#bundlewrap-version).
|
|
||||||
5. **Prefer adding helpers to `libs/`** over duplicating logic across
|
|
||||||
bundles. Repo-wide helpers go in
|
|
||||||
[`libs/`](libs/AGENTS.md), reachable as `repo.libs.<x>`.
|
|
||||||
|
|
||||||
## Layout
|
|
||||||
|
|
||||||
| Dir | What's there |
|
|
||||||
|---|---|
|
|
||||||
| [`bundles/`](bundles/AGENTS.md) | 103 bundles. One subdir per bundle (`items.py`, `metadata.py`, `files/`). |
|
|
||||||
| [`nodes/`](nodes/AGENTS.md) | One file per node (~22). `eval()`-loaded; demagified through `repo.vault`. |
|
|
||||||
| [`groups/`](groups/AGENTS.md) | Group definitions, organized by axis (`applications/`, `locations/`, `machine/`, `os/`). |
|
|
||||||
| [`libs/`](libs/AGENTS.md) | Shared Python helpers reachable as `repo.libs.<modulename>`. |
|
|
||||||
| [`hooks/`](hooks/AGENTS.md) | bw lifecycle hooks (`apply_start`, `test`, `node_apply_start`, …). |
|
|
||||||
| [`data/`](data/AGENTS.md) | Out-of-bundle data assets (apt keys, grafana dashboards, …). |
|
|
||||||
| [`items/`](items/AGENTS.md) | Custom item types (currently `download:`). |
|
|
||||||
| [`bin/`](bin/AGENTS.md) | Operator scripts; not invoked by bundlewrap. |
|
|
||||||
| [`docs/agents/`](docs/agents/conventions.md) | Repo conventions and command deltas. |
|
|
||||||
|
|
||||||
## How nodes, groups, and bundles fit together
|
|
||||||
|
|
||||||
- A **node** (`nodes/<location>.<role>.py`) declares the groups it
|
|
||||||
belongs to and any node-local bundles + metadata overrides.
|
|
||||||
- A **group** (`groups/<axis>/<x>.py`) attaches bundles and shared
|
|
||||||
metadata to its members. Groups inherit via `supergroups`.
|
|
||||||
- A **bundle** (`bundles/<x>/`) is one chunk of configuration:
|
|
||||||
`items.py` produces the items (files, services, packages),
|
|
||||||
`metadata.py` declares `defaults` and `@metadata_reactor` functions
|
|
||||||
that derive metadata from other metadata.
|
|
||||||
- The repo-root loaders (`nodes.py`, `groups.py`) walk these dirs and
|
|
||||||
`eval()` each file. `nodes.py` additionally **demagifies** the
|
|
||||||
result, resolving `!password_for:` etc. through `repo.vault`. See
|
|
||||||
[`conventions.md#eval-loaded-node-and-group-files`](docs/agents/conventions.md#eval-loaded-node-and-group-files)
|
|
||||||
for the constraints this places on editors.
|
|
||||||
- Metadata merges along: `all → location → os → machine →
|
|
||||||
applications → node`.
|
|
||||||
|
|
||||||
## Conventions you must know
|
|
||||||
|
|
||||||
| Topic | Where |
|
|
||||||
|---|---|
|
|
||||||
| Bundlewrap-language reference (item types, dep keywords, reactors) | Fork's [`AGENTS.md`](https://github.com/CroneKorkN/bundlewrap/blob/main/AGENTS.md) — read first if new to bundlewrap |
|
|
||||||
| Vault / demagify magic strings | [`conventions.md#secrets`](docs/agents/conventions.md#secrets) |
|
|
||||||
| Bundlewrap install (uv-pinned to the fork's `main`) | [`conventions.md#bundlewrap-version`](docs/agents/conventions.md#bundlewrap-version) |
|
|
||||||
| Group inheritance order, naming patterns | [`conventions.md#group-inheritance-order`](docs/agents/conventions.md#group-inheritance-order), [`#naming-conventions`](docs/agents/conventions.md#naming-conventions) |
|
|
||||||
| Repo-specific bw command deltas (apt keys, suspended nodes, vault echo) | [`commands.md`](docs/agents/commands.md) |
|
|
||||||
| Lib helpers | top-of-file docstrings in `libs/*.py` (`head -1 libs/*.py`) |
|
|
||||||
| Suspension idioms (`*.py_`, `_old/`, "for now") | [`conventions.md#suspension-and-soft-delete-idioms`](docs/agents/conventions.md#suspension-and-soft-delete-idioms) |
|
|
||||||
|
|
||||||
## Where to look for examples
|
|
||||||
|
|
||||||
When writing a new bundle, copy patterns from one that already does
|
|
||||||
the thing you need:
|
|
||||||
|
|
||||||
| Pattern | Look at |
|
|
||||||
|---|---|
|
|
||||||
| Vault calls inside metadata reactors | `bundles/dm-crypt/metadata.py` (compact, focused) |
|
|
||||||
| Mako-templated files | `bundles/bind/items.py` (DNS zonefile rendering) |
|
|
||||||
| Cross-bundle reactor writing | `bundles/nextcloud/metadata.py` (writes into `apt.packages`, `archive.paths`) |
|
|
||||||
| Custom `download:` items | `bundles/minecraft/items.py` |
|
|
||||||
| Node file (single-purpose) | `nodes/home.server.py` |
|
|
||||||
| Group with `supergroups` chain | `groups/os/debian-13.py` |
|
|
||||||
|
|
||||||
## Where this doc lives
|
|
||||||
|
|
||||||
- This file: `AGENTS.md` at the repo root.
|
|
||||||
- `CLAUDE.md` is a symlink to this file — both names point to the same
|
|
||||||
content so different tools can find it.
|
|
||||||
- The personal TODO scratchpad (`README.md`) is **separate** and not
|
|
||||||
project documentation.
|
|
||||||
|
|
@ -1 +0,0 @@
|
||||||
AGENTS.md
|
|
||||||
|
|
@ -13,6 +13,10 @@ Raspberry pi as soundcard
|
||||||
- OTG g_audio
|
- OTG g_audio
|
||||||
- https://audiosciencereview.com/forum/index.php?threads/raspberry-pi-as-usb-to-i2s-adapter.8567/post-215824
|
- https://audiosciencereview.com/forum/index.php?threads/raspberry-pi-as-usb-to-i2s-adapter.8567/post-215824
|
||||||
|
|
||||||
|
# install bw fork
|
||||||
|
|
||||||
|
pip3 install --editable git+file:///Users/mwiegand/Projekte/bundlewrap-fork@main#egg=bundlewrap
|
||||||
|
|
||||||
# monitor timers
|
# monitor timers
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
|
|
|
||||||
|
|
@ -1,62 +0,0 @@
|
||||||
# bin/
|
|
||||||
|
|
||||||
## What's here
|
|
||||||
|
|
||||||
Operator scripts — invoked manually by the maintainer, **not** by
|
|
||||||
bundlewrap itself. Each is a standalone Python (or shell) script that
|
|
||||||
opens the repo via `Repository(dirname(dirname(realpath(__file__))))`.
|
|
||||||
|
|
||||||
Discovery is by `ls bin/` plus the `# purpose:` header line at the top
|
|
||||||
of each script:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
head -2 bin/*
|
|
||||||
```
|
|
||||||
|
|
||||||
## Conventions
|
|
||||||
|
|
||||||
- **`# purpose:` header.** Every script under `bin/` starts with
|
|
||||||
`#!/usr/bin/env python3` (or appropriate shebang), then a
|
|
||||||
`# purpose: <one-line description>` comment. Baseline enforced by
|
|
||||||
`grep -L '^# purpose' bin/*`.
|
|
||||||
- **Self-contained.** A script must work when run from anywhere — it
|
|
||||||
resolves the repo via the script's own path, not `cwd`.
|
|
||||||
- **Read-only by default.** Most operator scripts query/print state
|
|
||||||
(`passwords-for`, `wireguard-client-config`). Mutating scripts
|
|
||||||
(`upgrade_and_restart_all`, `mikrotik-firmware-updater`,
|
|
||||||
`sync_1password`) are the exception, not the rule, and prompt for
|
|
||||||
confirmation.
|
|
||||||
|
|
||||||
## How to add a script
|
|
||||||
|
|
||||||
1. Start from [`bin/script_template`](script_template) — it carries
|
|
||||||
the canonical shebang + `# purpose:` header + `Repository(...)`
|
|
||||||
bootstrap.
|
|
||||||
2. Add the `# purpose:` line; lowercase, terse, include a `usage:`
|
|
||||||
example if the script takes arguments.
|
|
||||||
3. `chmod +x bin/<name>`.
|
|
||||||
4. The script can reach helpers via `bw.libs.<x>` exactly like a
|
|
||||||
bundle does.
|
|
||||||
|
|
||||||
## Pitfalls
|
|
||||||
|
|
||||||
- **`bin/` is not on `$PATH` by default.** Invoke as `bin/<name>` from
|
|
||||||
the repo root, or via `direnv` if `.envrc` exposes it.
|
|
||||||
- **Mutating scripts can hit Tier-3 territory** (per the fork's
|
|
||||||
safety envelope). Don't run `upgrade_and_restart_all`,
|
|
||||||
`mikrotik-firmware-updater`, or anything that does `node.run(...)`
|
|
||||||
without explicit user instruction. See the fork's
|
|
||||||
[`AGENTS.md`](https://github.com/CroneKorkN/bundlewrap/blob/main/AGENTS.md)
|
|
||||||
for the three-tier model.
|
|
||||||
- **Vault echo.** Scripts like `passwords-for` print decrypted values
|
|
||||||
by design; that's allowed for the human at the terminal but *not*
|
|
||||||
for the agent — never paste output into chat, ticket, or PR
|
|
||||||
description.
|
|
||||||
|
|
||||||
## See also
|
|
||||||
|
|
||||||
- [`script_template`](script_template) — canonical starter.
|
|
||||||
- [`docs/agents/conventions.md`](../docs/agents/conventions.md) —
|
|
||||||
vault rules.
|
|
||||||
- [`docs/agents/commands.md`](../docs/agents/commands.md) — read-only
|
|
||||||
bw-command guidance.
|
|
||||||
|
|
@ -1,149 +0,0 @@
|
||||||
#!/usr/bin/env python3
|
|
||||||
# purpose: upgrade RouterOS and routerboard firmware on `bundle:routeros` (or any selector) — usage: mikrotik-firmware-updater [<selector>...] [--yes].
|
|
||||||
|
|
||||||
from argparse import ArgumentParser
|
|
||||||
from time import sleep
|
|
||||||
|
|
||||||
from bundlewrap.exceptions import RemoteException
|
|
||||||
from bundlewrap.utils.cmdline import get_target_nodes
|
|
||||||
from bundlewrap.utils.ui import io
|
|
||||||
from bundlewrap.repo import Repository
|
|
||||||
from os.path import realpath, dirname
|
|
||||||
|
|
||||||
|
|
||||||
# parse args
|
|
||||||
parser = ArgumentParser()
|
|
||||||
parser.add_argument("targets", nargs="*", default=['bundle:routeros'], help="bw nodes selector")
|
|
||||||
parser.add_argument("--yes", action="store_true", default=False, help="skip confirmation prompts")
|
|
||||||
args = parser.parse_args()
|
|
||||||
|
|
||||||
|
|
||||||
def wait_up(node):
|
|
||||||
sleep(5)
|
|
||||||
while True:
|
|
||||||
try:
|
|
||||||
node.run_routeros('/system/resource/print')
|
|
||||||
except RemoteException:
|
|
||||||
sleep(2)
|
|
||||||
continue
|
|
||||||
else:
|
|
||||||
io.debug(f"{node.name}: is up")
|
|
||||||
sleep(10)
|
|
||||||
return
|
|
||||||
|
|
||||||
|
|
||||||
def upgrade_switch_os(node):
|
|
||||||
# get versions for comparison
|
|
||||||
with io.job(f"{node.name}: checking OS version"):
|
|
||||||
response = node.run_routeros('/system/package/update/check-for-updates').raw[-1]
|
|
||||||
installed_os = bw.libs.version.Version(response['installed-version'])
|
|
||||||
latest_os = bw.libs.version.Version(response['latest-version'])
|
|
||||||
io.debug(f"{node.name}: installed: {installed_os} >= latest: {latest_os}")
|
|
||||||
|
|
||||||
# compare versions
|
|
||||||
if installed_os >= latest_os:
|
|
||||||
# os is up to date
|
|
||||||
io.stdout(f"{node.name}: os up to date ({installed_os})")
|
|
||||||
else:
|
|
||||||
# confirm os upgrade
|
|
||||||
if not args.yes and not io.ask(
|
|
||||||
f"{node.name}: upgrade os from {installed_os} to {latest_os}?", default=True
|
|
||||||
):
|
|
||||||
io.stdout(f"{node.name}: skipped by user")
|
|
||||||
return
|
|
||||||
|
|
||||||
# download os
|
|
||||||
with io.job(f"{node.name}: downloading OS"):
|
|
||||||
response = node.run_routeros('/system/package/update/download').raw[-1]
|
|
||||||
io.debug(f"{node.name}: OS upgrade download response: {response['status']}")
|
|
||||||
|
|
||||||
# install and wait for reboot
|
|
||||||
with io.job(f"{node.name}: upgrading OS"):
|
|
||||||
try:
|
|
||||||
response = node.run_routeros('/system/package/update/install').raw[-1]
|
|
||||||
except RemoteException:
|
|
||||||
pass
|
|
||||||
wait_up(node)
|
|
||||||
|
|
||||||
# verify new os version
|
|
||||||
with io.job(f"{node.name}: checking new OS version"):
|
|
||||||
new_os = bw.libs.version.Version(node.run_routeros('/system/package/update/check-for-updates').raw[-1]['installed-version'])
|
|
||||||
if new_os == latest_os:
|
|
||||||
io.stdout(f"{node.name}: OS successfully upgraded from {installed_os} to {new_os}")
|
|
||||||
else:
|
|
||||||
raise Exception(f"{node.name}: OS upgrade failed, expected {latest_os}, got {new_os}")
|
|
||||||
|
|
||||||
|
|
||||||
def upgrade_switch_firmware(node):
|
|
||||||
# get versions for comparison
|
|
||||||
with io.job(f"{node.name}: checking Firmware version"):
|
|
||||||
response = node.run_routeros('/system/routerboard/print').raw[-1]
|
|
||||||
current_firmware = bw.libs.version.Version(response['current-firmware'])
|
|
||||||
upgrade_firmware = bw.libs.version.Version(response['upgrade-firmware'])
|
|
||||||
io.debug(f"{node.name}: firmware installed: {current_firmware}, upgrade: {upgrade_firmware}")
|
|
||||||
|
|
||||||
# compare versions
|
|
||||||
if current_firmware >= upgrade_firmware:
|
|
||||||
# firmware is up to date
|
|
||||||
io.stdout(f"{node.name}: firmware is up to date ({current_firmware})")
|
|
||||||
else:
|
|
||||||
# confirm firmware upgrade
|
|
||||||
if not args.yes and not io.ask(
|
|
||||||
f"{node.name}: upgrade firmware from {current_firmware} to {upgrade_firmware}?", default=True
|
|
||||||
):
|
|
||||||
io.stdout(f"{node.name}: skipped by user")
|
|
||||||
return
|
|
||||||
|
|
||||||
# upgrade firmware
|
|
||||||
with io.job(f"{node.name}: upgrading Firmware"):
|
|
||||||
node.run_routeros('/system/routerboard/upgrade')
|
|
||||||
|
|
||||||
# reboot and wait
|
|
||||||
with io.job(f"{node.name}: rebooting"):
|
|
||||||
try:
|
|
||||||
node.run_routeros('/system/reboot')
|
|
||||||
except RemoteException:
|
|
||||||
pass
|
|
||||||
wait_up(node)
|
|
||||||
|
|
||||||
# verify firmware version
|
|
||||||
new_firmware = bw.libs.version.Version(node.run_routeros('/system/routerboard/print').raw[-1]['current-firmware'])
|
|
||||||
if new_firmware == upgrade_firmware:
|
|
||||||
io.stdout(f"{node.name}: firmware successfully upgraded from {current_firmware} to {new_firmware}")
|
|
||||||
else:
|
|
||||||
raise Exception(f"firmware upgrade failed, expected {upgrade_firmware}, got {new_firmware}")
|
|
||||||
|
|
||||||
|
|
||||||
def upgrade_switch(node):
|
|
||||||
with io.job(f"{node.name}: checking"):
|
|
||||||
# check if routeros
|
|
||||||
if node.os != 'routeros':
|
|
||||||
io.progress_advance(2)
|
|
||||||
io.stdout(f"{node.name}: skipped, unsupported os {node.os}")
|
|
||||||
return
|
|
||||||
|
|
||||||
# check switch reachability
|
|
||||||
try:
|
|
||||||
node.run_routeros('/system/resource/print')
|
|
||||||
except RemoteException as error:
|
|
||||||
io.progress_advance(2)
|
|
||||||
io.stdout(f"{node.name}: skipped, error {error}")
|
|
||||||
return
|
|
||||||
|
|
||||||
upgrade_switch_os(node)
|
|
||||||
io.progress_advance(1)
|
|
||||||
|
|
||||||
upgrade_switch_firmware(node)
|
|
||||||
io.progress_advance(1)
|
|
||||||
|
|
||||||
|
|
||||||
with io:
|
|
||||||
bw = Repository(dirname(dirname(realpath(__file__))))
|
|
||||||
|
|
||||||
nodes = get_target_nodes(bw, args.targets)
|
|
||||||
|
|
||||||
io.progress_set_total(len(nodes) * 2)
|
|
||||||
io.stdout(f"upgrading {len(nodes)} switches: {', '.join([node.name for node in sorted(nodes)])}")
|
|
||||||
|
|
||||||
for node in sorted(nodes):
|
|
||||||
upgrade_switch(node)
|
|
||||||
|
|
@ -1,23 +0,0 @@
|
||||||
#!/usr/bin/env python3
|
|
||||||
# purpose: print node.password and selected metadata-key passwords for one node — usage: passwords-for <node>.
|
|
||||||
|
|
||||||
from bundlewrap.repo import Repository
|
|
||||||
from os.path import realpath, dirname
|
|
||||||
|
|
||||||
import argparse
|
|
||||||
|
|
||||||
parser = argparse.ArgumentParser()
|
|
||||||
parser.add_argument('node', help='Node to generate passwords for')
|
|
||||||
args = parser.parse_args()
|
|
||||||
|
|
||||||
bw = Repository(dirname(dirname(realpath(__file__))))
|
|
||||||
node = bw.get_node(args.node)
|
|
||||||
|
|
||||||
if node.password:
|
|
||||||
print(f"password: {node.password}")
|
|
||||||
|
|
||||||
for metadata_key in sorted([
|
|
||||||
'users/root/password',
|
|
||||||
]):
|
|
||||||
if value := node.metadata.get(metadata_key, None):
|
|
||||||
print(f"{metadata_key}: {value}")
|
|
||||||
1
bin/rcon
1
bin/rcon
|
|
@ -1,5 +1,4 @@
|
||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# purpose: send an RCON command to a left4dead2 server defined in node metadata — usage: rcon (list) | rcon <server> <command>.
|
|
||||||
|
|
||||||
from sys import argv
|
from sys import argv
|
||||||
from os.path import realpath, dirname
|
from os.path import realpath, dirname
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,6 @@
|
||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# purpose: starter template for new operator scripts under bin/.
|
|
||||||
|
|
||||||
from bundlewrap.repo import Repository
|
from bundlewrap.repo import Repository
|
||||||
from os.path import realpath, dirname
|
from os.path import realpath, dirname
|
||||||
|
|
||||||
bw = Repository(dirname(dirname(realpath(__file__))))
|
repo = Repository(dirname(dirname(realpath(__file__))))
|
||||||
|
|
|
||||||
|
|
@ -1,133 +0,0 @@
|
||||||
#!/usr/bin/env python3
|
|
||||||
# purpose: upsert one 1Password login per `bundle:routeros` node, keyed on the bw node id.
|
|
||||||
|
|
||||||
from bundlewrap.repo import Repository
|
|
||||||
from os.path import realpath, dirname
|
|
||||||
|
|
||||||
import json
|
|
||||||
import os
|
|
||||||
import subprocess
|
|
||||||
from dataclasses import dataclass
|
|
||||||
from typing import Optional, List
|
|
||||||
|
|
||||||
bw = Repository(dirname(dirname(realpath(__file__))))
|
|
||||||
|
|
||||||
VAULT=bw.vault.decrypt('encrypt$gAAAAABpLgX_xxb5NmNCl3cgHM0JL65GT6PHVXO5gwly7IkmWoEgkCDSuAcSAkNFB8Tb4RdnTdpzVQEUL1XppTKVto_O7_b11GjATiyQYiSfiQ8KZkTKLvk=').value
|
|
||||||
BW_TAG = "bw"
|
|
||||||
BUNDLEWRAP_FIELD_LABEL = "bundlewrap node id"
|
|
||||||
|
|
||||||
|
|
||||||
@dataclass
|
|
||||||
class OpResult:
|
|
||||||
stdout: str
|
|
||||||
stderr: str
|
|
||||||
returncode: int
|
|
||||||
|
|
||||||
|
|
||||||
def main():
|
|
||||||
for node in bw.nodes_in_group('routeros'):
|
|
||||||
upsert_node_item(
|
|
||||||
node_name=node.name,
|
|
||||||
node_uuid=node.metadata.get('id'),
|
|
||||||
username=node.username,
|
|
||||||
password=node.password,
|
|
||||||
url=f'http://{node.hostname}',
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
def run_op(args):
|
|
||||||
proc = subprocess.run(
|
|
||||||
["op", "--vault", VAULT] + args,
|
|
||||||
env=os.environ.copy(),
|
|
||||||
capture_output=True,
|
|
||||||
text=True,
|
|
||||||
)
|
|
||||||
|
|
||||||
if proc.returncode != 0:
|
|
||||||
raise RuntimeError(
|
|
||||||
f"op {' '.join(args)} failed with code {proc.returncode}:\n"
|
|
||||||
f"STDOUT:\n{proc.stdout}\n\nSTDERR:\n{proc.stderr}"
|
|
||||||
)
|
|
||||||
|
|
||||||
return OpResult(stdout=proc.stdout, stderr=proc.stderr, returncode=proc.returncode)
|
|
||||||
|
|
||||||
|
|
||||||
def op_item_list_bw():
|
|
||||||
out = run_op([
|
|
||||||
"item", "list",
|
|
||||||
"--tags", BW_TAG,
|
|
||||||
"--format", "json",
|
|
||||||
])
|
|
||||||
stdout = out.stdout.strip()
|
|
||||||
return json.loads(stdout) if stdout else []
|
|
||||||
|
|
||||||
|
|
||||||
def op_item_get(item_id):
|
|
||||||
args = ["item", "get", item_id, "--format", "json"]
|
|
||||||
return json.loads(run_op(args).stdout)
|
|
||||||
|
|
||||||
|
|
||||||
def op_item_create(title, node_uuid, username, password, url):
|
|
||||||
print(f"creating {title}")
|
|
||||||
return json.loads(run_op([
|
|
||||||
"item", "create",
|
|
||||||
"--category", "LOGIN",
|
|
||||||
"--title", title,
|
|
||||||
"--tags", BW_TAG,
|
|
||||||
"--url", url,
|
|
||||||
"--format", "json",
|
|
||||||
f"username={username}",
|
|
||||||
f"password={password}",
|
|
||||||
f"{BUNDLEWRAP_FIELD_LABEL}[text]={node_uuid}",
|
|
||||||
]).stdout)
|
|
||||||
|
|
||||||
|
|
||||||
def op_item_edit(item_id, title, username, password, url):
|
|
||||||
print(f"updating {title}")
|
|
||||||
return json.loads(run_op([
|
|
||||||
"item", "edit",
|
|
||||||
item_id,
|
|
||||||
"--title", title,
|
|
||||||
"--url", url,
|
|
||||||
"--format", "json",
|
|
||||||
f"username={username}",
|
|
||||||
f"password={password}",
|
|
||||||
]).stdout)
|
|
||||||
|
|
||||||
|
|
||||||
def find_node_item_id(node_uuid):
|
|
||||||
for summary in op_item_list_bw():
|
|
||||||
item_id = summary.get("id")
|
|
||||||
if not item_id:
|
|
||||||
continue
|
|
||||||
|
|
||||||
item = op_item_get(item_id)
|
|
||||||
for field in item.get("fields") or []:
|
|
||||||
label = field.get("label")
|
|
||||||
value = field.get("value")
|
|
||||||
if label == BUNDLEWRAP_FIELD_LABEL and value == node_uuid:
|
|
||||||
return item_id
|
|
||||||
return None
|
|
||||||
|
|
||||||
|
|
||||||
def upsert_node_item(node_name, node_uuid, username, password, url):
|
|
||||||
if item_id := find_node_item_id(node_uuid):
|
|
||||||
return op_item_edit(
|
|
||||||
item_id=item_id,
|
|
||||||
title=node_name,
|
|
||||||
username=username,
|
|
||||||
password=password,
|
|
||||||
url=url,
|
|
||||||
)
|
|
||||||
else:
|
|
||||||
return op_item_create(
|
|
||||||
title=node_name,
|
|
||||||
node_uuid=node_uuid,
|
|
||||||
username=username,
|
|
||||||
password=password,
|
|
||||||
url=url,
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
main()
|
|
||||||
|
|
@ -1,217 +0,0 @@
|
||||||
#!/usr/bin/env python3
|
|
||||||
# purpose: add missing EXIF/QuickTime timestamps to photos in a directory using mdls + exiftool — usage: timestamp_icloud_photos_for_nextcloud -d <dir>.
|
|
||||||
|
|
||||||
from subprocess import check_output, CalledProcessError
|
|
||||||
from datetime import datetime, timedelta
|
|
||||||
from pathlib import Path
|
|
||||||
import json
|
|
||||||
from argparse import ArgumentParser
|
|
||||||
from concurrent.futures import ThreadPoolExecutor, as_completed
|
|
||||||
from os import cpu_count
|
|
||||||
from time import sleep
|
|
||||||
|
|
||||||
EXT_GROUPS = {
|
|
||||||
"quicktime": {".mp4", ".mov", ".heic", ".cr3"},
|
|
||||||
"exif": {".jpg", ".jpeg", ".cr2"},
|
|
||||||
}
|
|
||||||
DATETIME_KEYS = [
|
|
||||||
("Composite", "SubSecDateTimeOriginal"),
|
|
||||||
("Composite", "SubSecCreateDate"),
|
|
||||||
('ExifIFD', 'DateTimeOriginal'),
|
|
||||||
('ExifIFD', 'CreateDate'),
|
|
||||||
('XMP-xmp', 'CreateDate'),
|
|
||||||
('Keys', 'CreationDate'),
|
|
||||||
('QuickTime', 'CreateDate'),
|
|
||||||
('XMP-photoshop', 'DateCreated'),
|
|
||||||
]
|
|
||||||
|
|
||||||
def run(command):
|
|
||||||
return check_output(command, text=True).strip()
|
|
||||||
|
|
||||||
|
|
||||||
def mdls_timestamp(file):
|
|
||||||
for i in range(5): # retry a few times in case of transient mdls failures
|
|
||||||
try:
|
|
||||||
output = run(('mdls', '-raw', '-name', 'kMDItemContentCreationDate', file))
|
|
||||||
except CalledProcessError as e:
|
|
||||||
print(f"{file}: Error running mdls (attempt {i+1}/5): {e}")
|
|
||||||
continue
|
|
||||||
|
|
||||||
try:
|
|
||||||
return datetime.strptime(output, "%Y-%m-%d %H:%M:%S %z")
|
|
||||||
except ValueError as e:
|
|
||||||
print(f"{file}: Error parsing mdls output (attempt {i+1}/5): {e}")
|
|
||||||
continue
|
|
||||||
|
|
||||||
sleep(1)
|
|
||||||
|
|
||||||
raise RuntimeError(f"Failed to get mdls timestamp for {file} after 5 attempts")
|
|
||||||
|
|
||||||
|
|
||||||
def exiftool_data(file):
|
|
||||||
try:
|
|
||||||
output = run((
|
|
||||||
'exiftool',
|
|
||||||
'-j', # json
|
|
||||||
'-a', # unknown tags
|
|
||||||
'-u', # unknown values
|
|
||||||
'-g1', # group by category
|
|
||||||
'-time:all', # all time tags
|
|
||||||
'-api', 'QuickTimeUTC=1', # use UTC for QuickTime timestamps
|
|
||||||
'-d', '%Y-%m-%dT%H:%M:%S%z',
|
|
||||||
file,
|
|
||||||
))
|
|
||||||
except CalledProcessError as e:
|
|
||||||
print(f"Error running exiftool: {e}")
|
|
||||||
return None
|
|
||||||
else:
|
|
||||||
return json.loads(output)[0]
|
|
||||||
|
|
||||||
def exiftool_timestamp(file):
|
|
||||||
data = exiftool_data(file)
|
|
||||||
for category, key in DATETIME_KEYS:
|
|
||||||
try:
|
|
||||||
value = data[category][key]
|
|
||||||
return category, key, datetime.strptime(value, '%Y-%m-%dT%H:%M:%S%z')
|
|
||||||
except (TypeError, KeyError, ValueError) as e:
|
|
||||||
continue
|
|
||||||
print(f"⚠️ {file}: No timestamp found in exiftool: " + json.dumps(data, indent=2))
|
|
||||||
return None, None, None
|
|
||||||
|
|
||||||
|
|
||||||
def photo_has_embedded_timestamp(file):
|
|
||||||
mdls_ts = mdls_timestamp(file)
|
|
||||||
category, key, exiftool_ts = exiftool_timestamp(file)
|
|
||||||
|
|
||||||
if not exiftool_ts:
|
|
||||||
print(f"⚠️ {file}: No timestamp found in exiftool")
|
|
||||||
return False
|
|
||||||
|
|
||||||
# normalize timezone for comparison
|
|
||||||
exiftool_ts = exiftool_ts.astimezone(mdls_ts.tzinfo)
|
|
||||||
delta = abs(mdls_ts - exiftool_ts)
|
|
||||||
|
|
||||||
if delta < timedelta(hours=1): # allow for small differences
|
|
||||||
print(f"✅ {file}: {mdls_ts.isoformat()} (#{category}:{key})")
|
|
||||||
return True
|
|
||||||
else:
|
|
||||||
print(f"⚠️ {file}: {mdls_ts.isoformat()} != {exiftool_ts} (Δ={delta})")
|
|
||||||
return False
|
|
||||||
|
|
||||||
|
|
||||||
def photos_without_embedded_timestamps(directory):
|
|
||||||
executor = ThreadPoolExecutor(max_workers=cpu_count()//2)
|
|
||||||
try:
|
|
||||||
futures = {
|
|
||||||
executor.submit(photo_has_embedded_timestamp, file): file
|
|
||||||
for file in directory.iterdir()
|
|
||||||
if file.is_file()
|
|
||||||
if file.suffix.lower() not in {".aae"}
|
|
||||||
if not file.name.startswith('.')
|
|
||||||
}
|
|
||||||
|
|
||||||
for future in as_completed(futures):
|
|
||||||
file = futures[future]
|
|
||||||
has_ts = future.result() # raises immediately on first failed future
|
|
||||||
|
|
||||||
if has_ts:
|
|
||||||
file.rename(file.parent / 'ok' / file.name)
|
|
||||||
else:
|
|
||||||
yield file
|
|
||||||
|
|
||||||
except Exception:
|
|
||||||
executor.shutdown(wait=False, cancel_futures=True)
|
|
||||||
raise
|
|
||||||
else:
|
|
||||||
executor.shutdown(wait=True)
|
|
||||||
|
|
||||||
|
|
||||||
def exiftool_write(file, assignments):
|
|
||||||
print(f"🔵 {file}: Writing -- {assignments}")
|
|
||||||
return run((
|
|
||||||
"exiftool", "-overwrite_original",
|
|
||||||
"-api", "QuickTimeUTC=1",
|
|
||||||
*[
|
|
||||||
f"-{group}:{tag}={value}"
|
|
||||||
for group, tag, value in assignments
|
|
||||||
],
|
|
||||||
str(file),
|
|
||||||
))
|
|
||||||
|
|
||||||
|
|
||||||
def add_missing_timestamp(file):
|
|
||||||
data = exiftool_data(file)
|
|
||||||
mdls_ts = mdls_timestamp(file)
|
|
||||||
|
|
||||||
offset = mdls_ts.strftime("%z")
|
|
||||||
offset = f"{offset[:3]}:{offset[3:]}" if len(offset) == 5 else offset
|
|
||||||
|
|
||||||
exif_ts = mdls_ts.strftime("%Y:%m:%d %H:%M:%S")
|
|
||||||
qt_ts = mdls_ts.strftime("%Y:%m:%d %H:%M:%S")
|
|
||||||
qt_ts_tz = f"{qt_ts}{offset}"
|
|
||||||
ext = file.suffix.lower()
|
|
||||||
|
|
||||||
try:
|
|
||||||
if ext in {".heic"}:
|
|
||||||
exiftool_write(file, [
|
|
||||||
("ExifIFD", "DateTimeOriginal", qt_ts),
|
|
||||||
("ExifIFD", "CreateDate", qt_ts),
|
|
||||||
("ExifIFD", "OffsetTime", offset),
|
|
||||||
("ExifIFD", "OffsetTimeOriginal", offset),
|
|
||||||
("ExifIFD", "OffsetTimeDigitized", offset),
|
|
||||||
("QuickTime", "CreateDate", qt_ts_tz),
|
|
||||||
("Keys", "CreationDate", qt_ts_tz),
|
|
||||||
("XMP-xmp", "CreateDate", qt_ts_tz),
|
|
||||||
])
|
|
||||||
elif "QuickTime" in data or ext in {".mp4", ".mov", ".heic", ".cr3"}:
|
|
||||||
exiftool_write(file, [
|
|
||||||
("QuickTime", "CreateDate", qt_ts_tz),
|
|
||||||
("Keys", "CreationDate", qt_ts_tz),
|
|
||||||
])
|
|
||||||
elif "ExifIFD" in data or ext in {".jpg", ".jpeg", ".cr2", ".webp"}:
|
|
||||||
exiftool_write(file, [
|
|
||||||
("ExifIFD", "DateTimeOriginal", exif_ts),
|
|
||||||
("ExifIFD", "CreateDate", exif_ts),
|
|
||||||
("IFD0", "ModifyDate", exif_ts),
|
|
||||||
("ExifIFD", "OffsetTime", offset),
|
|
||||||
("ExifIFD", "OffsetTimeOriginal", offset),
|
|
||||||
("ExifIFD", "OffsetTimeDigitized", offset),
|
|
||||||
])
|
|
||||||
elif ext in {".png", ".gif", ".avif"}:
|
|
||||||
exiftool_write(file, [
|
|
||||||
("XMP-xmp", "CreateDate", qt_ts_tz),
|
|
||||||
("XMP-photoshop", "DateCreated", exif_ts),
|
|
||||||
])
|
|
||||||
else:
|
|
||||||
print(f"❌ {file}: unsupported type, skipped")
|
|
||||||
return
|
|
||||||
|
|
||||||
if photo_has_embedded_timestamp(file):
|
|
||||||
print(f"✅ {file}: Timestamp successfully added: {mdls_ts.isoformat()}")
|
|
||||||
file.rename(file.parent / 'processed' / file.name)
|
|
||||||
return
|
|
||||||
else:
|
|
||||||
category, key, exiftool_ts = exiftool_timestamp(file)
|
|
||||||
print(f"❌ {file}: Timestamp still wrong/missing after write '{category}:{key}:{exiftool_ts}': #{json.dumps(data, indent=4)}")
|
|
||||||
return
|
|
||||||
except CalledProcessError as e:
|
|
||||||
print(f"❌ {file}: Failed to write timestamp: {e}")
|
|
||||||
return
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
parser = ArgumentParser(description="Print timestamps of photos in the current directory.")
|
|
||||||
parser.add_argument("-d", "--directory", help="Directory to scan for photos")
|
|
||||||
args = parser.parse_args()
|
|
||||||
|
|
||||||
directory = Path(args.directory)
|
|
||||||
(directory/'ok').mkdir(exist_ok=True)
|
|
||||||
(directory/'processed').mkdir(exist_ok=True)
|
|
||||||
|
|
||||||
_photos_without_embedded_timestamps = list(photos_without_embedded_timestamps(directory))
|
|
||||||
print(f"{len(_photos_without_embedded_timestamps)} photos without embedded timestamps found.")
|
|
||||||
print("Press Enter to add missing timestamps...")
|
|
||||||
input()
|
|
||||||
|
|
||||||
for file in _photos_without_embedded_timestamps:
|
|
||||||
add_missing_timestamp(file)
|
|
||||||
|
|
@ -1,5 +1,4 @@
|
||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# purpose: apt-update and full-upgrade every non-dummy debian node, then reboot in WireGuard-aware order.
|
|
||||||
|
|
||||||
from bundlewrap.repo import Repository
|
from bundlewrap.repo import Repository
|
||||||
from os.path import realpath, dirname
|
from os.path import realpath, dirname
|
||||||
|
|
|
||||||
1
bin/wake
1
bin/wake
|
|
@ -1,5 +1,4 @@
|
||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# purpose: wake one node via WoL by name — usage: wake <node>.
|
|
||||||
|
|
||||||
from bundlewrap.repo import Repository
|
from bundlewrap.repo import Repository
|
||||||
from os.path import realpath, dirname
|
from os.path import realpath, dirname
|
||||||
|
|
|
||||||
|
|
@ -1,25 +1,23 @@
|
||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# purpose: print or QR-render a WireGuard client config from htz.mails metadata — usage: wireguard-client-config <client>.
|
|
||||||
|
|
||||||
from bundlewrap.repo import Repository
|
from bundlewrap.repo import Repository
|
||||||
from os.path import realpath, dirname
|
from os.path import realpath, dirname
|
||||||
from sys import argv
|
from sys import argv
|
||||||
from ipaddress import ip_network, ip_interface
|
from ipaddress import ip_network, ip_interface
|
||||||
import argparse
|
|
||||||
|
|
||||||
|
if len(argv) != 3:
|
||||||
|
print(f'usage: {argv[0]} <node> <client>')
|
||||||
|
exit(1)
|
||||||
|
|
||||||
# get info from repo
|
|
||||||
repo = Repository(dirname(dirname(realpath(__file__))))
|
repo = Repository(dirname(dirname(realpath(__file__))))
|
||||||
server_node = repo.get_node('htz.mails')
|
server_node = repo.get_node(argv[1])
|
||||||
available_clients = server_node.metadata.get('wireguard/clients').keys()
|
|
||||||
|
|
||||||
# parse args
|
if argv[2] not in server_node.metadata.get('wireguard/clients'):
|
||||||
parser = argparse.ArgumentParser(description='Generate WireGuard client configuration.')
|
print(f'client {argv[2]} not found in: {server_node.metadata.get("wireguard/clients").keys()}')
|
||||||
parser.add_argument('client', choices=available_clients, help='The client name to generate the configuration for.')
|
exit(1)
|
||||||
args = parser.parse_args()
|
|
||||||
|
data = server_node.metadata.get(f'wireguard/clients/{argv[2]}')
|
||||||
|
|
||||||
# get cert
|
|
||||||
data = server_node.metadata.get(f'wireguard/clients/{args.client}')
|
|
||||||
vpn_network = ip_interface(server_node.metadata.get('wireguard/my_ip')).network
|
vpn_network = ip_interface(server_node.metadata.get('wireguard/my_ip')).network
|
||||||
allowed_ips = [
|
allowed_ips = [
|
||||||
vpn_network,
|
vpn_network,
|
||||||
|
|
@ -45,15 +43,10 @@ Endpoint = {ip_interface(server_node.metadata.get('network/external/ipv4')).ip}:
|
||||||
PersistentKeepalive = 10
|
PersistentKeepalive = 10
|
||||||
'''
|
'''
|
||||||
|
|
||||||
answer = input("print config or qrcode? [Cq]: ").strip().upper()
|
print('>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>')
|
||||||
match answer:
|
print(conf)
|
||||||
case '' | 'C':
|
print('<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<')
|
||||||
print('>>>>>>>>>>>>>>>')
|
|
||||||
print(conf)
|
if input("print qrcode? [Yn]: ").upper() in ['', 'Y']:
|
||||||
print('<<<<<<<<<<<<<<<')
|
import pyqrcode
|
||||||
case 'Q':
|
print(pyqrcode.create(conf).terminal(quiet_zone=1))
|
||||||
import pyqrcode
|
|
||||||
print(pyqrcode.create(conf).terminal(quiet_zone=1))
|
|
||||||
case _:
|
|
||||||
print(f'Invalid option "{answer}".')
|
|
||||||
exit(1)
|
|
||||||
|
|
@ -1,204 +0,0 @@
|
||||||
# bundles/
|
|
||||||
|
|
||||||
## Before you start
|
|
||||||
|
|
||||||
Read [`docs/agents/conventions.md`](../docs/agents/conventions.md) first
|
|
||||||
— it covers vault calls, demagify, the `repo.libs.<x>` helpers, and the
|
|
||||||
files agents must not modify. Skipping it leads to subtly broken bundles
|
|
||||||
(vault calls in the wrong place, dict-in-set `TypeError` because of
|
|
||||||
unhashable nesting, etc.).
|
|
||||||
|
|
||||||
For bundlewrap-language reference (item types, dep keywords,
|
|
||||||
`metadata_reactor`, `defaults`, item-file template syntax) see the fork's
|
|
||||||
[`AGENTS.md`](https://github.com/CroneKorkN/bundlewrap/blob/main/AGENTS.md)
|
|
||||||
and its [`docs/content/guide/item_file_templates.md`](https://github.com/CroneKorkN/bundlewrap/blob/main/docs/content/guide/item_file_templates.md).
|
|
||||||
|
|
||||||
## What's here
|
|
||||||
|
|
||||||
103 bundles. Each is a directory `bundles/<name>/` containing some of:
|
|
||||||
|
|
||||||
```
|
|
||||||
bundles/<name>/
|
|
||||||
├── items.py # the items this bundle creates (files, services, packages, …)
|
|
||||||
├── metadata.py # `defaults` + `@metadata_reactor` functions
|
|
||||||
├── files/ # static or templated file payloads referenced from items.py
|
|
||||||
└── README.md # one doc per bundle, for humans and agents (see "Per-bundle README" below)
|
|
||||||
```
|
|
||||||
|
|
||||||
## Conventions
|
|
||||||
|
|
||||||
- **Bundle names** are lowercase, hyphen-separated: `backup-server`,
|
|
||||||
`bind-acme`, `dm-crypt`. No underscores in new bundle names — see
|
|
||||||
[`conventions.md#naming-conventions`](../docs/agents/conventions.md#naming-conventions).
|
|
||||||
- **`items.py`** is plain Python; it produces `files = {...}`,
|
|
||||||
`pkg_apt = {...}`, `svc_systemd = {...}`, etc. dicts at module scope.
|
|
||||||
Cross-item dependencies use `needs` / `triggers` / `triggered_by` —
|
|
||||||
see the fork's `AGENTS.md` for the full keyword cheat sheet.
|
|
||||||
- **`metadata.py`** uses `defaults = {...}` for static seed values and
|
|
||||||
`@metadata_reactor.provides(...)` for derived values. Reactors are
|
|
||||||
pure functions of `(metadata,)` — no side effects, no I/O.
|
|
||||||
- **Helpers go in [`libs/`](../libs/AGENTS.md)** when they're useful to
|
|
||||||
more than one bundle. Don't duplicate logic across bundles.
|
|
||||||
- **Custom item types** (e.g. `download:`) live in
|
|
||||||
[`items/`](../items/AGENTS.md), not per-bundle.
|
|
||||||
- **Bundles own application-wide knowledge; nodes carry only the few
|
|
||||||
per-host knobs the bundle actually needs.** When designing a bundle,
|
|
||||||
identify the per-node knobs (e.g. domain, uplink interface, a
|
|
||||||
vault-id suffix) and put everything else in `defaults`, or in a
|
|
||||||
reactor that derives from those knobs. Per-node random secrets
|
|
||||||
belong in `defaults` via `repo.vault.random_bytes_as_base64_for(...)`
|
|
||||||
keyed on the node — not in the node file. See
|
|
||||||
`bundles/left4me/metadata.py:10` (`secret_key` derived in defaults)
|
|
||||||
and `bundles/postgresql/metadata.py:4` (vault-derived `password_for`
|
|
||||||
at module scope).
|
|
||||||
|
|
||||||
## How to add a new bundle
|
|
||||||
|
|
||||||
1. `mkdir bundles/<name>/` (lowercase, hyphenated).
|
|
||||||
2. Write `items.py` and (if anything is configurable) `metadata.py`.
|
|
||||||
Use `repo.libs.hashable.hashable(...)` when you need to nest a dict
|
|
||||||
or set inside a metadata set; raw dicts/sets aren't hashable.
|
|
||||||
3. Drop static payloads into `bundles/<name>/files/`. For Mako-templated
|
|
||||||
files, declare `'content_type': 'mako'` on the `file:` item — see
|
|
||||||
the fork's
|
|
||||||
[item-file-templates guide](https://github.com/CroneKorkN/bundlewrap/blob/main/docs/content/guide/item_file_templates.md).
|
|
||||||
4. **Wire to nodes.** Either add an entry to the relevant
|
|
||||||
[`groups/<axis>/<x>.py`](../groups/AGENTS.md) (preferred for shared
|
|
||||||
bundles) or to the node's `bundles` list directly
|
|
||||||
([`nodes/AGENTS.md`](../nodes/AGENTS.md)).
|
|
||||||
5. **Verify, in this order:**
|
|
||||||
- `bw test` — repo-wide parse + cross-cutting hooks. Loads every
|
|
||||||
bundle, but reactors don't fire for nodes that haven't opted into
|
|
||||||
the bundle yet — bugs in new reactors stay hidden here.
|
|
||||||
- **Attach the bundle to a node** (via the node's `bundles` list, or
|
|
||||||
a group it belongs to). Until you do, the next steps don't actually
|
|
||||||
exercise the bundle.
|
|
||||||
- `bw test <node>` — exercises every reactor and item-graph edge for
|
|
||||||
that node. This is where most new-bundle bugs surface.
|
|
||||||
- `bw items <node> --blame` — confirm items materialise with the
|
|
||||||
right paths, authored by the expected bundle.
|
|
||||||
- `bw metadata <node> -k <a/b>` — spot-check derived metadata.
|
|
||||||
- `bw hash <node>` — preview vs current host state.
|
|
||||||
|
|
||||||
See [`docs/agents/commands.md#bundle-validation-workflow`](../docs/agents/commands.md#bundle-validation-workflow)
|
|
||||||
for the rationale.
|
|
||||||
6. Add a `bundles/<name>/README.md`. See "Per-bundle README" below
|
|
||||||
for what to cover.
|
|
||||||
|
|
||||||
## How to remove a bundle
|
|
||||||
|
|
||||||
1. `git grep '<name>'` in `nodes/`, `groups/`, and other `bundles/` to
|
|
||||||
find references.
|
|
||||||
2. Remove those references.
|
|
||||||
3. `rm -rf bundles/<name>/`.
|
|
||||||
4. `bw test` and `bw nodes` to confirm clean.
|
|
||||||
|
|
||||||
## Pitfalls
|
|
||||||
|
|
||||||
- **`metadata.py` is evaluated at load time** for *every* node, every
|
|
||||||
invocation of `bw`. Heavy work or I/O slows the whole repo. Keep
|
|
||||||
reactors pure and fast; pre-compute in `libs/` if you must.
|
|
||||||
- **Static files vs templates.** `bundles/<x>/files/<f>` is static
|
|
||||||
unless the matching `file:` item declares `content_type='mako'`
|
|
||||||
(or a templating extension triggers it). To check, read the matching
|
|
||||||
`file:` entry in `items.py`.
|
|
||||||
- **`file:` `source` defaults to the destination basename.** For a
|
|
||||||
destination of `/etc/foo/bar.conf` with no `source` key, bw looks
|
|
||||||
for `bundles/<bundle>/files/bar.conf`. Only declare `source`
|
|
||||||
explicitly when the basename you want differs (e.g. shipping a Mako
|
|
||||||
template named `bar.conf.mako` to a destination of
|
|
||||||
`/etc/foo/bar.conf`).
|
|
||||||
- **Reactors writing across namespaces.** Some bundles' reactors write
|
|
||||||
into other bundles' metadata namespaces (e.g. `nextcloud` writes
|
|
||||||
into `apt.packages`, `archive.paths`). When you change such a bundle,
|
|
||||||
every consumer's metadata changes too. The bundle's `README.md`
|
|
||||||
often calls these out — but the authoritative source is `metadata.py`
|
|
||||||
itself; grep `'<other-bundle>':` in the reactors when in doubt.
|
|
||||||
- **`bw hash` doesn't accept selectors.** Use `bw hash <node>` per
|
|
||||||
literal name; see the fork's runbook.
|
|
||||||
- **Reactors must read metadata.** If a reactor body returns a static
|
|
||||||
dict without calling `metadata.get(...)`, bw raises
|
|
||||||
`ValueError: <reactor> on <node> did not request any metadata, you
|
|
||||||
might want to use defaults instead` once a node consumes the bundle.
|
|
||||||
Fix: fold the contribution into `defaults`. The rule applies even
|
|
||||||
when the reactor writes into another bundle's namespace — a static
|
|
||||||
contribution to e.g. `nftables/output` belongs in `defaults`, where
|
|
||||||
bw merges it with other bundles' contributions.
|
|
||||||
- **`triggers` ↔ `triggered: True` invariant.** Any item listed in
|
|
||||||
another's `triggers` list must declare `triggered: True`. bw
|
|
||||||
enforces this at `bw test` time: *"…triggered by …, but missing
|
|
||||||
'triggered' attribute"*. Corollary: an action can't be both in an
|
|
||||||
upstream `triggers` list AND self-healing every apply — pick one.
|
|
||||||
- **Triggered actions don't recover from partial failure.** When an
|
|
||||||
upstream item's apply succeeds but its triggered downstream action
|
|
||||||
fails, subsequent applies can't recover via the trigger chain —
|
|
||||||
upstream is "already in desired state" and never re-triggers. For
|
|
||||||
actions that must self-heal (pip installs, chowns, migrations),
|
|
||||||
drop `triggered: True` and gate the command with `unless: <fast-check>`.
|
|
||||||
`unless` is a shell command on the target host whose exit status
|
|
||||||
decides whether the main command runs (exit 0 = skip); it's checked
|
|
||||||
at fire time, after `triggered:` filtering.
|
|
||||||
|
|
||||||
## Per-bundle README
|
|
||||||
|
|
||||||
Each bundle has (or should have) a `README.md`. One doc per bundle,
|
|
||||||
written for humans and agents both. There's no fixed structure —
|
|
||||||
match the bundle's actual surface, write what helps a future reader
|
|
||||||
(or future you) avoid trial-and-error.
|
|
||||||
|
|
||||||
The existing READMEs vary in quality and shape. For orientation,
|
|
||||||
look at the bigger ones, not the two-line ones:
|
|
||||||
|
|
||||||
- [`bundles/flask/README.md`](flask/README.md) — title + one-sentence
|
|
||||||
purpose, a metadata example as a Python dict, then the contract
|
|
||||||
the consuming git repo has to satisfy + a logging pitfall. The
|
|
||||||
closest thing to a "balanced doc" in tree.
|
|
||||||
- [`bundles/dm-crypt/README.md`](dm-crypt/README.md) — same shape,
|
|
||||||
shorter: purpose + metadata example + one sentence on effect.
|
|
||||||
- [`bundles/apt/README.md`](apt/README.md) — relevant upstream URLs
|
|
||||||
at the top, then a Python metadata example with rich inline
|
|
||||||
comments (type / optionality / where keys come from).
|
|
||||||
- [`bundles/nextcloud/README.md`](nextcloud/README.md) — operational
|
|
||||||
scratchpad: iPhone-import recipe, preview-generator commands,
|
|
||||||
reset queries. Captures muscle-memory the maintainer would
|
|
||||||
otherwise re-learn each time.
|
|
||||||
|
|
||||||
Useful things to include, when relevant:
|
|
||||||
|
|
||||||
- A sentence or two on what the bundle does and when you'd attach it.
|
|
||||||
- A metadata example as a Python dict literal, with `#` comments
|
|
||||||
on each key (type, required vs default, units, where it comes
|
|
||||||
from). This is the cleanest way to communicate the schema and
|
|
||||||
matches how `metadata.py` actually looks.
|
|
||||||
- Anything non-obvious about wiring it up — required keys without
|
|
||||||
defaults, group-membership expectations, manual one-time steps.
|
|
||||||
- Cross-namespace metadata writes, when this bundle's reactors
|
|
||||||
populate another bundle's namespace. Easy to miss, cheap to flag.
|
|
||||||
- Gotchas, debug recipes, failure modes you've actually hit.
|
|
||||||
|
|
||||||
What to skip:
|
|
||||||
|
|
||||||
- An exhaustive item list — `items.py` is shorter and more accurate.
|
|
||||||
- Anything that would just rot — version numbers, "TODO" lists,
|
|
||||||
change notes. Use git history.
|
|
||||||
|
|
||||||
If a single paragraph is enough to say what's worth saying, write a
|
|
||||||
single paragraph. Verbosity isn't a goal.
|
|
||||||
|
|
||||||
Convention going forward is leave-as-you-go: any time you materially
|
|
||||||
edit a bundle, top up its README (or write one if it's missing).
|
|
||||||
Don't burn a session bulk-reformatting the existing ones — uneven
|
|
||||||
quality is part of what we accept in exchange for not blocking other
|
|
||||||
work.
|
|
||||||
|
|
||||||
## See also
|
|
||||||
|
|
||||||
- [`docs/agents/conventions.md`](../docs/agents/conventions.md) — repo
|
|
||||||
idioms (vault, demagify, naming, do-not-touch list).
|
|
||||||
- [`docs/agents/commands.md`](../docs/agents/commands.md) — repo-specific
|
|
||||||
command deltas.
|
|
||||||
- [`items/AGENTS.md`](../items/AGENTS.md) — custom item types
|
|
||||||
(`download:`); when to write a new one vs use `file:`.
|
|
||||||
- [`libs/AGENTS.md`](../libs/AGENTS.md) — shared helpers.
|
|
||||||
- Fork's [`AGENTS.md`](https://github.com/CroneKorkN/bundlewrap/blob/main/AGENTS.md)
|
|
||||||
— bundlewrap-language reference + safety envelope.
|
|
||||||
|
|
@ -13,14 +13,16 @@ defaults = {
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'telegraf': {
|
'telegraf': {
|
||||||
'inputs': {
|
'config': {
|
||||||
'exec': {
|
'inputs': {
|
||||||
'apcupsd': {
|
'exec': {
|
||||||
'commands': ["sudo /usr/local/share/telegraf/apcupsd"],
|
repo.libs.hashable.hashable({
|
||||||
'name_override': "apcupsd",
|
'commands': ["sudo /usr/local/share/telegraf/apcupsd"],
|
||||||
'data_format': "influx",
|
'name_override': "apcupsd",
|
||||||
'interval': '30s',
|
'data_format': "influx",
|
||||||
'flush_interval': '30s',
|
'interval': '30s',
|
||||||
|
'flush_interval': '30s',
|
||||||
|
}),
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -4,8 +4,6 @@ defaults = {
|
||||||
'apt-listchanges': {
|
'apt-listchanges': {
|
||||||
'installed': False,
|
'installed': False,
|
||||||
},
|
},
|
||||||
'ca-certificates': {},
|
|
||||||
'unattended-upgrades': {},
|
|
||||||
},
|
},
|
||||||
'config': {
|
'config': {
|
||||||
'DPkg': {
|
'DPkg': {
|
||||||
|
|
@ -23,10 +21,6 @@ defaults = {
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'APT': {
|
'APT': {
|
||||||
'Periodic': {
|
|
||||||
'Update-Package-Lists': '1',
|
|
||||||
'Unattended-Upgrade': '1',
|
|
||||||
},
|
|
||||||
'NeverAutoRemove': {
|
'NeverAutoRemove': {
|
||||||
'^firmware-linux.*',
|
'^firmware-linux.*',
|
||||||
'^linux-firmware$',
|
'^linux-firmware$',
|
||||||
|
|
@ -54,11 +48,6 @@ defaults = {
|
||||||
'Error-Mode': 'any',
|
'Error-Mode': 'any',
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'Unattended-Upgrade': {
|
|
||||||
'Origins-Pattern': {
|
|
||||||
"origin=*",
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
},
|
||||||
'sources': {},
|
'sources': {},
|
||||||
},
|
},
|
||||||
|
|
@ -117,6 +106,33 @@ def signed_by(metadata):
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@metadata_reactor.provides(
|
||||||
|
'apt/config',
|
||||||
|
'apt/packages',
|
||||||
|
)
|
||||||
|
def unattended_upgrades(metadata):
|
||||||
|
return {
|
||||||
|
'apt': {
|
||||||
|
'config': {
|
||||||
|
'APT': {
|
||||||
|
'Periodic': {
|
||||||
|
'Update-Package-Lists': '1',
|
||||||
|
'Unattended-Upgrade': '1',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
'Unattended-Upgrade': {
|
||||||
|
'Origins-Pattern': {
|
||||||
|
"origin=*",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
'packages': {
|
||||||
|
'unattended-upgrades': {},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
# @metadata_reactor.provides(
|
# @metadata_reactor.provides(
|
||||||
# 'apt/config',
|
# 'apt/config',
|
||||||
# 'apt/list_changes',
|
# 'apt/list_changes',
|
||||||
|
|
|
||||||
|
|
@ -33,7 +33,6 @@ def acme_zone(metadata):
|
||||||
str(ip_interface(other_node.metadata.get('network/internal/ipv4')).ip)
|
str(ip_interface(other_node.metadata.get('network/internal/ipv4')).ip)
|
||||||
for other_node in repo.nodes
|
for other_node in repo.nodes
|
||||||
if other_node.metadata.get('letsencrypt/domains', {})
|
if other_node.metadata.get('letsencrypt/domains', {})
|
||||||
and other_node.metadata.get('network/internal/ipv4', None)
|
|
||||||
},
|
},
|
||||||
*{
|
*{
|
||||||
str(ip_interface(other_node.metadata.get('wireguard/my_ip')).ip)
|
str(ip_interface(other_node.metadata.get('wireguard/my_ip')).ip)
|
||||||
|
|
|
||||||
|
|
@ -1,30 +0,0 @@
|
||||||
# bind
|
|
||||||
|
|
||||||
Authoritative DNS — primary plus optional `bind/master_node` slaves.
|
|
||||||
|
|
||||||
## Applying changes needs both nodes
|
|
||||||
|
|
||||||
The slave's bw-managed zone files are rendered from the master's
|
|
||||||
metadata at slave-apply time (see `bundles/bind/items.py:100`). When
|
|
||||||
you change a record on the master (adding a `letsencrypt/domains`
|
|
||||||
entry, a new vhost, etc.), the change is only published once you
|
|
||||||
apply BOTH:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
bw apply htz.mails # primary (where the source records live)
|
|
||||||
bw apply ovh.secondary # secondary (renders its own zone files)
|
|
||||||
```
|
|
||||||
|
|
||||||
Until both have been applied, `bw verify ovh.secondary` will show
|
|
||||||
stale zones and consumers that hit the secondary (Let's Encrypt's
|
|
||||||
secondary-region validators in particular) will see NXDOMAIN. Even
|
|
||||||
though the slave's named.conf.local declares `type slave;`, don't
|
|
||||||
rely on bind's own AXFR catching up — the bw-rendered file on disk
|
|
||||||
is what `bw verify` measures.
|
|
||||||
|
|
||||||
## See also
|
|
||||||
|
|
||||||
- `bundles/bind-acme/` — the in-house ACME-update receiver.
|
|
||||||
- `bundles/letsencrypt/README.md` — DNS-01 prerequisites and the
|
|
||||||
negative-cache penalty (the most common operational consequence
|
|
||||||
of forgetting to apply the secondary).
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
$TTL 86400
|
|
||||||
@ IN SOA localhost. root.localhost. (
|
|
||||||
1 ; Serial
|
|
||||||
604800 ; Refresh
|
|
||||||
86400 ; Retry
|
|
||||||
2419200 ; Expire
|
|
||||||
86400 ) ; Negative Cache TTL
|
|
||||||
IN NS localhost.
|
|
||||||
|
|
@ -29,7 +29,6 @@ view "${view_name}" {
|
||||||
|
|
||||||
% if view_conf['is_internal']:
|
% if view_conf['is_internal']:
|
||||||
recursion yes;
|
recursion yes;
|
||||||
include "/etc/bind/zones.rfc1918";
|
|
||||||
% else:
|
% else:
|
||||||
recursion no;
|
recursion no;
|
||||||
rate-limit {
|
rate-limit {
|
||||||
|
|
@ -63,6 +62,9 @@ view "${view_name}" {
|
||||||
file "/var/lib/bind/${view_name}/${zone_name}";
|
file "/var/lib/bind/${view_name}/${zone_name}";
|
||||||
};
|
};
|
||||||
% endfor
|
% endfor
|
||||||
|
|
||||||
|
include "/etc/bind/named.conf.default-zones";
|
||||||
|
include "/etc/bind/zones.rfc1918";
|
||||||
};
|
};
|
||||||
|
|
||||||
% endfor
|
% endfor
|
||||||
|
|
|
||||||
|
|
@ -1,19 +0,0 @@
|
||||||
zone "10.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "16.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "17.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "18.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "19.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "20.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "21.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "22.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "23.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "24.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "25.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "26.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "27.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "28.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "29.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "30.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "31.172.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "168.192.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
zone "254.169.in-addr.arpa" { type master; file "/etc/bind/db.empty"; };
|
|
||||||
|
|
@ -142,21 +142,3 @@ actions['named-checkconf'] = {
|
||||||
'svc_systemd:bind9:reload',
|
'svc_systemd:bind9:reload',
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|
||||||
# beantwortet Anfragen nach privaten IP-Adressen mit NXDOMAIN, statt sie ins Internet weiterzuleiten
|
|
||||||
files['/etc/bind/zones.rfc1918'] = {
|
|
||||||
'needed_by': [
|
|
||||||
'svc_systemd:bind9',
|
|
||||||
],
|
|
||||||
'triggers': [
|
|
||||||
'svc_systemd:bind9:reload',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
files['/etc/bind/db.empty'] = {
|
|
||||||
'needed_by': [
|
|
||||||
'svc_systemd:bind9',
|
|
||||||
],
|
|
||||||
'triggers': [
|
|
||||||
'svc_systemd:bind9:reload',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
|
||||||
|
|
@ -3,7 +3,6 @@ from json import dumps
|
||||||
h = repo.libs.hashable.hashable
|
h = repo.libs.hashable.hashable
|
||||||
repo.libs.bind.repo = repo
|
repo.libs.bind.repo = repo
|
||||||
|
|
||||||
|
|
||||||
defaults = {
|
defaults = {
|
||||||
'apt': {
|
'apt': {
|
||||||
'packages': {
|
'packages': {
|
||||||
|
|
@ -49,13 +48,13 @@ defaults = {
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'telegraf': {
|
'telegraf': {
|
||||||
'inputs': {
|
'config': {
|
||||||
'bind': {
|
'inputs': {
|
||||||
'default': {
|
'bind': [{
|
||||||
'urls': ['http://localhost:8053/xml/v3'],
|
'urls': ['http://localhost:8053/xml/v3'],
|
||||||
'gather_memory_contexts': False,
|
'gather_memory_contexts': False,
|
||||||
'gather_views': True,
|
'gather_views': True,
|
||||||
},
|
}],
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
@ -212,7 +211,7 @@ def generate_keys(metadata):
|
||||||
'token':repo.libs.hmac.hmac_sha512(
|
'token':repo.libs.hmac.hmac_sha512(
|
||||||
key,
|
key,
|
||||||
str(repo.vault.random_bytes_as_base64_for(
|
str(repo.vault.random_bytes_as_base64_for(
|
||||||
f"{metadata.get('id')} bind key {key} 20250713",
|
f"{metadata.get('id')} bind key {key}",
|
||||||
length=32,
|
length=32,
|
||||||
)),
|
)),
|
||||||
)
|
)
|
||||||
|
|
|
||||||
|
|
@ -1,165 +0,0 @@
|
||||||
#!/usr/bin/env python3
|
|
||||||
|
|
||||||
import os
|
|
||||||
import datetime
|
|
||||||
import numpy as np
|
|
||||||
import matplotlib.pyplot as plt
|
|
||||||
import soundfile as sf
|
|
||||||
from scipy.fft import rfft, rfftfreq
|
|
||||||
import shutil
|
|
||||||
import traceback
|
|
||||||
|
|
||||||
|
|
||||||
RECORDINGS_DIR = "recordings"
|
|
||||||
PROCESSED_RECORDINGS_DIR = "recordings/processed"
|
|
||||||
DETECTIONS_DIR = "events"
|
|
||||||
|
|
||||||
DETECT_FREQUENCY = 211 # Hz
|
|
||||||
DETECT_FREQUENCY_TOLERANCE = 2 # Hz
|
|
||||||
ADJACENCY_FACTOR = 2 # area to look for the frequency (e.g. 2 means 100Hz to 400Hz for 200Hz detection)
|
|
||||||
BLOCK_SECONDS = 3 # seconds (longer means more frequency resolution, but less time resolution)
|
|
||||||
DETECTION_DISTANCE_SECONDS = 30 # seconds (minimum time between detections)
|
|
||||||
BLOCK_OVERLAP_FACTOR = 0.9 # overlap between blocks (0.2 means 20% overlap)
|
|
||||||
MIN_SIGNAL_QUALITY = 1000.0 # maximum noise level (relative DB) to consider a detection valid
|
|
||||||
PLOT_PADDING_START_SECONDS = 2 # seconds (padding before and after the event in the plot)
|
|
||||||
PLOT_PADDING_END_SECONDS = 3 # seconds (padding before and after the event in the plot)
|
|
||||||
|
|
||||||
DETECTION_DISTANCE_BLOCKS = DETECTION_DISTANCE_SECONDS // BLOCK_SECONDS # number of blocks to skip after a detection
|
|
||||||
DETECT_FREQUENCY_FROM = DETECT_FREQUENCY - DETECT_FREQUENCY_TOLERANCE # Hz
|
|
||||||
DETECT_FREQUENCY_TO = DETECT_FREQUENCY + DETECT_FREQUENCY_TOLERANCE # Hz
|
|
||||||
|
|
||||||
|
|
||||||
def process_recording(filename):
|
|
||||||
print('processing', filename)
|
|
||||||
|
|
||||||
# get ISO 8601 nanosecond recording date from filename
|
|
||||||
date_string_from_filename = os.path.splitext(filename)[0]
|
|
||||||
recording_date = datetime.datetime.strptime(date_string_from_filename, "%Y-%m-%d_%H-%M-%S.%f%z")
|
|
||||||
|
|
||||||
# get data and metadata from recording
|
|
||||||
path = os.path.join(RECORDINGS_DIR, filename)
|
|
||||||
soundfile = sf.SoundFile(path)
|
|
||||||
samplerate = soundfile.samplerate
|
|
||||||
samples_per_block = int(BLOCK_SECONDS * samplerate)
|
|
||||||
overlapping_samples = int(samples_per_block * BLOCK_OVERLAP_FACTOR)
|
|
||||||
|
|
||||||
sample_num = 0
|
|
||||||
current_event = None
|
|
||||||
|
|
||||||
while sample_num < len(soundfile):
|
|
||||||
soundfile.seek(sample_num)
|
|
||||||
block = soundfile.read(frames=samples_per_block, dtype='float32', always_2d=False)
|
|
||||||
|
|
||||||
if len(block) == 0:
|
|
||||||
break
|
|
||||||
|
|
||||||
# calculate FFT
|
|
||||||
labels = rfftfreq(len(block), d=1/samplerate)
|
|
||||||
complex_amplitudes = rfft(block)
|
|
||||||
amplitudes = np.abs(complex_amplitudes)
|
|
||||||
|
|
||||||
# get the frequency with the highest amplitude within the search range
|
|
||||||
search_amplitudes = amplitudes[(labels >= DETECT_FREQUENCY_FROM/ADJACENCY_FACTOR) & (labels <= DETECT_FREQUENCY_TO*ADJACENCY_FACTOR)]
|
|
||||||
search_labels = labels[(labels >= DETECT_FREQUENCY_FROM/ADJACENCY_FACTOR) & (labels <= DETECT_FREQUENCY_TO*ADJACENCY_FACTOR)]
|
|
||||||
max_amplitude = max(search_amplitudes)
|
|
||||||
max_amplitude_index = np.argmax(search_amplitudes)
|
|
||||||
max_freq = search_labels[max_amplitude_index]
|
|
||||||
max_freq_detected = DETECT_FREQUENCY_FROM <= max_freq <= DETECT_FREQUENCY_TO
|
|
||||||
|
|
||||||
# calculate signal quality
|
|
||||||
adjacent_amplitudes = amplitudes[(labels < DETECT_FREQUENCY_FROM) | (labels > DETECT_FREQUENCY_TO)]
|
|
||||||
signal_quality = max_amplitude/np.mean(adjacent_amplitudes)
|
|
||||||
good_signal_quality = signal_quality > MIN_SIGNAL_QUALITY
|
|
||||||
|
|
||||||
# conclude detection
|
|
||||||
if (
|
|
||||||
max_freq_detected and
|
|
||||||
good_signal_quality
|
|
||||||
):
|
|
||||||
block_date = recording_date + datetime.timedelta(seconds=sample_num / samplerate)
|
|
||||||
|
|
||||||
# detecting an event
|
|
||||||
if not current_event:
|
|
||||||
current_event = {
|
|
||||||
'start_at': block_date,
|
|
||||||
'end_at': block_date,
|
|
||||||
'start_sample': sample_num,
|
|
||||||
'end_sample': sample_num + samples_per_block,
|
|
||||||
'start_freq': max_freq,
|
|
||||||
'end_freq': max_freq,
|
|
||||||
'max_amplitude': max_amplitude,
|
|
||||||
}
|
|
||||||
else:
|
|
||||||
current_event.update({
|
|
||||||
'end_at': block_date,
|
|
||||||
'end_freq': max_freq,
|
|
||||||
'end_sample': sample_num + samples_per_block,
|
|
||||||
'max_amplitude': max(max_amplitude, current_event['max_amplitude']),
|
|
||||||
})
|
|
||||||
print(f'- {block_date.strftime('%Y-%m-%d %H:%M:%S')}: {max_amplitude:.1f}rDB @ {max_freq:.1f}Hz (signal {signal_quality:.3f}x)')
|
|
||||||
else:
|
|
||||||
# not detecting an event
|
|
||||||
if current_event:
|
|
||||||
duration = (current_event['end_at'] - current_event['start_at']).total_seconds()
|
|
||||||
current_event['duration'] = duration
|
|
||||||
print(f'🔊 {current_event['start_at'].strftime('%Y-%m-%d %H:%M:%S')} ({duration:.1f}s): {current_event['start_freq']:.1f}Hz->{current_event['end_freq']:.1f}Hz @{current_event['max_amplitude']:.0f}rDB')
|
|
||||||
|
|
||||||
# read full audio clip again for writing
|
|
||||||
write_event(current_event=current_event, soundfile=soundfile, samplerate=samplerate)
|
|
||||||
|
|
||||||
current_event = None
|
|
||||||
sample_num += DETECTION_DISTANCE_BLOCKS * samples_per_block
|
|
||||||
|
|
||||||
sample_num += samples_per_block - overlapping_samples
|
|
||||||
|
|
||||||
# move to PROCESSED_RECORDINGS_DIR
|
|
||||||
|
|
||||||
os.makedirs(PROCESSED_RECORDINGS_DIR, exist_ok=True)
|
|
||||||
shutil.move(os.path.join(RECORDINGS_DIR, filename), os.path.join(PROCESSED_RECORDINGS_DIR, filename))
|
|
||||||
|
|
||||||
|
|
||||||
# write a spectrogram using the sound from start to end of the event
|
|
||||||
def write_event(current_event, soundfile, samplerate):
|
|
||||||
# date and filename
|
|
||||||
event_date = current_event['start_at'] - datetime.timedelta(seconds=PLOT_PADDING_START_SECONDS)
|
|
||||||
filename_prefix = event_date.strftime('%Y-%m-%d_%H-%M-%S.%f%z')
|
|
||||||
|
|
||||||
# event clip
|
|
||||||
event_start_sample = current_event['start_sample'] - samplerate * PLOT_PADDING_START_SECONDS
|
|
||||||
event_end_sample = current_event['end_sample'] + samplerate * PLOT_PADDING_END_SECONDS
|
|
||||||
total_samples = event_end_sample - event_start_sample
|
|
||||||
soundfile.seek(event_start_sample)
|
|
||||||
event_clip = soundfile.read(frames=total_samples, dtype='float32', always_2d=False)
|
|
||||||
|
|
||||||
# write flac
|
|
||||||
flac_path = os.path.join(DETECTIONS_DIR, f"{filename_prefix}.flac")
|
|
||||||
sf.write(flac_path, event_clip, samplerate, format='FLAC')
|
|
||||||
|
|
||||||
# write spectrogram
|
|
||||||
plt.figure(figsize=(8, 6))
|
|
||||||
plt.specgram(event_clip, Fs=samplerate, NFFT=samplerate, noverlap=samplerate//2, cmap='inferno', vmin=-100, vmax=-10)
|
|
||||||
plt.title(f"Bootshorn @{event_date.strftime('%Y-%m-%d %H:%M:%S%z')}")
|
|
||||||
plt.xlabel(f"Time {current_event['duration']:.1f}s")
|
|
||||||
plt.ylabel(f"Frequency {current_event['start_freq']:.1f}Hz -> {current_event['end_freq']:.1f}Hz")
|
|
||||||
plt.colorbar(label="Intensity (rDB)")
|
|
||||||
plt.ylim(50, 1000)
|
|
||||||
plt.savefig(os.path.join(DETECTIONS_DIR, f"{filename_prefix}.png"))
|
|
||||||
plt.close()
|
|
||||||
|
|
||||||
|
|
||||||
def main():
|
|
||||||
os.makedirs(RECORDINGS_DIR, exist_ok=True)
|
|
||||||
os.makedirs(PROCESSED_RECORDINGS_DIR, exist_ok=True)
|
|
||||||
|
|
||||||
for filename in sorted(os.listdir(RECORDINGS_DIR)):
|
|
||||||
if filename.endswith(".flac"):
|
|
||||||
try:
|
|
||||||
process_recording(filename)
|
|
||||||
except Exception as e:
|
|
||||||
print(f"Error processing {filename}: {e}")
|
|
||||||
# print stacktrace
|
|
||||||
traceback.print_exc()
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
main()
|
|
||||||
|
|
@ -1,25 +0,0 @@
|
||||||
#!/bin/sh
|
|
||||||
|
|
||||||
mkdir -p recordings
|
|
||||||
|
|
||||||
while true
|
|
||||||
do
|
|
||||||
# get date in ISO 8601 format with nanoseconds
|
|
||||||
PROGRAMM=$(test $(uname) = "Darwin" && echo "gdate" || echo "date")
|
|
||||||
DATE=$($PROGRAMM "+%Y-%m-%d_%H-%M-%S.%6N%z")
|
|
||||||
|
|
||||||
# record audio using ffmpeg
|
|
||||||
ffmpeg \
|
|
||||||
-y \
|
|
||||||
-f pulse \
|
|
||||||
-i "alsa_input.usb-HANMUS_USB_AUDIO_24BIT_2I2O_1612310-00.analog-stereo" \
|
|
||||||
-ac 1 \
|
|
||||||
-ar 96000 \
|
|
||||||
-sample_fmt s32 \
|
|
||||||
-t "3600" \
|
|
||||||
-c:a flac \
|
|
||||||
-compression_level 12 \
|
|
||||||
"recordings/current/$DATE.flac"
|
|
||||||
|
|
||||||
mv "recordings/current/$DATE.flac" "recordings/$DATE.flac"
|
|
||||||
done
|
|
||||||
|
|
@ -1,43 +0,0 @@
|
||||||
#!/usr/bin/env python3
|
|
||||||
|
|
||||||
import requests
|
|
||||||
import urllib3
|
|
||||||
import datetime
|
|
||||||
import csv
|
|
||||||
urllib3.disable_warnings()
|
|
||||||
import os
|
|
||||||
|
|
||||||
|
|
||||||
HUE_IP = "${hue_ip}" # replace with your bridge IP
|
|
||||||
HUE_APP_KEY = "${hue_app_key}" # local only
|
|
||||||
HUE_DEVICE_ID = "31f58786-3242-4e88-b9ce-23f44ba27bbe"
|
|
||||||
TEMPERATURE_LOG_DIR = "/opt/bootshorn/temperatures"
|
|
||||||
|
|
||||||
response = requests.get(
|
|
||||||
f"https://{HUE_IP}/clip/v2/resource/temperature",
|
|
||||||
headers={"hue-application-key": HUE_APP_KEY},
|
|
||||||
verify=False,
|
|
||||||
)
|
|
||||||
response.raise_for_status()
|
|
||||||
data = response.json()
|
|
||||||
|
|
||||||
for item in data["data"]:
|
|
||||||
if item["id"] == HUE_DEVICE_ID:
|
|
||||||
temperature = item["temperature"]["temperature"]
|
|
||||||
temperature_date_string = item["temperature"]["temperature_report"]["changed"]
|
|
||||||
temperature_date = datetime.datetime.fromisoformat(temperature_date_string).astimezone(datetime.timezone.utc)
|
|
||||||
break
|
|
||||||
|
|
||||||
print(f"@{temperature_date}: {temperature}°C")
|
|
||||||
|
|
||||||
filename = temperature_date.strftime("%Y-%m-%d_00-00-00.000000%z") + ".log"
|
|
||||||
logpath = os.path.join(TEMPERATURE_LOG_DIR, filename)
|
|
||||||
now_utc = datetime.datetime.now(datetime.timezone.utc)
|
|
||||||
|
|
||||||
with open(logpath, "a+", newline="") as logfile:
|
|
||||||
writer = csv.writer(logfile)
|
|
||||||
writer.writerow([
|
|
||||||
now_utc.strftime('%Y-%m-%d_%H-%M-%S.%f%z'), # current UTC time
|
|
||||||
temperature_date.strftime('%Y-%m-%d_%H-%M-%S.%f%z'), # date of temperature reading
|
|
||||||
temperature,
|
|
||||||
])
|
|
||||||
|
|
@ -1,61 +0,0 @@
|
||||||
# nano /etc/selinux/config
|
|
||||||
# SELINUX=disabled
|
|
||||||
# reboot
|
|
||||||
|
|
||||||
directories = {
|
|
||||||
'/opt/bootshorn': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
},
|
|
||||||
'/opt/bootshorn/temperatures': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
},
|
|
||||||
'/opt/bootshorn/recordings': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
},
|
|
||||||
'/opt/bootshorn/recordings/current': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
},
|
|
||||||
'/opt/bootshorn/recordings/processed': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
},
|
|
||||||
'/opt/bootshorn/events': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
files = {
|
|
||||||
'/opt/bootshorn/record': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
'mode': '755',
|
|
||||||
},
|
|
||||||
'/opt/bootshorn/temperature': {
|
|
||||||
'content_type': 'mako',
|
|
||||||
'context': {
|
|
||||||
'hue_ip': repo.get_node('home.hue').hostname,
|
|
||||||
'hue_app_key': repo.vault.decrypt('encrypt$gAAAAABoc2WxZCLbxl-Z4IrSC97CdOeFgBplr9Fp5ujpd0WCCCPNBUY_WquHN86z8hKLq5Y04dwq8TdJW0PMSOSgTFbGgdp_P1q0jOBLEKaW9IIT1YM88h-JYwLf9QGDV_5oEfvnBCtO'),
|
|
||||||
},
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
'mode': '755',
|
|
||||||
},
|
|
||||||
'/opt/bootshorn/process': {
|
|
||||||
'owner': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
'mode': '755',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
svc_systemd = {
|
|
||||||
'bootshorn-record.service': {
|
|
||||||
'needs': {
|
|
||||||
'file:/opt/bootshorn/record',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
@ -1,44 +0,0 @@
|
||||||
defaults = {
|
|
||||||
'systemd': {
|
|
||||||
'units': {
|
|
||||||
'bootshorn-record.service': {
|
|
||||||
'Unit': {
|
|
||||||
'Description': 'Bootshorn Recorder',
|
|
||||||
'After': 'network.target',
|
|
||||||
},
|
|
||||||
'Service': {
|
|
||||||
'User': 'ckn',
|
|
||||||
'Group': 'ckn',
|
|
||||||
'Type': 'simple',
|
|
||||||
'WorkingDirectory': '/opt/bootshorn',
|
|
||||||
'ExecStart': '/opt/bootshorn/record',
|
|
||||||
'Restart': 'always',
|
|
||||||
'RestartSec': 5,
|
|
||||||
'Environment': {
|
|
||||||
"XDG_RUNTIME_DIR": "/run/user/1000",
|
|
||||||
"PULSE_SERVER": "unix:/run/user/1000/pulse/native",
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'systemd-timers': {
|
|
||||||
'bootshorn-temperature': {
|
|
||||||
'command': '/opt/bootshorn/temperature',
|
|
||||||
'when': '*:0/10',
|
|
||||||
'working_dir': '/opt/bootshorn',
|
|
||||||
'user': 'ckn',
|
|
||||||
'group': 'ckn',
|
|
||||||
},
|
|
||||||
# 'bootshorn-process': {
|
|
||||||
# 'command': '/opt/bootshorn/process',
|
|
||||||
# 'when': 'hourly',
|
|
||||||
# 'working_dir': '/opt/bootshorn',
|
|
||||||
# 'user': 'ckn',
|
|
||||||
# 'group': 'ckn',
|
|
||||||
# 'after': {
|
|
||||||
# 'bootshorn-process.service',
|
|
||||||
# },
|
|
||||||
# },
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
@ -27,7 +27,7 @@ def ssh_keys(metadata):
|
||||||
'users': {
|
'users': {
|
||||||
'build-agent': {
|
'build-agent': {
|
||||||
'authorized_users': {
|
'authorized_users': {
|
||||||
f'build-server@{other_node.name}': {}
|
f'build-server@{other_node.name}'
|
||||||
for other_node in repo.nodes
|
for other_node in repo.nodes
|
||||||
if other_node.has_bundle('build-server')
|
if other_node.has_bundle('build-server')
|
||||||
for architecture in other_node.metadata.get('build-server/architectures').values()
|
for architecture in other_node.metadata.get('build-server/architectures').values()
|
||||||
|
|
|
||||||
|
|
@ -14,7 +14,7 @@ def ssh_keys(metadata):
|
||||||
'users': {
|
'users': {
|
||||||
'build-ci': {
|
'build-ci': {
|
||||||
'authorized_users': {
|
'authorized_users': {
|
||||||
f'build-server@{other_node.name}': {}
|
f'build-server@{other_node.name}'
|
||||||
for other_node in repo.nodes
|
for other_node in repo.nodes
|
||||||
if other_node.has_bundle('build-server')
|
if other_node.has_bundle('build-server')
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -8,7 +8,6 @@ defaults = {
|
||||||
'sources': {
|
'sources': {
|
||||||
'crystal': {
|
'crystal': {
|
||||||
# https://software.opensuse.org/download.html?project=devel%3Alanguages%3Acrystal&package=crystal
|
# https://software.opensuse.org/download.html?project=devel%3Alanguages%3Acrystal&package=crystal
|
||||||
# curl -fsSL https://download.opensuse.org/repositories/devel:/languages:/crystal/Debian_Testing/Release.key
|
|
||||||
'urls': {
|
'urls': {
|
||||||
'http://download.opensuse.org/repositories/devel:/languages:/crystal/Debian_Testing/',
|
'http://download.opensuse.org/repositories/devel:/languages:/crystal/Debian_Testing/',
|
||||||
},
|
},
|
||||||
|
|
|
||||||
17
bundles/dovecot/files/dovecot-sql.conf
Normal file
17
bundles/dovecot/files/dovecot-sql.conf
Normal file
|
|
@ -0,0 +1,17 @@
|
||||||
|
connect = host=${host} dbname=${name} user=${user} password=${password}
|
||||||
|
driver = pgsql
|
||||||
|
default_pass_scheme = ARGON2ID
|
||||||
|
|
||||||
|
user_query = SELECT '/var/vmail/%u' AS home, 'vmail' AS uid, 'vmail' AS gid
|
||||||
|
|
||||||
|
iterate_query = SELECT CONCAT(users.name, '@', domains.name) AS user \
|
||||||
|
FROM users \
|
||||||
|
LEFT JOIN domains ON users.domain_id = domains.id \
|
||||||
|
WHERE redirect IS NULL
|
||||||
|
|
||||||
|
password_query = SELECT CONCAT(users.name, '@', domains.name) AS user, password \
|
||||||
|
FROM users \
|
||||||
|
LEFT JOIN domains ON users.domain_id = domains.id \
|
||||||
|
WHERE redirect IS NULL \
|
||||||
|
AND users.name = SPLIT_PART('%u', '@', 1) \
|
||||||
|
AND domains.name = SPLIT_PART('%u', '@', 2)
|
||||||
|
|
@ -1,17 +1,13 @@
|
||||||
dovecot_config_version = ${config_version}
|
|
||||||
dovecot_storage_version = ${storage_version}
|
|
||||||
|
|
||||||
protocols = imap lmtp sieve
|
protocols = imap lmtp sieve
|
||||||
auth_mechanisms = plain login
|
auth_mechanisms = plain login
|
||||||
|
mail_privileged_group = mail
|
||||||
ssl = required
|
ssl = required
|
||||||
ssl_server_cert_file = /var/lib/dehydrated/certs/${hostname}/fullchain.pem
|
ssl_cert = </var/lib/dehydrated/certs/${node.metadata.get('mailserver/hostname')}/fullchain.pem
|
||||||
ssl_server_key_file = /var/lib/dehydrated/certs/${hostname}/privkey.pem
|
ssl_key = </var/lib/dehydrated/certs/${node.metadata.get('mailserver/hostname')}/privkey.pem
|
||||||
ssl_server_dh_file = /etc/dovecot/dhparam.pem
|
ssl_dh = </etc/dovecot/dhparam.pem
|
||||||
ssl_client_ca_dir = /etc/ssl/certs
|
ssl_client_ca_dir = /etc/ssl/certs
|
||||||
mail_driver = maildir
|
mail_location = maildir:${node.metadata.get('mailserver/maildir')}/%u:INDEX=${node.metadata.get('mailserver/maildir')}/index/%u
|
||||||
mail_path = ${maildir}/%{user}
|
mail_plugins = fts fts_xapian
|
||||||
mail_index_path = ${maildir}/index/%{user}
|
|
||||||
mail_plugins = fts fts_flatcurve
|
|
||||||
|
|
||||||
namespace inbox {
|
namespace inbox {
|
||||||
inbox = yes
|
inbox = yes
|
||||||
|
|
@ -34,46 +30,14 @@ namespace inbox {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
# postgres passdb userdb
|
passdb {
|
||||||
|
driver = sql
|
||||||
sql_driver = pgsql
|
args = /etc/dovecot/dovecot-sql.conf
|
||||||
|
|
||||||
pgsql main {
|
|
||||||
parameters {
|
|
||||||
host = ${db_host}
|
|
||||||
dbname = ${db_name}
|
|
||||||
user = ${db_user}
|
|
||||||
password = ${db_password}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
# use sql for userdb too, to enable iterate_query
|
||||||
passdb sql {
|
userdb {
|
||||||
passdb_default_password_scheme = ARGON2ID
|
driver = sql
|
||||||
|
args = /etc/dovecot/dovecot-sql.conf
|
||||||
query = SELECT \
|
|
||||||
CONCAT(users.name, '@', domains.name) AS "user", \
|
|
||||||
password \
|
|
||||||
FROM users \
|
|
||||||
LEFT JOIN domains ON users.domain_id = domains.id \
|
|
||||||
WHERE redirect IS NULL \
|
|
||||||
AND users.name = SPLIT_PART('%{user}', '@', 1) \
|
|
||||||
AND domains.name = SPLIT_PART('%{user}', '@', 2)
|
|
||||||
}
|
|
||||||
|
|
||||||
mail_uid = vmail
|
|
||||||
mail_gid = vmail
|
|
||||||
|
|
||||||
userdb sql {
|
|
||||||
query = SELECT \
|
|
||||||
'/var/vmail/%{user}' AS home, \
|
|
||||||
'vmail' AS uid, \
|
|
||||||
'vmail' AS gid
|
|
||||||
|
|
||||||
iterate_query = SELECT \
|
|
||||||
CONCAT(users.name, '@', domains.name) AS username \
|
|
||||||
FROM users \
|
|
||||||
LEFT JOIN domains ON users.domain_id = domains.id \
|
|
||||||
WHERE redirect IS NULL
|
|
||||||
}
|
}
|
||||||
|
|
||||||
service auth {
|
service auth {
|
||||||
|
|
@ -103,9 +67,10 @@ service stats {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
service managesieve-login {
|
service managesieve-login {
|
||||||
#inet_listener sieve {}
|
inet_listener sieve {
|
||||||
process_min_avail = 1
|
}
|
||||||
process_limit = 1
|
process_min_avail = 0
|
||||||
|
service_count = 1
|
||||||
vsz_limit = 64 M
|
vsz_limit = 64 M
|
||||||
}
|
}
|
||||||
service managesieve {
|
service managesieve {
|
||||||
|
|
@ -113,53 +78,31 @@ service managesieve {
|
||||||
}
|
}
|
||||||
|
|
||||||
protocol imap {
|
protocol imap {
|
||||||
mail_plugins = fts fts_flatcurve imap_sieve
|
mail_plugins = $mail_plugins imap_sieve
|
||||||
mail_max_userip_connections = 50
|
mail_max_userip_connections = 50
|
||||||
imap_idle_notify_interval = 29 mins
|
imap_idle_notify_interval = 29 mins
|
||||||
}
|
}
|
||||||
protocol lmtp {
|
protocol lmtp {
|
||||||
mail_plugins = fts fts_flatcurve sieve
|
mail_plugins = $mail_plugins sieve
|
||||||
}
|
}
|
||||||
|
protocol sieve {
|
||||||
# Persönliches Skript (deine alte Datei /var/vmail/sieve/%u.sieve)
|
plugin {
|
||||||
sieve_script personal {
|
sieve = /var/vmail/sieve/%u.sieve
|
||||||
driver = file
|
sieve_storage = /var/vmail/sieve/%u/
|
||||||
# Verzeichnis mit (evtl. mehreren) Sieve-Skripten des Users
|
}
|
||||||
path = /var/vmail/sieve/%{user}/
|
|
||||||
# Aktives Skript (entspricht früher "sieve = /var/vmail/sieve/%u.sieve")
|
|
||||||
active_path = /var/vmail/sieve/%{user}.sieve
|
|
||||||
}
|
|
||||||
|
|
||||||
# Globales After-Skript (dein früheres "sieve_after = …")
|
|
||||||
sieve_script after {
|
|
||||||
type = after
|
|
||||||
driver = file
|
|
||||||
path = /var/vmail/sieve/global/spam-to-folder.sieve
|
|
||||||
}
|
}
|
||||||
|
|
||||||
# fulltext search
|
# fulltext search
|
||||||
language en {
|
plugin {
|
||||||
|
fts = xapian
|
||||||
|
fts_xapian = partial=3 full=20 verbose=0
|
||||||
|
fts_autoindex = yes
|
||||||
|
fts_enforced = yes
|
||||||
|
# Index attachements
|
||||||
|
fts_decoder = decode2text
|
||||||
}
|
}
|
||||||
language de {
|
|
||||||
default = yes
|
|
||||||
}
|
|
||||||
language_tokenizers = generic email-address
|
|
||||||
|
|
||||||
fts flatcurve {
|
|
||||||
substring_search = yes
|
|
||||||
# rotate_count = 5000 # DB-Rotation nach X Mails
|
|
||||||
# rotate_time = 5s # oder zeitbasiert rotieren
|
|
||||||
# optimize_limit = 10
|
|
||||||
# min_term_size = 3
|
|
||||||
}
|
|
||||||
|
|
||||||
fts_autoindex = yes
|
|
||||||
fts_decoder_driver = script
|
|
||||||
fts_decoder_script_socket_path = decode2text
|
|
||||||
|
|
||||||
service indexer-worker {
|
service indexer-worker {
|
||||||
process_limit = ${indexer_cores}
|
vsz_limit = ${indexer_ram}
|
||||||
vsz_limit = ${indexer_ram}M
|
|
||||||
}
|
}
|
||||||
service decode2text {
|
service decode2text {
|
||||||
executable = script /usr/local/libexec/dovecot/decode2text.sh
|
executable = script /usr/local/libexec/dovecot/decode2text.sh
|
||||||
|
|
@ -169,39 +112,24 @@ service decode2text {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
mailbox Junk {
|
# spam filter
|
||||||
sieve_script learn_spam {
|
plugin {
|
||||||
driver = file
|
sieve_plugins = sieve_imapsieve sieve_extprograms
|
||||||
type = before
|
sieve_dir = /var/vmail/sieve/%u/
|
||||||
cause = copy
|
sieve = /var/vmail/sieve/%u.sieve
|
||||||
path = /var/vmail/sieve/global/learn-spam.sieve
|
sieve_pipe_bin_dir = /var/vmail/sieve/bin
|
||||||
}
|
sieve_extensions = +vnd.dovecot.pipe
|
||||||
}
|
|
||||||
|
|
||||||
imapsieve_from Junk {
|
sieve_after = /var/vmail/sieve/global/spam-to-folder.sieve
|
||||||
sieve_script learn_ham {
|
|
||||||
driver = file
|
|
||||||
type = before
|
|
||||||
cause = copy
|
|
||||||
path = /var/vmail/sieve/global/learn-ham.sieve
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# Extprograms-Plugin einschalten
|
# From elsewhere to Spam folder
|
||||||
sieve_plugins {
|
imapsieve_mailbox1_name = Junk
|
||||||
sieve_extprograms = yes
|
imapsieve_mailbox1_causes = COPY
|
||||||
}
|
imapsieve_mailbox1_before = file:/var/vmail/sieve/global/learn-spam.sieve
|
||||||
|
|
||||||
# Welche Sieve-Erweiterungen dürfen genutzt werden?
|
# From Spam folder to elsewhere
|
||||||
# Empfehlung: nur global erlauben (nicht in User-Skripten):
|
imapsieve_mailbox2_name = *
|
||||||
sieve_global_extensions {
|
imapsieve_mailbox2_from = Junk
|
||||||
vnd.dovecot.pipe = yes
|
imapsieve_mailbox2_causes = COPY
|
||||||
# vnd.dovecot.filter = yes # nur falls gebraucht
|
imapsieve_mailbox2_before = file:/var/vmail/sieve/global/learn-ham.sieve
|
||||||
# vnd.dovecot.execute = yes # nur falls gebraucht
|
|
||||||
}
|
}
|
||||||
|
|
||||||
# Verzeichnis mit deinen Skripten/Binaries für :pipe
|
|
||||||
sieve_pipe_bin_dir = /var/vmail/sieve/bin
|
|
||||||
# (optional, analog für :filter / :execute)
|
|
||||||
# sieve_filter_bin_dir = /var/vmail/sieve/filter
|
|
||||||
# sieve_execute_bin_dir = /var/vmail/sieve/execute
|
|
||||||
|
|
@ -44,16 +44,6 @@ files = {
|
||||||
'context': {
|
'context': {
|
||||||
'admin_email': node.metadata.get('mailserver/admin_email'),
|
'admin_email': node.metadata.get('mailserver/admin_email'),
|
||||||
'indexer_ram': node.metadata.get('dovecot/indexer_ram'),
|
'indexer_ram': node.metadata.get('dovecot/indexer_ram'),
|
||||||
'config_version': node.metadata.get('dovecot/config_version'),
|
|
||||||
'storage_version': node.metadata.get('dovecot/storage_version'),
|
|
||||||
'maildir': node.metadata.get('mailserver/maildir'),
|
|
||||||
'hostname': node.metadata.get('mailserver/hostname'),
|
|
||||||
'db_host': node.metadata.get('mailserver/database/host'),
|
|
||||||
'db_name': node.metadata.get('mailserver/database/name'),
|
|
||||||
'db_user': node.metadata.get('mailserver/database/user'),
|
|
||||||
'db_password': node.metadata.get('mailserver/database/password'),
|
|
||||||
'indexer_cores': node.metadata.get('vm/cores'),
|
|
||||||
'indexer_ram': node.metadata.get('vm/ram')//2,
|
|
||||||
},
|
},
|
||||||
'needs': {
|
'needs': {
|
||||||
'pkg_apt:'
|
'pkg_apt:'
|
||||||
|
|
@ -62,9 +52,29 @@ files = {
|
||||||
'svc_systemd:dovecot:restart',
|
'svc_systemd:dovecot:restart',
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
'/etc/dovecot/dovecot-sql.conf': {
|
||||||
|
'content_type': 'mako',
|
||||||
|
'context': node.metadata.get('mailserver/database'),
|
||||||
|
'needs': {
|
||||||
|
'pkg_apt:'
|
||||||
|
},
|
||||||
|
'triggers': {
|
||||||
|
'svc_systemd:dovecot:restart',
|
||||||
|
},
|
||||||
|
},
|
||||||
'/etc/dovecot/dhparam.pem': {
|
'/etc/dovecot/dhparam.pem': {
|
||||||
'content_type': 'any',
|
'content_type': 'any',
|
||||||
},
|
},
|
||||||
|
'/etc/dovecot/dovecot-sql.conf': {
|
||||||
|
'content_type': 'mako',
|
||||||
|
'context': node.metadata.get('mailserver/database'),
|
||||||
|
'needs': {
|
||||||
|
'pkg_apt:'
|
||||||
|
},
|
||||||
|
'triggers': {
|
||||||
|
'svc_systemd:dovecot:restart',
|
||||||
|
},
|
||||||
|
},
|
||||||
'/var/vmail/sieve/global/spam-to-folder.sieve': {
|
'/var/vmail/sieve/global/spam-to-folder.sieve': {
|
||||||
'owner': 'vmail',
|
'owner': 'vmail',
|
||||||
'group': 'vmail',
|
'group': 'vmail',
|
||||||
|
|
@ -121,6 +131,7 @@ svc_systemd = {
|
||||||
'action:letsencrypt_update_certificates',
|
'action:letsencrypt_update_certificates',
|
||||||
'action:dovecot_generate_dhparam',
|
'action:dovecot_generate_dhparam',
|
||||||
'file:/etc/dovecot/dovecot.conf',
|
'file:/etc/dovecot/dovecot.conf',
|
||||||
|
'file:/etc/dovecot/dovecot-sql.conf',
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -8,7 +8,7 @@ defaults = {
|
||||||
'dovecot-sieve': {},
|
'dovecot-sieve': {},
|
||||||
'dovecot-managesieved': {},
|
'dovecot-managesieved': {},
|
||||||
# fulltext search
|
# fulltext search
|
||||||
'dovecot-flatcurve': {}, # buster-backports
|
'dovecot-fts-xapian': {}, # buster-backports
|
||||||
'poppler-utils': {}, # pdftotext
|
'poppler-utils': {}, # pdftotext
|
||||||
'catdoc': {}, # catdoc, catppt, xls2csv
|
'catdoc': {}, # catdoc, catppt, xls2csv
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -5,11 +5,6 @@ defaults = {
|
||||||
'needs': {
|
'needs': {
|
||||||
'zfs_dataset:tank/downloads'
|
'zfs_dataset:tank/downloads'
|
||||||
},
|
},
|
||||||
'authorized_users': {
|
|
||||||
f'build-server@{other_node.name}': {}
|
|
||||||
for other_node in repo.nodes
|
|
||||||
if other_node.has_bundle('build-server')
|
|
||||||
},
|
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'zfs': {
|
'zfs': {
|
||||||
|
|
@ -19,15 +14,23 @@ defaults = {
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'systemd-mount': {
|
|
||||||
'/var/lib/downloads_nginx': {
|
|
||||||
'source': '/var/lib/downloads',
|
|
||||||
'user': 'www-data',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@metadata_reactor.provides(
|
||||||
|
'systemd-mount'
|
||||||
|
)
|
||||||
|
def mount_certs(metadata):
|
||||||
|
return {
|
||||||
|
'systemd-mount': {
|
||||||
|
'/var/lib/downloads_nginx': {
|
||||||
|
'source': '/var/lib/downloads',
|
||||||
|
'user': 'www-data',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'nginx/vhosts',
|
'nginx/vhosts',
|
||||||
)
|
)
|
||||||
|
|
@ -44,3 +47,20 @@ def nginx(metadata):
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@metadata_reactor.provides(
|
||||||
|
'users/downloads/authorized_users',
|
||||||
|
)
|
||||||
|
def ssh_keys(metadata):
|
||||||
|
return {
|
||||||
|
'users': {
|
||||||
|
'downloads': {
|
||||||
|
'authorized_users': {
|
||||||
|
f'build-server@{other_node.name}'
|
||||||
|
for other_node in repo.nodes
|
||||||
|
if other_node.has_bundle('build-server')
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
|
||||||
|
|
@ -43,11 +43,11 @@ def units(metadata):
|
||||||
'Service': {
|
'Service': {
|
||||||
'Environment': {
|
'Environment': {
|
||||||
f'{k}={v}'
|
f'{k}={v}'
|
||||||
for k, v in metadata.get(f'flask/{name}/env', {}).items()
|
for k, v in conf.get('env', {}).items()
|
||||||
},
|
},
|
||||||
'User': metadata.get(f'flask/{name}/user'),
|
'User': conf['user'],
|
||||||
'Group': metadata.get(f'flask/{name}/group'),
|
'Group': conf['group'],
|
||||||
'ExecStart': f"/opt/{name}/venv/bin/gunicorn -w {metadata.get(f'flask/{name}/workers')} -b 127.0.0.1:{metadata.get(f'flask/{name}/port')} --timeout {metadata.get(f'flask/{name}/timeout')} {metadata.get(f'flask/{name}/app_module')}:app"
|
'ExecStart': f"/opt/{name}/venv/bin/gunicorn -w {conf['workers']} -b 127.0.0.1:{conf['port']} --timeout {conf['timeout']} {conf['app_module']}:app"
|
||||||
},
|
},
|
||||||
'Install': {
|
'Install': {
|
||||||
'WantedBy': {
|
'WantedBy': {
|
||||||
|
|
@ -55,7 +55,7 @@ def units(metadata):
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
for name in metadata.get('flask')
|
for name, conf in metadata.get('flask').items()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -49,7 +49,7 @@ files['/etc/gitea/app.ini'] = {
|
||||||
),
|
),
|
||||||
'owner': 'git',
|
'owner': 'git',
|
||||||
'mode': '0600',
|
'mode': '0600',
|
||||||
'context': node.metadata.get('gitea'),
|
'context': node.metadata['gitea'],
|
||||||
'triggers': {
|
'triggers': {
|
||||||
'svc_systemd:gitea:restart',
|
'svc_systemd:gitea:restart',
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -127,7 +127,7 @@ for dashboard_id, monitored_node in enumerate(monitored_nodes, start=1):
|
||||||
panel['gridPos']['y'] = (row_id - 1) * panel['gridPos']['h']
|
panel['gridPos']['y'] = (row_id - 1) * panel['gridPos']['h']
|
||||||
|
|
||||||
if 'display_name' in panel_config:
|
if 'display_name' in panel_config:
|
||||||
panel['fieldConfig']['defaults']['displayName'] = panel_config['display_name']
|
panel['fieldConfig']['defaults']['displayName'] = '${'+panel_config['display_name']+'}'
|
||||||
|
|
||||||
if panel_config.get('stacked'):
|
if panel_config.get('stacked'):
|
||||||
panel['fieldConfig']['defaults']['custom']['stacking']['mode'] = 'normal'
|
panel['fieldConfig']['defaults']['custom']['stacking']['mode'] = 'normal'
|
||||||
|
|
@ -158,14 +158,13 @@ for dashboard_id, monitored_node in enumerate(monitored_nodes, start=1):
|
||||||
host=monitored_node.name,
|
host=monitored_node.name,
|
||||||
negative=query_config.get('negative', False),
|
negative=query_config.get('negative', False),
|
||||||
boolean_to_int=query_config.get('boolean_to_int', False),
|
boolean_to_int=query_config.get('boolean_to_int', False),
|
||||||
over=query_config.get('over', None),
|
minimum=query_config.get('minimum', None),
|
||||||
filters={
|
filters={
|
||||||
'host': monitored_node.name,
|
'host': monitored_node.name,
|
||||||
**query_config['filters'],
|
**query_config['filters'],
|
||||||
},
|
},
|
||||||
exists=query_config.get('exists', []),
|
exists=query_config.get('exists', []),
|
||||||
function=query_config.get('function', None),
|
function=query_config.get('function', None),
|
||||||
multiply=query_config.get('multiply', None),
|
|
||||||
).strip()
|
).strip()
|
||||||
})
|
})
|
||||||
|
|
||||||
|
|
@ -179,3 +178,4 @@ for dashboard_id, monitored_node in enumerate(monitored_nodes, start=1):
|
||||||
'svc_systemd:grafana-server:restart',
|
'svc_systemd:grafana-server:restart',
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -69,6 +69,9 @@ defaults = {
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
'nginx': {
|
||||||
|
'has_websockets': True,
|
||||||
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -139,7 +142,6 @@ def dns(metadata):
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'nginx/has_websockets',
|
|
||||||
'nginx/vhosts',
|
'nginx/vhosts',
|
||||||
)
|
)
|
||||||
def nginx(metadata):
|
def nginx(metadata):
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@ files = {
|
||||||
'/usr/local/share/telegraf/cpu_frequency': {
|
'/usr/local/share/telegraf/cpu_frequency': {
|
||||||
'mode': '0755',
|
'mode': '0755',
|
||||||
'triggers': {
|
'triggers': {
|
||||||
'svc_systemd:telegraf.service:restart',
|
'svc_systemd:telegraf:restart',
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -14,25 +14,25 @@ defaults = {
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'telegraf': {
|
'telegraf': {
|
||||||
'inputs': {
|
'config': {
|
||||||
'sensors': {
|
'inputs': {
|
||||||
'default': {
|
'sensors': {repo.libs.hashable.hashable({
|
||||||
'timeout': '2s',
|
'timeout': '2s',
|
||||||
|
})},
|
||||||
|
'exec': {
|
||||||
|
repo.libs.hashable.hashable({
|
||||||
|
'commands': ["sudo /usr/local/share/telegraf/cpu_frequency"],
|
||||||
|
'name_override': "cpu_frequency",
|
||||||
|
'data_format': "influx",
|
||||||
|
}),
|
||||||
|
# repo.libs.hashable.hashable({
|
||||||
|
# 'commands': ["/bin/bash -c 'expr $(cat /sys/class/thermal/thermal_zone0/temp) / 1000'"],
|
||||||
|
# 'name_override': "cpu_temperature",
|
||||||
|
# 'data_format': "value",
|
||||||
|
# 'data_type': "integer",
|
||||||
|
# }),
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'exec': {
|
|
||||||
'cpu_frequency': {
|
|
||||||
'commands': ["sudo /usr/local/share/telegraf/cpu_frequency"],
|
|
||||||
'name_override': "cpu_frequency",
|
|
||||||
'data_format': "influx",
|
|
||||||
},
|
|
||||||
# repo.libs.hashable.hashable({
|
|
||||||
# 'commands': ["/bin/bash -c 'expr $(cat /sys/class/thermal/thermal_zone0/temp) / 1000'"],
|
|
||||||
# 'name_override': "cpu_temperature",
|
|
||||||
# 'data_format': "value",
|
|
||||||
# 'data_type': "integer",
|
|
||||||
# }),
|
|
||||||
},
|
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
|
||||||
23
bundles/homeassistant-supervised/README.md
Normal file
23
bundles/homeassistant-supervised/README.md
Normal file
|
|
@ -0,0 +1,23 @@
|
||||||
|
https://github.com/home-assistant/supervised-installer?tab=readme-ov-file
|
||||||
|
https://github.com/home-assistant/os-agent/tree/main?tab=readme-ov-file#using-home-assistant-supervised-on-debian
|
||||||
|
https://docs.docker.com/engine/install/debian/
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
https://www.home-assistant.io/installation/linux#install-home-assistant-supervised
|
||||||
|
https://github.com/home-assistant/supervised-installer
|
||||||
|
https://github.com/home-assistant/architecture/blob/master/adr/0014-home-assistant-supervised.md
|
||||||
|
|
||||||
|
DATA_SHARE=/usr/share/hassio dpkg --force-confdef --force-confold -i homeassistant-supervised.deb
|
||||||
|
|
||||||
|
neu debian
|
||||||
|
ha installieren
|
||||||
|
gucken ob geht
|
||||||
|
dann bw drüberbügeln
|
||||||
|
|
||||||
|
|
||||||
|
https://www.home-assistant.io/integrations/http/#ssl_certificate
|
||||||
|
|
||||||
|
`wget "$(curl -L https://api.github.com/repos/home-assistant/supervised-installer/releases/latest | jq -r '.assets[0].browser_download_url')" -O homeassistant-supervised.deb && dpkg -i homeassistant-supervised.deb`
|
||||||
30
bundles/homeassistant-supervised/items.py
Normal file
30
bundles/homeassistant-supervised/items.py
Normal file
|
|
@ -0,0 +1,30 @@
|
||||||
|
from shlex import quote
|
||||||
|
|
||||||
|
|
||||||
|
version = node.metadata.get('homeassistant/os_agent_version')
|
||||||
|
|
||||||
|
directories = {
|
||||||
|
'/usr/share/hassio': {},
|
||||||
|
}
|
||||||
|
|
||||||
|
actions = {
|
||||||
|
'install_os_agent': {
|
||||||
|
'command': ' && '.join([
|
||||||
|
f'wget -O /tmp/os-agent.deb https://github.com/home-assistant/os-agent/releases/download/{quote(version)}/os-agent_{quote(version)}_linux_aarch64.deb',
|
||||||
|
'DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/os-agent.deb',
|
||||||
|
]),
|
||||||
|
'unless': f'test "$(apt -qq list os-agent | cut -d" " -f2)" = "{quote(version)}"',
|
||||||
|
'needs': {
|
||||||
|
'pkg_apt:',
|
||||||
|
'zfs_dataset:tank/homeassistant',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
'install_homeassistant_supervised': {
|
||||||
|
'command': 'wget -O /tmp/homeassistant-supervised.deb https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb && apt install /tmp/homeassistant-supervised.deb',
|
||||||
|
'unless': 'apt -qq list homeassistant-supervised | grep -q "installed"',
|
||||||
|
'needs': {
|
||||||
|
'action:install_os_agent',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
65
bundles/homeassistant-supervised/metadata.py
Normal file
65
bundles/homeassistant-supervised/metadata.py
Normal file
|
|
@ -0,0 +1,65 @@
|
||||||
|
defaults = {
|
||||||
|
'apt': {
|
||||||
|
'packages': {
|
||||||
|
# homeassistant-supervised
|
||||||
|
'apparmor': {},
|
||||||
|
'bluez': {},
|
||||||
|
'cifs-utils': {},
|
||||||
|
'curl': {},
|
||||||
|
'dbus': {},
|
||||||
|
'jq': {},
|
||||||
|
'libglib2.0-bin': {},
|
||||||
|
'lsb-release': {},
|
||||||
|
'network-manager': {},
|
||||||
|
'nfs-common': {},
|
||||||
|
'systemd-journal-remote': {},
|
||||||
|
'systemd-resolved': {},
|
||||||
|
'udisks2': {},
|
||||||
|
'wget': {},
|
||||||
|
# docker
|
||||||
|
'docker-ce': {},
|
||||||
|
'docker-ce-cli': {},
|
||||||
|
'containerd.io': {},
|
||||||
|
'docker-buildx-plugin': {},
|
||||||
|
'docker-compose-plugin': {},
|
||||||
|
},
|
||||||
|
'sources': {
|
||||||
|
# docker: https://docs.docker.com/engine/install/debian/#install-using-the-repository
|
||||||
|
'docker': {
|
||||||
|
'urls': {
|
||||||
|
'https://download.docker.com/linux/debian',
|
||||||
|
},
|
||||||
|
'suites': {
|
||||||
|
'{codename}',
|
||||||
|
},
|
||||||
|
'components': {
|
||||||
|
'stable',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
'zfs': {
|
||||||
|
'datasets': {
|
||||||
|
'tank/homeassistant': {
|
||||||
|
'mountpoint': '/usr/share/hassio',
|
||||||
|
'needed_by': {
|
||||||
|
'directory:/usr/share/hassio',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
@metadata_reactor.provides(
|
||||||
|
'nginx/vhosts',
|
||||||
|
)
|
||||||
|
def nginx(metadata):
|
||||||
|
return {
|
||||||
|
'nginx': {
|
||||||
|
'vhosts': {
|
||||||
|
metadata.get('homeassistant/domain'): {
|
||||||
|
'content': 'homeassistant/vhost.conf',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
@ -179,7 +179,6 @@ def nginx(metadata):
|
||||||
'context': {
|
'context': {
|
||||||
'php_version': metadata.get('php/version'),
|
'php_version': metadata.get('php/version'),
|
||||||
},
|
},
|
||||||
'check_path': '/icingaweb2/index.php',
|
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -39,17 +39,6 @@ defaults = {
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
if node.has_bundle('zfs'):
|
|
||||||
defaults['zfs'] = {
|
|
||||||
'datasets': {
|
|
||||||
'tank/influxdb': {
|
|
||||||
'mountpoint': '/var/lib/influxdb',
|
|
||||||
'recordsize': '8192',
|
|
||||||
'atime': 'off',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'influxdb/password',
|
'influxdb/password',
|
||||||
'influxdb/admin_token',
|
'influxdb/admin_token',
|
||||||
|
|
@ -63,6 +52,26 @@ def admin_password(metadata):
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@metadata_reactor.provides(
|
||||||
|
'zfs/datasets',
|
||||||
|
)
|
||||||
|
def zfs(metadata):
|
||||||
|
if not node.has_bundle('zfs'):
|
||||||
|
return {}
|
||||||
|
|
||||||
|
return {
|
||||||
|
'zfs': {
|
||||||
|
'datasets': {
|
||||||
|
'tank/influxdb': {
|
||||||
|
'mountpoint': '/var/lib/influxdb',
|
||||||
|
'recordsize': '8192',
|
||||||
|
'atime': 'off',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'dns',
|
'dns',
|
||||||
)
|
)
|
||||||
|
|
|
||||||
|
|
@ -52,14 +52,13 @@ def subnets(metadata):
|
||||||
if 'mac' in network_conf
|
if 'mac' in network_conf
|
||||||
)
|
)
|
||||||
|
|
||||||
for id, (network_name, network_conf) in enumerate(sorted(metadata.get('network').items())):
|
for network_name, network_conf in metadata.get('network').items():
|
||||||
dhcp_server_config = network_conf.get('dhcp_server_config', None)
|
dhcp_server_config = network_conf.get('dhcp_server_config', None)
|
||||||
|
|
||||||
if dhcp_server_config:
|
if dhcp_server_config:
|
||||||
_network = ip_network(dhcp_server_config['subnet'])
|
_network = ip_network(dhcp_server_config['subnet'])
|
||||||
|
|
||||||
subnet4.add(hashable({
|
subnet4.add(hashable({
|
||||||
'id': id + 1,
|
|
||||||
'subnet': dhcp_server_config['subnet'],
|
'subnet': dhcp_server_config['subnet'],
|
||||||
'pools': [
|
'pools': [
|
||||||
{
|
{
|
||||||
|
|
@ -73,7 +72,7 @@ def subnets(metadata):
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
'name': 'domain-name-servers',
|
'name': 'domain-name-servers',
|
||||||
'data': '10.0.0.1',
|
'data': '10.0.10.2',
|
||||||
},
|
},
|
||||||
],
|
],
|
||||||
'reservations': set(
|
'reservations': set(
|
||||||
|
|
|
||||||
|
|
@ -1,22 +1,58 @@
|
||||||
https://github.com/SirPlease/L4D2-Competitive-Rework/blob/master/Dedicated%20Server%20Install%20Guide/README.md
|
https://developer.valvesoftware.com/wiki/List_of_L4D2_Cvars
|
||||||
|
|
||||||
```python
|
Dead Center c1m1_hotel
|
||||||
'tick60_maps': {
|
Dead Center c1m2_streets
|
||||||
'port': 27030,
|
Dead Center c1m3_mall
|
||||||
# add command line arguments
|
Dead Center c1m4_atrium
|
||||||
'arguments': ['-tickrate 60'],
|
Dark Carnival c2m1_highway
|
||||||
# stack overlays, first is uppermost
|
Dark Carnival c2m2_fairgrounds
|
||||||
'overlays': ['tickrate', 'standard'],
|
Dark Carnival c2m3_coaster
|
||||||
# server.cfg contents
|
Dark Carnival c2m4_barns
|
||||||
'config': [
|
Dark Carnival c2m5_concert
|
||||||
# configs from overlays are accessible via server_${overlay}.cfg
|
Swamp Fever c3m1_plankcountry
|
||||||
'exec server_tickrate.cfg',
|
Swamp Fever c3m2_swamp
|
||||||
# add more options
|
Swamp Fever c3m3_shantytown
|
||||||
'sv_minupdaterate 101',
|
Swamp Fever c3m4_plantation
|
||||||
'sv_maxupdaterate 101',
|
Hard Rain c4m1_milltown_a
|
||||||
'sv_mincmdrate 101',
|
Hard Rain c4m2_sugarmill_a
|
||||||
'sv_maxcmdrate 101',
|
Hard Rain c4m3_sugarmill_b
|
||||||
'sv_consistency 0',
|
Hard Rain c4m4_milltown_b
|
||||||
],
|
Hard Rain c4m5_milltown_escape
|
||||||
},
|
The Parish c5m1_waterfront_sndscape
|
||||||
```
|
The Parish c5m1_waterfront
|
||||||
|
The Parish c5m2_park
|
||||||
|
The Parish c5m3_cemetery
|
||||||
|
The Parish c5m4_quarter
|
||||||
|
The Parish c5m5_bridge
|
||||||
|
The Passing c6m1_riverbank
|
||||||
|
The Passing c6m2_bedlam
|
||||||
|
The Passing c6m3_port
|
||||||
|
The Sacrifice c7m1_docks
|
||||||
|
The Sacrifice c7m2_barge
|
||||||
|
The Sacrifice c7m3_port
|
||||||
|
No Mercy c8m1_apartment
|
||||||
|
No Mercy c8m2_subway
|
||||||
|
No Mercy c8m3_sewers
|
||||||
|
No Mercy c8m4_interior
|
||||||
|
No Mercy c8m5_rooftop
|
||||||
|
Crash Course c9m1_alleys
|
||||||
|
Crash Course c9m2_lots
|
||||||
|
Death Toll c10m1_caves
|
||||||
|
Death Toll c10m2_drainage
|
||||||
|
Death Toll c10m3_ranchhouse
|
||||||
|
Death Toll c10m4_mainstreet
|
||||||
|
Death Toll c10m5_houseboat
|
||||||
|
Dead Air c11m1_greenhouse
|
||||||
|
Dead Air c11m2_offices
|
||||||
|
Dead Air c11m3_garage
|
||||||
|
Dead Air c11m4_terminal
|
||||||
|
Dead Air c11m5_runway
|
||||||
|
Blood Harvest c12m1_hilltop
|
||||||
|
Blood Harvest c12m2_traintunnel
|
||||||
|
Blood Harvest c12m3_bridge
|
||||||
|
Blood Harvest c12m4_barn
|
||||||
|
Blood Harvest c12m5_cornfield
|
||||||
|
Cold Stream c13m1_alpinecreek
|
||||||
|
Cold Stream c13m2_southpinestream
|
||||||
|
Cold Stream c13m3_memorialbridge
|
||||||
|
Cold Stream c13m4_cutthroatcreek
|
||||||
|
|
|
||||||
|
|
@ -1,13 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
set -xeuo pipefail
|
|
||||||
|
|
||||||
function steam() {
|
|
||||||
# for systemd, so it can terminate the process (for other things sudo would have been enough)
|
|
||||||
setpriv --reuid=steam --regid=steam --init-groups "$@" <&0
|
|
||||||
export HOME=/opt/l4d2/steam
|
|
||||||
}
|
|
||||||
|
|
||||||
function workshop() {
|
|
||||||
steam mkdir -p "/opt/l4d2/overlays/${overlay}/left4dead2/addons"
|
|
||||||
steam /opt/l4d2/scripts/steam-workshop-download --out "/opt/l4d2/overlays/${overlay}/left4dead2/addons" "$@"
|
|
||||||
}
|
|
||||||
|
|
@ -1,10 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
set -xeuo pipefail
|
|
||||||
source /opt/l4d2/scripts/helpers
|
|
||||||
overlay=$(basename "$0")
|
|
||||||
|
|
||||||
# https://github.com/SirPlease/L4D2-Competitive-Rework
|
|
||||||
|
|
||||||
steam mkdir -p /opt/l4d2/overlays/$overlay/left4dead2
|
|
||||||
test -d /opt/l4d2/overlays/$overlay/left4dead2/cfg/cfgogl || \
|
|
||||||
curl -L https://github.com/SirPlease/L4D2-Competitive-Rework/archive/refs/heads/master.tar.gz | steam tar -xz --strip-components=1 -C /opt/l4d2/overlays/$overlay/left4dead2
|
|
||||||
|
|
@ -1,128 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
set -xeuo pipefail
|
|
||||||
source /opt/l4d2/scripts/helpers
|
|
||||||
overlay=$(basename "$0")
|
|
||||||
|
|
||||||
steam mkdir -p /opt/l4d2/overlays/$overlay/left4dead2/addons
|
|
||||||
cd /opt/l4d2/overlays/$overlay/left4dead2/addons
|
|
||||||
|
|
||||||
# https://l4d2center.com/maps/servers/l4d2center_maps_sync.sh.txt ->
|
|
||||||
|
|
||||||
# Exit immediately if a command exits with a non-zero status.
|
|
||||||
set -e
|
|
||||||
|
|
||||||
# Function to print error messages
|
|
||||||
error_exit() {
|
|
||||||
echo "Error: $1" >&2
|
|
||||||
exit 1
|
|
||||||
}
|
|
||||||
|
|
||||||
# Check if the current directory ends with /left4dead2/addons
|
|
||||||
current_dir=$(pwd)
|
|
||||||
expected_dir="/left4dead2/addons"
|
|
||||||
|
|
||||||
if [[ ! "$current_dir" == *"$expected_dir" ]]; then
|
|
||||||
error_exit "Script must be run from your L4D2 \"addons\" folder. Current directory: $current_dir"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Check for required commands
|
|
||||||
for cmd in curl md5sum 7z; do
|
|
||||||
if ! command -v "$cmd" >/dev/null 2>&1; then
|
|
||||||
error_exit "Required command '$cmd' is not installed. Please install it and retry."
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
# URL of the CSV file
|
|
||||||
CSV_URL="https://l4d2center.com/maps/servers/index.csv"
|
|
||||||
|
|
||||||
# Temporary file to store CSV
|
|
||||||
TEMP_CSV=$(mktemp)
|
|
||||||
|
|
||||||
# Ensure temporary file is removed on exit
|
|
||||||
trap 'rm -f "$TEMP_CSV"' EXIT
|
|
||||||
|
|
||||||
echo "Downloading CSV from $CSV_URL..."
|
|
||||||
curl -sSL -o "$TEMP_CSV" "$CSV_URL" || error_exit "Failed to download CSV."
|
|
||||||
|
|
||||||
declare -A map_md5
|
|
||||||
declare -A map_links
|
|
||||||
|
|
||||||
# Read CSV and populate associative arrays
|
|
||||||
{
|
|
||||||
# Skip the first line (header)
|
|
||||||
IFS= read -r header
|
|
||||||
|
|
||||||
while IFS=';' read -r Name Size MD5 DownloadLink || [[ $Name ]]; do
|
|
||||||
# Trim whitespace
|
|
||||||
Name=$(echo "$Name" | xargs)
|
|
||||||
MD5=$(echo "$MD5" | xargs)
|
|
||||||
DownloadLink=$(echo "$DownloadLink" | xargs)
|
|
||||||
|
|
||||||
# Populate associative arrays
|
|
||||||
map_md5["$Name"]="$MD5"
|
|
||||||
map_links["$Name"]="$DownloadLink"
|
|
||||||
done
|
|
||||||
} < "$TEMP_CSV"
|
|
||||||
|
|
||||||
# Get list of expected VPK files
|
|
||||||
expected_vpk=("${!map_md5[@]}")
|
|
||||||
|
|
||||||
# Remove VPK files not in expected list or with mismatched MD5
|
|
||||||
echo "Cleaning up existing VPK files..."
|
|
||||||
for file in *.vpk; do
|
|
||||||
# Check if it's a regular file
|
|
||||||
if [[ -f "$file" ]]; then
|
|
||||||
if [[ -z "${map_md5["$file"]}" ]]; then
|
|
||||||
echo "Removing unexpected file: $file"
|
|
||||||
rm -f "$file"
|
|
||||||
else
|
|
||||||
# Calculate MD5
|
|
||||||
echo "Calculating MD5 for existing file: $file..."
|
|
||||||
current_md5=$(md5sum "$file" | awk '{print $1}')
|
|
||||||
expected_md5="${map_md5["$file"]}"
|
|
||||||
|
|
||||||
if [[ "$current_md5" != "$expected_md5" ]]; then
|
|
||||||
echo "MD5 mismatch for $file. Removing."
|
|
||||||
rm -f "$file"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
# Download and extract missing or updated VPK files
|
|
||||||
echo "Processing required VPK files..."
|
|
||||||
for vpk in "${expected_vpk[@]}"; do
|
|
||||||
if [[ ! -f "$vpk" ]]; then
|
|
||||||
echo "Downloading and extracting $vpk..."
|
|
||||||
download_url="${map_links["$vpk"]}"
|
|
||||||
|
|
||||||
if [[ -z "$download_url" ]]; then
|
|
||||||
echo "No download link found for $vpk. Skipping."
|
|
||||||
continue
|
|
||||||
fi
|
|
||||||
|
|
||||||
encoded_url=$(echo "$download_url" | sed 's/ /%20/g')
|
|
||||||
|
|
||||||
# Download the .7z file to a temporary location
|
|
||||||
TEMP_7Z=$(mktemp --suffix=.7z)
|
|
||||||
curl -# -L -o "$TEMP_7Z" "$encoded_url"
|
|
||||||
|
|
||||||
# Check if the download was successful
|
|
||||||
if [[ $? -ne 0 ]]; then
|
|
||||||
echo "Failed to download $download_url. Skipping."
|
|
||||||
rm -f "$TEMP_7Z"
|
|
||||||
continue
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Extract the .7z file
|
|
||||||
7z x -y "$TEMP_7Z" || { echo "Failed to extract $TEMP_7Z. Skipping."; rm -f "$TEMP_7Z"; continue; }
|
|
||||||
|
|
||||||
# Remove the temporary .7z file
|
|
||||||
rm -f "$TEMP_7Z"
|
|
||||||
|
|
||||||
else
|
|
||||||
echo "$vpk is already up to date."
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
echo "Synchronization complete."
|
|
||||||
|
|
@ -1,12 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
set -xeuo pipefail
|
|
||||||
source /opt/l4d2/scripts/helpers
|
|
||||||
overlay=$(basename "$0")
|
|
||||||
|
|
||||||
# Ions Vocalizer
|
|
||||||
workshop -i 698857882
|
|
||||||
|
|
||||||
# admin system
|
|
||||||
workshop --item 2524204971
|
|
||||||
steam mkdir -p "/opt/l4d2/overlays/${overlay}/left4dead2/ems/admin system"
|
|
||||||
steam echo "STEAM_1:0:12376499" > "/opt/l4d2/overlays/${overlay}/left4dead2/ems/admin system/admins.txt"
|
|
||||||
|
|
@ -1,25 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
set -xeuo pipefail
|
|
||||||
source /opt/l4d2/scripts/helpers
|
|
||||||
overlay=$(basename "$0")
|
|
||||||
|
|
||||||
# server config
|
|
||||||
# https://github.com/SirPlease/L4D2-Competitive-Rework/blob/7ecc3a32a5e2180d6607a40119ff2f3c072502a9/cfg/server.cfg#L58-L69
|
|
||||||
# https://www.programmersought.com/article/513810199514/
|
|
||||||
steam mkdir -p /opt/l4d2/overlays/$overlay/left4dead2/cfg
|
|
||||||
steam cat <<'EOF' > /opt/l4d2/overlays/$overlay/left4dead2/cfg/server.cfg
|
|
||||||
# https://github.com/SirPlease/L4D2-Competitive-Rework/blob/7ecc3a32a5e2180d6607a40119ff2f3c072502a9/cfg/server.cfg#L58-L69
|
|
||||||
sv_minrate 100000
|
|
||||||
sv_maxrate 100000
|
|
||||||
nb_update_frequency 0.014
|
|
||||||
net_splitpacket_maxrate 50000
|
|
||||||
net_maxcleartime 0.0001
|
|
||||||
fps_max 0
|
|
||||||
EOF
|
|
||||||
|
|
||||||
# install tickrate enabler
|
|
||||||
steam mkdir -p "/opt/l4d2/overlays/${overlay}/left4dead2/addons"
|
|
||||||
for file in tickrate_enabler.dll tickrate_enabler.so tickrate_enabler.vdf
|
|
||||||
do
|
|
||||||
curl -L "https://github.com/SirPlease/L4D2-Competitive-Rework/raw/refs/heads/master/addons/${file}" -o "/opt/l4d2/overlays/${overlay}/left4dead2/addons/${file}"
|
|
||||||
done
|
|
||||||
|
|
@ -1,13 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
set -xeuo pipefail
|
|
||||||
source /opt/l4d2/scripts/helpers
|
|
||||||
overlay=$(basename "$0")
|
|
||||||
|
|
||||||
# workshop --collection 121115793 # Back To School
|
|
||||||
|
|
||||||
# workshop --item 2957035482 # hehe30-part1
|
|
||||||
# workshop --item 2973628334 # hehe30-part2
|
|
||||||
# workshop --item 3013844371 # hehe30-part3
|
|
||||||
|
|
||||||
# workshop --item 3478461158 # 虚伪黎明(Dawn's Deception)
|
|
||||||
# workshop --item 3478934394 # 虚伪黎明(Dawn's Deception)PART2
|
|
||||||
|
|
@ -1,13 +1,40 @@
|
||||||
// defaults
|
hostname "CroneKorkN : ${name}"
|
||||||
hostname ${server_name}
|
sv_contact "admin@sublimity.de"
|
||||||
|
|
||||||
|
|
||||||
|
sv_steamgroup "${','.join(steamgroups)}"
|
||||||
|
|
||||||
|
rcon_password "${rcon_password}"
|
||||||
|
|
||||||
|
|
||||||
motd_enabled 0
|
motd_enabled 0
|
||||||
rcon_password ${rcon_password}
|
|
||||||
sv_steamgroup "38347879"
|
|
||||||
|
|
||||||
mp_autoteambalance 0
|
|
||||||
sv_forcepreload 1
|
|
||||||
|
|
||||||
// server specific
|
sv_cheats 1
|
||||||
% for line in config:
|
|
||||||
${line}
|
|
||||||
% endfor
|
sv_consistency 0
|
||||||
|
|
||||||
|
|
||||||
|
sv_lan 0
|
||||||
|
|
||||||
|
|
||||||
|
sv_allow_lobby_connect_only 0
|
||||||
|
|
||||||
|
|
||||||
|
sv_gametypes "coop,realism,survival,versus,teamversus,scavenge,teamscavenge"
|
||||||
|
|
||||||
|
|
||||||
|
sv_minrate 30000
|
||||||
|
sv_maxrate 60000
|
||||||
|
sv_mincmdrate 66
|
||||||
|
sv_maxcmdrate 101
|
||||||
|
|
||||||
|
|
||||||
|
sv_logsdir "logs-${name}" //Folder in the game directory where server logs will be stored.
|
||||||
|
log on //Creates a logfile (on | off)
|
||||||
|
sv_logecho 0 //default 0; Echo log information to the console.
|
||||||
|
sv_logfile 1 //default 1; Log server information in the log file.
|
||||||
|
sv_log_onefile 0 //default 0; Log server information to only one file.
|
||||||
|
sv_logbans 1 //default 0;Log server bans in the server logs.
|
||||||
|
sv_logflush 0 //default 0; Flush the log files to disk on each write (slow).
|
||||||
|
|
|
||||||
|
|
@ -1,72 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
|
|
||||||
set -xeuo pipefail
|
|
||||||
|
|
||||||
# -- DEFINE FUNCTIONS AND VARIABLES -- #
|
|
||||||
|
|
||||||
function steam() {
|
|
||||||
# for systemd, so it can terminate the process (for other things sudo would have been enough)
|
|
||||||
setpriv --reuid=steam --regid=steam --init-groups "$@" <&0
|
|
||||||
export HOME=/opt/l4d2/steam
|
|
||||||
}
|
|
||||||
|
|
||||||
# -- PREPARE SYSTEM -- #
|
|
||||||
|
|
||||||
getent passwd steam >/dev/null || useradd -M -d /opt/l4d2 -s /bin/bash steam
|
|
||||||
mkdir -p /opt/l4d2 /tmp/dumps
|
|
||||||
chown steam:steam /opt/l4d2 /tmp/dumps
|
|
||||||
dpkg --add-architecture i386
|
|
||||||
apt update
|
|
||||||
DEBIAN_FRONTEND=noninteractive apt install -y libc6:i386 lib32z1
|
|
||||||
|
|
||||||
# workshop downloader
|
|
||||||
test -f /opt/l4d2/scripts/steam-workshop-download || \
|
|
||||||
steam wget -4 https://git.sublimity.de/cronekorkn/steam-workshop-downloader/raw/branch/master/steam-workshop-download -P /opt/l4d2/scripts
|
|
||||||
steam chmod +x /opt/l4d2/scripts/steam-workshop-download
|
|
||||||
|
|
||||||
# -- STEAM -- #
|
|
||||||
|
|
||||||
steam mkdir -p /opt/l4d2/steam
|
|
||||||
test -f /opt/l4d2/steam/steamcmd_linux.tar.gz || \
|
|
||||||
steam wget http://media.steampowered.com/installer/steamcmd_linux.tar.gz -P /opt/l4d2/steam
|
|
||||||
test -f /opt/l4d2/steam/steamcmd.sh || \
|
|
||||||
steam tar -xvzf /opt/l4d2/steam/steamcmd_linux.tar.gz -C /opt/l4d2/steam
|
|
||||||
|
|
||||||
# fix for: /opt/l4d2/.steam/sdk32/steamclient.so: cannot open shared object file: No such file or directory
|
|
||||||
steam mkdir -p /opt/l4d2/steam/.steam # needs to be in steam users home dir
|
|
||||||
readlink /opt/l4d2/steam/.steam/sdk32 | grep -q ^/opt/l4d2/steam/linux32$ || \
|
|
||||||
steam ln -sf /opt/l4d2/steam/linux32 /opt/l4d2/steam/.steam/sdk32
|
|
||||||
readlink /opt/l4d2/steam/.steam/sdk64 | grep -q ^/opt/l4d2/steam/linux64$ || \
|
|
||||||
steam ln -sf /opt/l4d2/steam/linux64 /opt/l4d2/steam/.steam/sdk64
|
|
||||||
|
|
||||||
# -- INSTALL -- #
|
|
||||||
|
|
||||||
# erst die windows deps zu installieren scheint ein workaround für x64 zu sein?
|
|
||||||
steam mkdir -p /opt/l4d2/installation
|
|
||||||
steam /opt/l4d2/steam/steamcmd.sh \
|
|
||||||
+force_install_dir /opt/l4d2/installation \
|
|
||||||
+login anonymous \
|
|
||||||
+@sSteamCmdForcePlatformType windows \
|
|
||||||
+app_update 222860 validate \
|
|
||||||
+quit
|
|
||||||
steam /opt/l4d2/steam/steamcmd.sh \
|
|
||||||
+force_install_dir /opt/l4d2/installation \
|
|
||||||
+login anonymous \
|
|
||||||
+@sSteamCmdForcePlatformType linux \
|
|
||||||
+app_update 222860 validate \
|
|
||||||
+quit
|
|
||||||
|
|
||||||
# -- OVERLAYS -- #
|
|
||||||
|
|
||||||
for overlay_path in /opt/l4d2/scripts/overlays/*; do
|
|
||||||
overlay=$(basename "$overlay_path")
|
|
||||||
steam mkdir -p /opt/l4d2/overlays/$overlay
|
|
||||||
bash -xeuo pipefail "$overlay_path"
|
|
||||||
test -f /opt/l4d2/overlays/$overlay/left4dead2/cfg/server.cfg && \
|
|
||||||
steam cp /opt/l4d2/overlays/$overlay/left4dead2/cfg/server.cfg /opt/l4d2/overlays/$overlay/left4dead2/cfg/server_$overlay.cfg
|
|
||||||
done
|
|
||||||
|
|
||||||
# -- SERVERS -- #
|
|
||||||
|
|
||||||
#steam rm -rf /opt/l4d2/servers
|
|
||||||
steam mkdir -p /opt/l4d2/servers
|
|
||||||
|
|
@ -1,75 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
|
|
||||||
set -xeuo pipefail
|
|
||||||
|
|
||||||
name=""
|
|
||||||
port=""
|
|
||||||
configfile=""
|
|
||||||
overlays=""
|
|
||||||
arguments=""
|
|
||||||
|
|
||||||
while [[ $# -gt 0 ]]; do
|
|
||||||
case "$1" in
|
|
||||||
-n|--name)
|
|
||||||
name="$2"; shift 2
|
|
||||||
;;
|
|
||||||
-p|--port)
|
|
||||||
port="$2"; shift 2
|
|
||||||
;;
|
|
||||||
-c|--config)
|
|
||||||
configfile="$2"; shift 2
|
|
||||||
;;
|
|
||||||
-o|--overlay)
|
|
||||||
overlays="/opt/l4d2/overlays/$2:$overlays"; shift 2
|
|
||||||
;;
|
|
||||||
--)
|
|
||||||
shift
|
|
||||||
arguments+="$@"
|
|
||||||
break
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
echo "ERROR: unknown argument $1"; exit 1
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
done
|
|
||||||
|
|
||||||
[[ -n "${name}" ]] || { echo "ERROR: -n/--name missing"; exit 1; }
|
|
||||||
[[ -n "${port}" ]] || { echo "ERROR: -p/--port missing"; exit 1; }
|
|
||||||
|
|
||||||
# -- HELPER FUNCTIONS -- #
|
|
||||||
|
|
||||||
function steam() {
|
|
||||||
# für systemd, damit es den prozess beenden kann
|
|
||||||
setpriv --reuid=steam --regid=steam --init-groups "$@"
|
|
||||||
export HOME=/opt/l4d2/steam
|
|
||||||
}
|
|
||||||
|
|
||||||
# -- TIDY UP -- #
|
|
||||||
|
|
||||||
mountpoint -q "/opt/l4d2/servers/$name/merged" && umount "/opt/l4d2/servers/$name/merged"
|
|
||||||
steam rm -rf "/opt/l4d2/servers/$name"
|
|
||||||
|
|
||||||
# -- CREATE DIRECTORIES -- #
|
|
||||||
|
|
||||||
steam mkdir -p \
|
|
||||||
"/opt/l4d2/servers/$name" \
|
|
||||||
"/opt/l4d2/servers/$name/work" \
|
|
||||||
"/opt/l4d2/servers/$name/upper" \
|
|
||||||
"/opt/l4d2/servers/$name/merged"
|
|
||||||
|
|
||||||
# -- MOUNT OVERLAYFS -- #
|
|
||||||
|
|
||||||
mount -t overlay overlay \
|
|
||||||
-o "lowerdir=$overlays/opt/l4d2/installation,upperdir=/opt/l4d2/servers/$name/upper,workdir=/opt/l4d2/servers/$name/work" \
|
|
||||||
"/opt/l4d2/servers/$name/merged"
|
|
||||||
|
|
||||||
# -- REPLACE SERVER.CFG -- #
|
|
||||||
|
|
||||||
if [[ -n "$configfile" ]]; then
|
|
||||||
cp "$configfile" "/opt/l4d2/servers/$name/merged/left4dead2/cfg/server.cfg"
|
|
||||||
chown steam:steam "/opt/l4d2/servers/$name/merged/left4dead2/cfg/server.cfg"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# -- RUN L4D2 -- #
|
|
||||||
|
|
||||||
steam "/opt/l4d2/servers/$name/merged/srcds_run" -norestart -pidfile "/opt/l4d2/servers/$name/pid" -game left4dead2 -ip 0.0.0.0 -port "$port" +hostname "Crone_$name" +map c1m1_hotel $arguments
|
|
||||||
|
|
@ -1,19 +0,0 @@
|
||||||
#!/bin/bash
|
|
||||||
|
|
||||||
set -xeuo pipefail
|
|
||||||
|
|
||||||
name=""
|
|
||||||
|
|
||||||
while [[ $# -gt 0 ]]; do
|
|
||||||
case "$1" in
|
|
||||||
-n|--name)
|
|
||||||
name="$2"; shift 2
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
echo "ERROR: unknown argument $1"; exit 1
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
done
|
|
||||||
|
|
||||||
mountpoint -q "/opt/l4d2/servers/$name/merged" && umount "/opt/l4d2/servers/$name/merged"
|
|
||||||
steam rm -rf "/opt/l4d2/servers/$name"
|
|
||||||
|
|
@ -1,105 +1,122 @@
|
||||||
users = {
|
assert node.has_bundle('steam') and node.has_bundle('steam-workshop-download')
|
||||||
'steam': {
|
|
||||||
'home': '/opt/l4d2/steam',
|
|
||||||
'shell': '/bin/bash',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
directories = {
|
directories = {
|
||||||
'/opt/l4d2': {
|
'/opt/steam/left4dead2-servers': {
|
||||||
'owner': 'steam', 'group': 'steam',
|
'owner': 'steam',
|
||||||
},
|
'group': 'steam',
|
||||||
'/opt/l4d2/steam': {
|
'mode': '0755',
|
||||||
'owner': 'steam', 'group': 'steam',
|
|
||||||
},
|
|
||||||
'/opt/l4d2/configs': {
|
|
||||||
'owner': 'steam', 'group': 'steam',
|
|
||||||
'purge': True,
|
'purge': True,
|
||||||
},
|
},
|
||||||
'/opt/l4d2/scripts': {
|
# Current zfs doesnt support zfs upperdir. The support was added in October 2022. Move upperdir - unused anyway -
|
||||||
'owner': 'steam', 'group': 'steam',
|
# to another dir. Also move workdir alongside it, as it has to be on same fs.
|
||||||
},
|
'/opt/steam-zfs-overlay-workarounds': {
|
||||||
'/opt/l4d2/scripts/overlays': {
|
'owner': 'steam',
|
||||||
'owner': 'steam', 'group': 'steam',
|
'group': 'steam',
|
||||||
|
'mode': '0755',
|
||||||
'purge': True,
|
'purge': True,
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
files = {
|
# /opt/steam/steam/.steam/sdk32/steamclient.so: cannot open shared object file: No such file or directory
|
||||||
'/opt/l4d2/setup': {
|
symlinks = {
|
||||||
'mode': '755',
|
'/opt/steam/steam/.steam/sdk32': {
|
||||||
'triggers': {
|
'target': '/opt/steam/steam/linux32',
|
||||||
'svc_systemd:left4dead2-initialize.service:restart',
|
'owner': 'steam',
|
||||||
},
|
'group': 'steam',
|
||||||
},
|
}
|
||||||
'/opt/l4d2/start': {
|
|
||||||
'mode': '755',
|
|
||||||
'triggers': {
|
|
||||||
f'svc_systemd:left4dead2-{server_name}.service:restart'
|
|
||||||
for server_name in node.metadata.get('left4dead2/servers').keys()
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'/opt/l4d2/stop': {
|
|
||||||
'mode': '755',
|
|
||||||
'triggers': {
|
|
||||||
f'svc_systemd:left4dead2-{server_name}.service:restart'
|
|
||||||
for server_name in node.metadata.get('left4dead2/servers').keys()
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'/opt/l4d2/scripts/helpers': {
|
|
||||||
'source': 'scripts/helpers',
|
|
||||||
'mode': '755',
|
|
||||||
'triggers': {
|
|
||||||
'svc_systemd:left4dead2-initialize.service:restart',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
|
|
||||||
for overlay in node.metadata.get('left4dead2/overlays'):
|
#
|
||||||
files[f'/opt/l4d2/scripts/overlays/{overlay}'] = {
|
# SERVERS
|
||||||
'source': f'scripts/overlays/{overlay}',
|
#
|
||||||
'mode': '755',
|
|
||||||
'triggers': {
|
for name, config in node.metadata.get('left4dead2/servers').items():
|
||||||
'svc_systemd:left4dead2-initialize.service:restart',
|
|
||||||
},
|
#overlay
|
||||||
|
directories[f'/opt/steam/left4dead2-servers/{name}'] = {
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
|
}
|
||||||
|
directories[f'/opt/steam-zfs-overlay-workarounds/{name}/upper'] = {
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
|
}
|
||||||
|
directories[f'/opt/steam-zfs-overlay-workarounds/{name}/workdir'] = {
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
}
|
}
|
||||||
|
|
||||||
svc_systemd = {
|
# conf
|
||||||
'left4dead2-initialize.service': {
|
files[f'/opt/steam/left4dead2-servers/{name}/left4dead2/cfg/server.cfg'] = {
|
||||||
'enabled': True,
|
|
||||||
'running': None,
|
|
||||||
'needs': {
|
|
||||||
'tag:left4dead2-packages',
|
|
||||||
'file:/opt/l4d2/setup',
|
|
||||||
'file:/usr/local/lib/systemd/system/left4dead2-initialize.service',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
for server_name, config in node.metadata.get('left4dead2/servers').items():
|
|
||||||
files[f'/opt/l4d2/configs/{server_name}.cfg'] = {
|
|
||||||
'source': 'server.cfg',
|
|
||||||
'content_type': 'mako',
|
'content_type': 'mako',
|
||||||
|
'source': 'server.cfg',
|
||||||
'context': {
|
'context': {
|
||||||
'server_name': server_name,
|
'name': name,
|
||||||
'rcon_password': repo.vault.decrypt('encrypt$gAAAAABpAdZhxwJ47I1AXotuZmBvyZP1ecVTt9IXFkLI28JiVS74LKs9QdgIBz-FC-iXtIHHh_GVGxxKQZprn4UrXZcvZ57kCKxfHBs3cE2JiGnbWE8_mfs=').value,
|
'steamgroups': node.metadata.get('left4dead2/steamgroups'),
|
||||||
'config': config.get('config', []),
|
'rcon_password': config['rcon_password'],
|
||||||
},
|
},
|
||||||
'owner': 'steam',
|
'owner': 'steam',
|
||||||
'mode': '644',
|
'group': 'steam',
|
||||||
'triggers': {
|
'triggers': [
|
||||||
f'svc_systemd:left4dead2-{server_name}.service:restart',
|
f'svc_systemd:left4dead2-{name}.service:restart',
|
||||||
},
|
],
|
||||||
}
|
}
|
||||||
|
|
||||||
svc_systemd[f'left4dead2-{server_name}.service'] = {
|
# service
|
||||||
'enabled': True,
|
svc_systemd[f'left4dead2-{name}.service'] = {
|
||||||
'running': True,
|
'needs': [
|
||||||
'tags': {
|
f'file:/opt/steam/left4dead2-servers/{name}/left4dead2/cfg/server.cfg',
|
||||||
'left4dead2-servers',
|
f'file:/usr/local/lib/systemd/system/left4dead2-{name}.service',
|
||||||
},
|
],
|
||||||
'needs': {
|
}
|
||||||
'svc_systemd:left4dead2-initialize.service',
|
|
||||||
f'file:/usr/local/lib/systemd/system/left4dead2-{server_name}.service',
|
#
|
||||||
},
|
# ADDONS
|
||||||
|
#
|
||||||
|
|
||||||
|
# base
|
||||||
|
files[f'/opt/steam/left4dead2-servers/{name}/left4dead2/addons/readme.txt'] = {
|
||||||
|
'content_type': 'any',
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
|
}
|
||||||
|
directories[f'/opt/steam/left4dead2-servers/{name}/left4dead2/addons'] = {
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
|
'purge': True,
|
||||||
|
'triggers': [
|
||||||
|
f'svc_systemd:left4dead2-{name}.service:restart',
|
||||||
|
],
|
||||||
|
}
|
||||||
|
for id in [
|
||||||
|
*config.get('workshop', []),
|
||||||
|
*node.metadata.get('left4dead2/workshop'),
|
||||||
|
]:
|
||||||
|
files[f'/opt/steam/left4dead2-servers/{name}/left4dead2/addons/{id}.vpk'] = {
|
||||||
|
'content_type': 'any',
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
|
'triggers': [
|
||||||
|
f'svc_systemd:left4dead2-{name}.service:restart',
|
||||||
|
],
|
||||||
|
}
|
||||||
|
|
||||||
|
# admin system
|
||||||
|
|
||||||
|
directories[f'/opt/steam/left4dead2-servers/{name}/left4dead2/ems/admin system'] = {
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
|
'mode': '0755',
|
||||||
|
'triggers': [
|
||||||
|
f'svc_systemd:left4dead2-{name}.service:restart',
|
||||||
|
],
|
||||||
|
}
|
||||||
|
files[f'/opt/steam/left4dead2-servers/{name}/left4dead2/ems/admin system/admins.txt'] = {
|
||||||
|
'owner': 'steam',
|
||||||
|
'group': 'steam',
|
||||||
|
'mode': '0755',
|
||||||
|
'content': '\n'.join(sorted(node.metadata.get('left4dead2/admins'))),
|
||||||
|
'triggers': [
|
||||||
|
f'svc_systemd:left4dead2-{name}.service:restart',
|
||||||
|
],
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,112 +1,110 @@
|
||||||
from re import match
|
assert node.has_bundle('steam')
|
||||||
from os import path, listdir
|
|
||||||
|
|
||||||
|
from shlex import quote
|
||||||
|
|
||||||
defaults = {
|
defaults = {
|
||||||
'apt': {
|
'steam': {
|
||||||
'packages': {
|
'games': {
|
||||||
'libc6_i386': { # installs libc6:i386
|
'left4dead2': 222860,
|
||||||
'tags': {'left4dead2-packages'},
|
|
||||||
},
|
|
||||||
'lib32z1': {
|
|
||||||
'tags': {'left4dead2-packages'},
|
|
||||||
},
|
|
||||||
'unzip': {
|
|
||||||
'tags': {'left4dead2-packages'},
|
|
||||||
},
|
|
||||||
'p7zip-full': { # l4d2center_maps_sync.sh
|
|
||||||
'tags': {'left4dead2-packages'},
|
|
||||||
},
|
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'left4dead2': {
|
'left4dead2': {
|
||||||
'overlays': set(listdir(path.join(repo.path, 'bundles/left4dead2/files/scripts/overlays'))),
|
'servers': {},
|
||||||
'servers': {
|
'admins': set(),
|
||||||
# 'port': 27017,
|
'workshop': set(),
|
||||||
# 'overlays': ['competitive_rework'],
|
|
||||||
# 'arguments': ['-tickrate 60'],
|
|
||||||
# 'config': [
|
|
||||||
# 'exec server_original.cfg',
|
|
||||||
# 'sm_forcematch zonemod',
|
|
||||||
# ],
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'nftables': {
|
|
||||||
'input': {
|
|
||||||
'udp dport { 27005, 27020 } accept',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'systemd': {
|
|
||||||
'units': {
|
|
||||||
'left4dead2-initialize.service': {
|
|
||||||
'Unit': {
|
|
||||||
'Description': 'initialize left4dead2',
|
|
||||||
'After': 'network-online.target',
|
|
||||||
},
|
|
||||||
'Service': {
|
|
||||||
'Type': 'oneshot',
|
|
||||||
'RemainAfterExit': 'yes',
|
|
||||||
'ExecStart': '/opt/l4d2/setup',
|
|
||||||
'StandardOutput': 'journal',
|
|
||||||
'StandardError': 'journal',
|
|
||||||
},
|
|
||||||
'Install': {
|
|
||||||
'WantedBy': {'multi-user.target'},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
|
'left4dead2/servers',
|
||||||
|
)
|
||||||
|
def rconn_password(metadata):
|
||||||
|
# only works from localhost!
|
||||||
|
return {
|
||||||
|
'left4dead2': {
|
||||||
|
'servers': {
|
||||||
|
server: {
|
||||||
|
'rcon_password': repo.vault.password_for(f'{node.name} left4dead2 {server} rcon', length=24),
|
||||||
|
}
|
||||||
|
for server in metadata.get('left4dead2/servers')
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@metadata_reactor.provides(
|
||||||
|
'steam-workshop-download',
|
||||||
'systemd/units',
|
'systemd/units',
|
||||||
)
|
)
|
||||||
def server_units(metadata):
|
def server_units(metadata):
|
||||||
units = {}
|
units = {}
|
||||||
|
workshop = {}
|
||||||
|
|
||||||
for name, config in metadata.get('left4dead2/servers').items():
|
for name, config in metadata.get('left4dead2/servers').items():
|
||||||
assert match(r'^[A-z0-9-_-]+$', name)
|
# mount overlay
|
||||||
assert 27000 <= config["port"] <= 27100
|
mountpoint = f'/opt/steam/left4dead2-servers/{name}'
|
||||||
for overlay in config.get('overlays', []):
|
mount_unit_name = mountpoint[1:].replace('-', '\\x2d').replace('/', '-') + '.mount'
|
||||||
assert overlay in metadata.get('left4dead2/overlays'), f"unknown overlay {overlay}, known: {metadata.get('left4dead2/overlays')}"
|
units[mount_unit_name] = {
|
||||||
|
'Unit': {
|
||||||
|
'Description': f"Mount left4dead2 server {name} overlay",
|
||||||
|
'Conflicts': {'umount.target'},
|
||||||
|
'Before': {'umount.target'},
|
||||||
|
},
|
||||||
|
'Mount': {
|
||||||
|
'What': 'overlay',
|
||||||
|
'Where': mountpoint,
|
||||||
|
'Type': 'overlay',
|
||||||
|
'Options': ','.join([
|
||||||
|
'auto',
|
||||||
|
'lowerdir=/opt/steam/left4dead2',
|
||||||
|
f'upperdir=/opt/steam-zfs-overlay-workarounds/{name}/upper',
|
||||||
|
f'workdir=/opt/steam-zfs-overlay-workarounds/{name}/workdir',
|
||||||
|
]),
|
||||||
|
},
|
||||||
|
'Install': {
|
||||||
|
'RequiredBy': {
|
||||||
|
f'left4dead2-{name}.service',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
cmd = f'/opt/l4d2/start -n {name} -p {config["port"]}'
|
# individual workshop
|
||||||
|
workshop_ids = config.get('workshop', set()) | metadata.get('left4dead2/workshop', set())
|
||||||
if 'config' in config:
|
if workshop_ids:
|
||||||
cmd += f' -c /opt/l4d2/configs/{name}.cfg'
|
workshop[f'left4dead2-{name}'] = {
|
||||||
|
'ids': workshop_ids,
|
||||||
for overlay in config.get('overlays', []):
|
'path': f'/opt/steam/left4dead2-servers/{name}/left4dead2/addons',
|
||||||
cmd += f' -o {overlay}'
|
'user': 'steam',
|
||||||
|
'requires': {
|
||||||
if 'arguments' in config:
|
mount_unit_name,
|
||||||
cmd += ' -- ' + ' '.join(config['arguments'])
|
},
|
||||||
|
'required_by': {
|
||||||
|
f'left4dead2-{name}.service',
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
# left4dead2 server unit
|
||||||
units[f'left4dead2-{name}.service'] = {
|
units[f'left4dead2-{name}.service'] = {
|
||||||
'Unit': {
|
'Unit': {
|
||||||
'Description': f'left4dead2 server {name}',
|
'Description': f'left4dead2 server {name}',
|
||||||
'After': {'left4dead2-initialize.service'},
|
'After': {'steam-update.service'},
|
||||||
'Requires': {'left4dead2-initialize.service'},
|
'Requires': {'steam-update.service'},
|
||||||
},
|
},
|
||||||
'Service': {
|
'Service': {
|
||||||
'Type': 'simple',
|
'User': 'steam',
|
||||||
'ExecStart': cmd,
|
'Group': 'steam',
|
||||||
'ExecStopPost': f'/opt/l4d2/stop -n {name}',
|
'WorkingDirectory': f'/opt/steam/left4dead2-servers/{name}',
|
||||||
|
'ExecStart': f'/opt/steam/left4dead2-servers/{name}/srcds_run -port {config["port"]} +exec server.cfg',
|
||||||
'Restart': 'on-failure',
|
'Restart': 'on-failure',
|
||||||
'Nice': -10,
|
|
||||||
'CPUWeight': 200,
|
|
||||||
'IOSchedulingClass': 'best-effort',
|
|
||||||
'IOSchedulingPriority': 0,
|
|
||||||
},
|
},
|
||||||
'Install': {
|
'Install': {
|
||||||
'WantedBy': {'multi-user.target'},
|
'WantedBy': {'multi-user.target'},
|
||||||
},
|
},
|
||||||
'triggers': {
|
|
||||||
f'svc_systemd:left4dead2-{name}.service:restart',
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
|
|
||||||
return {
|
return {
|
||||||
|
'steam-workshop-download': workshop,
|
||||||
'systemd': {
|
'systemd': {
|
||||||
'units': units,
|
'units': units,
|
||||||
},
|
},
|
||||||
|
|
@ -116,13 +114,14 @@ def server_units(metadata):
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'nftables/input',
|
'nftables/input',
|
||||||
)
|
)
|
||||||
def nftables(metadata):
|
def firewall(metadata):
|
||||||
ports = sorted(str(config["port"]) for config in metadata.get('left4dead2/servers').values())
|
ports = set(str(server['port']) for server in metadata.get('left4dead2/servers').values())
|
||||||
|
|
||||||
return {
|
return {
|
||||||
'nftables': {
|
'nftables': {
|
||||||
'input': {
|
'input': {
|
||||||
f'ip protocol {{ tcp, udp }} th dport {{ {", ".join(ports)} }} accept'
|
f"tcp dport {{ {', '.join(sorted(ports))} }} accept",
|
||||||
|
f"udp dport {{ {', '.join(sorted(ports))} }} accept",
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,167 +0,0 @@
|
||||||
# left4me
|
|
||||||
|
|
||||||
L4D2 game-server management platform: a Flask web UI on gunicorn that
|
|
||||||
provisions per-instance srcds servers via templated systemd units, with
|
|
||||||
kernel-overlayfs layering for shared installations + per-overlay maps,
|
|
||||||
and uid-based DSCP/priority marking on the egress path so CAKE on the
|
|
||||||
external interface prioritizes srcds UDP over bulk traffic.
|
|
||||||
|
|
||||||
## Metadata
|
|
||||||
|
|
||||||
```python
|
|
||||||
'metadata': {
|
|
||||||
'left4me': {
|
|
||||||
'domain': 'whatever.tld', # required — the only per-node knob
|
|
||||||
# Everything below is optional and has a sensible default in the
|
|
||||||
# bundle. Override per-node only if the default is wrong:
|
|
||||||
# 'git_url': 'git@git.sublimity.de:cronekorkn/left4me',
|
|
||||||
# 'git_branch': 'master',
|
|
||||||
# 'gunicorn_workers': 1,
|
|
||||||
# 'gunicorn_threads': 32,
|
|
||||||
# 'job_worker_threads': 4,
|
|
||||||
# 'port_range_start': 27015,
|
|
||||||
# 'port_range_end': 27115,
|
|
||||||
# secret_key is auto-derived per node
|
|
||||||
# (repo.vault.random_bytes_as_base64_for f'{node.name} left4me secret_key').
|
|
||||||
},
|
|
||||||
},
|
|
||||||
```
|
|
||||||
|
|
||||||
The bundle's `derived_from_domain` reactor reads `left4me/domain` and
|
|
||||||
emits the corresponding `nginx/vhosts`, `letsencrypt/domains`,
|
|
||||||
`monitoring/services/left4me-web` (HTTPS health check), and the game-
|
|
||||||
port `nftables/input` accept rules. Backup paths
|
|
||||||
(`/var/lib/left4me`, `/etc/left4me`) are set-merged into `backup/paths`
|
|
||||||
from defaults. None of these need to be declared per-node.
|
|
||||||
|
|
||||||
## What this bundle does
|
|
||||||
|
|
||||||
The bundle delivers to `ovh.left4me` a mix of:
|
|
||||||
|
|
||||||
### Target-side symlinks into the left4me checkout
|
|
||||||
|
|
||||||
After `git_deploy:/opt/left4me/src` (root-owned — left4me cannot rewrite
|
|
||||||
its own deployment artifacts at runtime), ckn-bw creates symlinks from
|
|
||||||
canonical on-host paths into the checkout:
|
|
||||||
|
|
||||||
| On-host path | Source in checkout |
|
|
||||||
|---|---|
|
|
||||||
| `/etc/sudoers.d/left4me` | `deploy/files/etc/sudoers.d/left4me` |
|
|
||||||
| `/etc/sysctl.d/99-left4me.conf` | `deploy/files/etc/sysctl.d/99-left4me.conf` |
|
|
||||||
| `/etc/systemd/system/left4me-web.service.d/10-hardening.conf` | `deploy/files/etc/systemd/system/left4me-web.service.d/10-hardening.conf` |
|
|
||||||
| `/etc/systemd/system/left4me-server@.service.d/10-hardening.conf` | `deploy/files/etc/systemd/system/left4me-server@.service.d/10-hardening.conf` |
|
|
||||||
| `/usr/local/libexec/left4me/{left4me-overlay,left4me-systemctl,left4me-journalctl,left4me-script-sandbox}` | `deploy/scripts/libexec/*` |
|
|
||||||
| `/usr/local/sbin/left4me` | `deploy/scripts/sbin/left4me` |
|
|
||||||
|
|
||||||
The hardening drop-ins and sudoers are the application's own security
|
|
||||||
knowledge — they live in the left4me repo and are version-controlled there.
|
|
||||||
The privileged helpers are also application code. The symlink pattern
|
|
||||||
lets bw manage placement without duplicating content.
|
|
||||||
|
|
||||||
Design rationale:
|
|
||||||
`left4me/docs/superpowers/specs/2026-05-15-deployment-responsibility-design.md`.
|
|
||||||
|
|
||||||
### Reactor-emitted units (per-host shape)
|
|
||||||
|
|
||||||
Via `systemd/units` metadata in `metadata.py` (consumed by `bundles/systemd/`):
|
|
||||||
|
|
||||||
- `left4me-web.service` — gunicorn on `127.0.0.1:8000`; worker/thread
|
|
||||||
counts from `web.env.mako`. TLS terminates upstream.
|
|
||||||
- `left4me-server@.service` — per-instance srcds template; `SocketBindAllow=`
|
|
||||||
ranges from metadata.
|
|
||||||
- `l4d2-game.slice` / `l4d2-build.slice` — cgroup slices with per-host
|
|
||||||
`AllowedCPUs=` from `left4me/system_cpus`.
|
|
||||||
- `system.slice.d/99-left4me-cpuset.conf` + `user.slice.d/99-left4me-cpuset.conf`
|
|
||||||
— host CPU-set drop-ins, same source.
|
|
||||||
|
|
||||||
### bw `files{}` — templated env files
|
|
||||||
|
|
||||||
- `host.env.mako` → `/etc/left4me/host.env`
|
|
||||||
- `web.env.mako` → `/etc/left4me/web.env`
|
|
||||||
- `sandbox-resolv.conf` → `/etc/left4me/sandbox-resolv.conf`
|
|
||||||
|
|
||||||
### Action chains — deploy lifecycle
|
|
||||||
|
|
||||||
- `git_deploy` → `uv_sync` (`uv sync --frozen` against the workspace's
|
|
||||||
committed `uv.lock`; hatchling PEP 660 editable, doesn't touch source)
|
|
||||||
→ `alembic_upgrade` → `seed_overlays` + web restart.
|
|
||||||
- One-shot bootstrap: `install_uv` downloads a pinned `uv` binary
|
|
||||||
(SHA256-verified) into `/usr/local/bin` because `uv` isn't in Trixie's
|
|
||||||
apt archive. `unless`-gated, so it's a no-op once the version pin is
|
|
||||||
installed; re-runs only when the constant is bumped.
|
|
||||||
- Idempotent gates: `chmod-sudoers` (0440 root:root), `chmod-scripts` (0755 root:root).
|
|
||||||
- Post-git-deploy reloads: `systemctl daemon-reload`, `sysctl --system`.
|
|
||||||
- Post-apply self-test: `verify-hardening-dropins` (asserts the drop-ins are
|
|
||||||
loaded by the live units before declaring apply done).
|
|
||||||
|
|
||||||
### System user
|
|
||||||
|
|
||||||
`left4me` (uid/gid 980, home `/var/lib/left4me`, mode 0755) — the same uid
|
|
||||||
hosts the web app, gameservers, and the script-overlay sandbox unit (which
|
|
||||||
drops privileges via systemd-run with a fully hardened transient service).
|
|
||||||
Runtime mutable state lives under `/var/lib/left4me/`; `/opt/left4me/`
|
|
||||||
stays as a root-owned deploy-artifact root.
|
|
||||||
|
|
||||||
### nftables / nginx / monitoring
|
|
||||||
|
|
||||||
- Contributes uid-based DSCP/priority marks for srcds UDP egress to
|
|
||||||
`nftables/output` (via `defaults`).
|
|
||||||
- `derived_from_domain` reactor emits the corresponding `nginx/vhosts`,
|
|
||||||
`letsencrypt/domains`, and `monitoring/services/left4me-web` (HTTPS
|
|
||||||
health check).
|
|
||||||
|
|
||||||
## Gotchas
|
|
||||||
|
|
||||||
- **Requires `bundles/nftables` and `bundles/systemd` on the node.** The
|
|
||||||
bundle asserts membership at `bw test` time. On Debian-13 these ride
|
|
||||||
in via the `debian-13` group, so attaching the bundle to a Debian-13
|
|
||||||
node is enough.
|
|
||||||
- **`left4me-web.service` does not have `NoNewPrivileges=true`.** This is
|
|
||||||
intentional — workers `sudo` the privileged helpers; `NoNewPrivileges`
|
|
||||||
would block setuid escalation. Per-instance `server@.service` units
|
|
||||||
*do* have it.
|
|
||||||
- **CAKE shaping is configured separately**, via
|
|
||||||
`network/<iface>/cake` on the node (consumed by `bundles/network/`),
|
|
||||||
not by this bundle.
|
|
||||||
- **First-run admin user is manual.** After `bw apply`, ssh to the host and
|
|
||||||
bootstrap the admin via the `left4me` wrapper (it sources the env files,
|
|
||||||
drops to the `left4me` user, and runs the flask CLI):
|
|
||||||
`sudo left4me create-user <username> --admin` (prompts for password via
|
|
||||||
the flask CLI, or set `LEFT4ME_ADMIN_PASSWORD` first). The bundle
|
|
||||||
deliberately doesn't seed an admin to keep credentials out of the
|
|
||||||
metadata pipeline. The same `left4me` wrapper accepts any other flask
|
|
||||||
subcommand: `sudo left4me seed-script-overlays <dir>`,
|
|
||||||
`sudo left4me routes`, `sudo left4me shell`, etc.
|
|
||||||
- **CPU isolation is managed by this bundle**, driven by one required
|
|
||||||
per-node knob: `left4me/system_cpus` — a set of int CPU ids that
|
|
||||||
pins `system.slice` / `user.slice` / `l4d2-build.slice`. The
|
|
||||||
complement (`set(range(vm/threads)) - system_cpus`) pins
|
|
||||||
`l4d2-game.slice`. On HT hosts, list both SMT siblings of every
|
|
||||||
physical core you want to reserve for system, otherwise games end
|
|
||||||
up sharing L1/L2 with system. Find pairings via
|
|
||||||
`/sys/devices/system/cpu/cpu<n>/topology/thread_siblings_list`. On
|
|
||||||
the prod node (`ovh.left4me`, 4 physical / 8 threads, pairings
|
|
||||||
(0,4) (1,5) (2,6) (3,7)) the node sets `'system_cpus': {0, 4}` to
|
|
||||||
reserve physical core 0 entirely. `l4d2-game.slice` and
|
|
||||||
`l4d2-build.slice` carry `AllowedCPUs=` inline on their unit
|
|
||||||
definitions; `system.slice` and `user.slice` get drop-ins registered
|
|
||||||
under `systemd/units` with the `'<parent>.d/<basename>.conf'` key
|
|
||||||
convention (same shape nginx and autologin use), landing at
|
|
||||||
`/usr/local/lib/systemd/system/<slice>.d/99-left4me-cpuset.conf`.
|
|
||||||
The reactor raises if `system_cpus` includes CPUs outside
|
|
||||||
`[0, vm/threads)` or leaves no cores for games.
|
|
||||||
- **Kernel feature requirement:** kernel-overlayfs (`CONFIG_OVERLAY_FS`).
|
|
||||||
Standard on debian-13.
|
|
||||||
- **Game ports** open by the web app on demand in the range 27015-27115
|
|
||||||
(UDP+TCP). Add corresponding accept rules to `nftables/input` per
|
|
||||||
node if the host's policy is default-drop on input.
|
|
||||||
- **Pinned UIDs/GIDs (980/981).** Chosen for deterministic ownership
|
|
||||||
across rebuilds and backup restores. If you add another bundle that
|
|
||||||
pins UIDs in this repo, make sure it doesn't collide.
|
|
||||||
|
|
||||||
## Slice support requires `bundles/systemd` ≥ commit cc1c6a5
|
|
||||||
|
|
||||||
This bundle's `l4d2-game.slice` and `l4d2-build.slice` units rely on
|
|
||||||
`bundles/systemd/items.py` accepting the `.slice` extension. Older
|
|
||||||
revisions raised `Exception(f'unknown type slice')` at apply time.
|
|
||||||
The repo-wide `bw test` will catch this if it regresses.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
# Managed by ckn-bw bundles/left4me. Local edits will be reverted.
|
|
||||||
# Deployment units use fixed /var/lib/left4me paths; regenerate units if this changes.
|
|
||||||
LEFT4ME_ROOT=/var/lib/left4me
|
|
||||||
# l4d2host invokes steamcmd by absolute path — bypasses PATH lookup so the
|
|
||||||
# script's `cd "$(dirname "$0")"` resolves next to the real install dir.
|
|
||||||
LEFT4ME_STEAMCMD=/var/lib/left4me/steam/steamcmd.sh
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
# Sandbox-only resolver config — bind-mounted into script-overlay sandboxes
|
|
||||||
# at /etc/resolv.conf. The host's resolver (often a private/LAN DNS server)
|
|
||||||
# is unreachable from inside the sandbox because IPAddressDeny= blocks
|
|
||||||
# egress to RFC1918 / loopback. Public resolvers keep DNS working.
|
|
||||||
nameserver 1.1.1.1
|
|
||||||
nameserver 8.8.8.8
|
|
||||||
|
|
@ -1,14 +0,0 @@
|
||||||
# Managed by ckn-bw bundles/left4me. Local edits will be reverted.
|
|
||||||
DATABASE_URL=sqlite:////var/lib/left4me/left4me.db
|
|
||||||
SECRET_KEY=${node.metadata.get('left4me/secret_key')}
|
|
||||||
JOB_WORKER_THREADS=${node.metadata.get('left4me/job_worker_threads')}
|
|
||||||
SESSION_COOKIE_SECURE=true
|
|
||||||
LEFT4ME_PORT_RANGE_START=${node.metadata.get('left4me/port_range_start')}
|
|
||||||
LEFT4ME_PORT_RANGE_END=${node.metadata.get('left4me/port_range_end')}
|
|
||||||
STEAM_WEB_API_KEY=${node.metadata.get('left4me/steam_web_api_key')}
|
|
||||||
# Log listener destination — MUST be non-loopback because Source silently
|
|
||||||
# drops logaddress destinations in 127.0.0.0/8. Derived from the node's
|
|
||||||
# external IPv4; kernel routes same-host traffic via lo internally but the
|
|
||||||
# destination IP in the packet header must not literally be 127.x.
|
|
||||||
LOG_LISTENER_ADDR=${node.metadata.get('network/external/ipv4').split('/')[0]}:28000
|
|
||||||
LOG_LISTENER_BIND=0.0.0.0:28000
|
|
||||||
|
|
@ -1,439 +0,0 @@
|
||||||
# Items for the left4me bundle.
|
|
||||||
# Systemd units come from metadata via bundles/systemd/ — there are no
|
|
||||||
# .service or .slice files in this bundle's files/ tree. Cpuset drop-ins
|
|
||||||
# for system.slice / user.slice are likewise emitted via systemd/units
|
|
||||||
# in metadata.py (key: '<parent>.d/<basename>.conf').
|
|
||||||
|
|
||||||
directories = {
|
|
||||||
'/opt/left4me': {
|
|
||||||
# Deploy-artifact root. Only /opt/left4me/src lives here; runtime
|
|
||||||
# state (.venv, steamcmd) lives under /var/lib/left4me/. Root-owned
|
|
||||||
# so left4me cannot drop new files alongside src/ (e.g. an attacker
|
|
||||||
# with web-compromise can't plant a 'scripts.d/' loaded by future
|
|
||||||
# deploy logic).
|
|
||||||
'owner': 'root',
|
|
||||||
'group': 'root',
|
|
||||||
'mode': '0755',
|
|
||||||
},
|
|
||||||
'/opt/left4me/src': {
|
|
||||||
# Source checkout. Root-owned because the production install model
|
|
||||||
# is non-editable: pip_install copies the source to a left4me-owned
|
|
||||||
# tempdir before building, so the source tree on disk is never
|
|
||||||
# mutated at runtime and left4me only needs read access (which
|
|
||||||
# world-readable bits provide). Keeps left4me from being able to
|
|
||||||
# rewrite its own future hardening drop-ins / unit files under
|
|
||||||
# /opt/left4me/src/deploy/ (target-side symlink model in the
|
|
||||||
# deployment-responsibility reshape).
|
|
||||||
'owner': 'root',
|
|
||||||
'group': 'root',
|
|
||||||
},
|
|
||||||
'/etc/left4me': {
|
|
||||||
'owner': 'root',
|
|
||||||
'group': 'root',
|
|
||||||
'mode': '0755',
|
|
||||||
},
|
|
||||||
'/var/lib/left4me': {
|
|
||||||
# left4me's home dir — useradd creates with 0700; loosen to 0755 so
|
|
||||||
# the systemd-imposed FS view for transient script-sandbox units
|
|
||||||
# (running as left4me with TemporaryFileSystem=/var/lib + selective
|
|
||||||
# binds) can traverse on its way to the overlay bind targets.
|
|
||||||
'owner': 'left4me',
|
|
||||||
'group': 'left4me',
|
|
||||||
'mode': '0755',
|
|
||||||
},
|
|
||||||
'/var/lib/left4me/installation': {'owner': 'left4me', 'group': 'left4me'},
|
|
||||||
'/var/lib/left4me/overlays': {'owner': 'left4me', 'group': 'left4me'},
|
|
||||||
'/var/lib/left4me/instances': {'owner': 'left4me', 'group': 'left4me'},
|
|
||||||
'/var/lib/left4me/runtime': {'owner': 'left4me', 'group': 'left4me'},
|
|
||||||
'/var/lib/left4me/workshop_cache': {'owner': 'left4me', 'group': 'left4me'},
|
|
||||||
'/var/lib/left4me/tmp': {'owner': 'left4me', 'group': 'left4me'},
|
|
||||||
'/var/lib/left4me/steam': {'owner': 'left4me', 'group': 'left4me'},
|
|
||||||
# Note: the venv (/var/lib/left4me/.venv) is created by the
|
|
||||||
# left4me_create_venv action; declaring it here too would race with
|
|
||||||
# `python -m venv` which expects to create the directory itself.
|
|
||||||
'/usr/local/libexec/left4me': {
|
|
||||||
'owner': 'root',
|
|
||||||
'group': 'root',
|
|
||||||
'mode': '0755',
|
|
||||||
},
|
|
||||||
'/etc/systemd/system/left4me-web.service.d': {
|
|
||||||
'owner': 'root', 'group': 'root', 'mode': '0755',
|
|
||||||
},
|
|
||||||
'/etc/systemd/system/left4me-server@.service.d': {
|
|
||||||
'owner': 'root', 'group': 'root', 'mode': '0755',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
groups = {
|
|
||||||
'left4me': {'gid': 980},
|
|
||||||
}
|
|
||||||
|
|
||||||
users = {
|
|
||||||
'left4me': {
|
|
||||||
'uid': 980,
|
|
||||||
'gid': 980,
|
|
||||||
'home': '/var/lib/left4me',
|
|
||||||
'shell': '/usr/sbin/nologin',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
# UID/GID pinned in the system-package range (100-999, per Debian
|
|
||||||
# policy) so file ownership is deterministic across rebuilds and
|
|
||||||
# backup restores. 980 is unused elsewhere in this repo.
|
|
||||||
# (981 — formerly l4d2-sandbox — was collapsed into 980 on 2026-05-15;
|
|
||||||
# see left4me/docs/superpowers/plans/2026-05-15-uid-collapse.md.)
|
|
||||||
|
|
||||||
# Privileged helpers are delivered via target-side symlinks (see the
|
|
||||||
# `symlinks` dict below) pointing into the left4me checkout at
|
|
||||||
# `/opt/left4me/src/deploy/scripts/{libexec,sbin}/`. No verbatim copy
|
|
||||||
# in this bundle's files/ tree. Sudoers (further below) lists the
|
|
||||||
# specific paths that left4me may invoke as root NOPASSWD.
|
|
||||||
|
|
||||||
files = {
|
|
||||||
'/etc/left4me/sandbox-resolv.conf': {
|
|
||||||
'source': 'etc/left4me/sandbox-resolv.conf',
|
|
||||||
'mode': '0644',
|
|
||||||
'owner': 'root',
|
|
||||||
'group': 'root',
|
|
||||||
},
|
|
||||||
'/etc/left4me/host.env': {
|
|
||||||
'source': 'etc/left4me/host.env.mako',
|
|
||||||
'content_type': 'mako',
|
|
||||||
'mode': '0640',
|
|
||||||
'owner': 'root',
|
|
||||||
# group=left4me so the alembic + seed-overlays actions (which run as
|
|
||||||
# `sudo -u left4me sh -c '. /etc/left4me/host.env'`) can source it.
|
|
||||||
# Same pattern as web.env below.
|
|
||||||
'group': 'left4me',
|
|
||||||
'needs': [
|
|
||||||
'group:left4me',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
'/etc/left4me/web.env': {
|
|
||||||
'source': 'etc/left4me/web.env.mako',
|
|
||||||
'content_type': 'mako',
|
|
||||||
'mode': '0640',
|
|
||||||
'owner': 'root',
|
|
||||||
'group': 'left4me',
|
|
||||||
'needs': [
|
|
||||||
'group:left4me',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
symlinks = {
|
|
||||||
'/etc/sysctl.d/99-left4me.conf': {
|
|
||||||
'target': '/opt/left4me/src/deploy/files/etc/sysctl.d/99-left4me.conf',
|
|
||||||
'owner': 'root',
|
|
||||||
'group': 'root',
|
|
||||||
'needs': [
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
'triggers': [
|
|
||||||
'action:left4me_sysctl_reload',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
'/etc/systemd/system/left4me-web.service.d/10-hardening.conf': {
|
|
||||||
'target': '/opt/left4me/src/deploy/files/etc/systemd/system/left4me-web.service.d/10-hardening.conf',
|
|
||||||
'owner': 'root', 'group': 'root',
|
|
||||||
'needs': [
|
|
||||||
'directory:/etc/systemd/system/left4me-web.service.d',
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
'triggers': [
|
|
||||||
'action:left4me_daemon_reload',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
'/etc/systemd/system/left4me-server@.service.d/10-hardening.conf': {
|
|
||||||
'target': '/opt/left4me/src/deploy/files/etc/systemd/system/left4me-server@.service.d/10-hardening.conf',
|
|
||||||
'owner': 'root', 'group': 'root',
|
|
||||||
'needs': [
|
|
||||||
'directory:/etc/systemd/system/left4me-server@.service.d',
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
'triggers': [
|
|
||||||
'action:left4me_daemon_reload',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
'/etc/sudoers.d/left4me': {
|
|
||||||
'target': '/opt/left4me/src/deploy/files/etc/sudoers.d/left4me',
|
|
||||||
'owner': 'root', 'group': 'root',
|
|
||||||
'needs': [
|
|
||||||
'action:left4me_chmod_sudoers',
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
# sudo follows symlinks; with the target file at root:root 0440
|
|
||||||
# in a root-owned source tree, sudo accepts it. No daemon-reload
|
|
||||||
# equivalent — sudo re-reads /etc/sudoers.d/ on each invocation.
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
# Helper script source paths (in left4me's checkout) → deployed-form paths.
|
|
||||||
# Each gets a symlink item merged into the symlinks dict above.
|
|
||||||
_LEFT4ME_LIBEXEC_SCRIPTS = (
|
|
||||||
'left4me-overlay',
|
|
||||||
'left4me-systemctl',
|
|
||||||
'left4me-journalctl',
|
|
||||||
'left4me-script-sandbox',
|
|
||||||
)
|
|
||||||
_LEFT4ME_SBIN_SCRIPTS = (
|
|
||||||
'left4me',
|
|
||||||
)
|
|
||||||
|
|
||||||
for _script in _LEFT4ME_LIBEXEC_SCRIPTS:
|
|
||||||
symlinks[f'/usr/local/libexec/left4me/{_script}'] = {
|
|
||||||
'target': f'/opt/left4me/src/deploy/scripts/libexec/{_script}',
|
|
||||||
'owner': 'root', 'group': 'root',
|
|
||||||
'needs': [
|
|
||||||
'directory:/usr/local/libexec/left4me',
|
|
||||||
'action:left4me_chmod_scripts',
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
||||||
for _script in _LEFT4ME_SBIN_SCRIPTS:
|
|
||||||
symlinks[f'/usr/local/sbin/{_script}'] = {
|
|
||||||
'target': f'/opt/left4me/src/deploy/scripts/sbin/{_script}',
|
|
||||||
'owner': 'root', 'group': 'root',
|
|
||||||
'needs': [
|
|
||||||
'action:left4me_chmod_scripts',
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
||||||
actions = {
|
|
||||||
'left4me_sysctl_reload': {
|
|
||||||
'command': 'sysctl --system >/dev/null',
|
|
||||||
'triggered': True,
|
|
||||||
},
|
|
||||||
'left4me_daemon_reload': {
|
|
||||||
'command': 'systemctl daemon-reload',
|
|
||||||
'triggered': True,
|
|
||||||
'cascade_skip': False,
|
|
||||||
},
|
|
||||||
'left4me_verify_hardening_dropins_loaded': {
|
|
||||||
# Post-apply self-test: confirm systemd actually picked up the
|
|
||||||
# hardening drop-ins we shipped via symlink. Catches the failure
|
|
||||||
# mode where the symlink lands but daemon-reload didn't take or
|
|
||||||
# someone manually unlinked the drop-in. For the gameserver template
|
|
||||||
# we query an imaginary instance — systemd resolves drop-in paths
|
|
||||||
# for `name@instance.service` against the template (`name@.service.d/`),
|
|
||||||
# so the instance need not exist or ever have run.
|
|
||||||
'command': (
|
|
||||||
'systemctl show left4me-server@verify.service -p DropInPaths --value '
|
|
||||||
'| tr " " "\\n" '
|
|
||||||
'| grep -qx /etc/systemd/system/left4me-server@.service.d/10-hardening.conf '
|
|
||||||
'&& '
|
|
||||||
'systemctl show left4me-web.service -p DropInPaths --value '
|
|
||||||
'| tr " " "\\n" '
|
|
||||||
'| grep -qx /etc/systemd/system/left4me-web.service.d/10-hardening.conf'
|
|
||||||
),
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'action:left4me_daemon_reload',
|
|
||||||
'symlink:/etc/systemd/system/left4me-web.service.d/10-hardening.conf',
|
|
||||||
'symlink:/etc/systemd/system/left4me-server@.service.d/10-hardening.conf',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
'left4me_chmod_sudoers': {
|
|
||||||
# sudo refuses sudoers.d entries that aren't 0440 (or 0400) root:root.
|
|
||||||
# git_deploy extracts as root with the in-repo file mode; this action
|
|
||||||
# is belt-and-braces in case the repo mode drifts. Idempotent via
|
|
||||||
# the `unless` gate.
|
|
||||||
'command': 'chmod 0440 /opt/left4me/src/deploy/files/etc/sudoers.d/left4me',
|
|
||||||
'unless': 'test "$(stat -c %a /opt/left4me/src/deploy/files/etc/sudoers.d/left4me)" = "440"',
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
'left4me_dpkg_add_i386_arch': {
|
|
||||||
# steamcmd is 32-bit and pulls libc6:i386 + lib32z1 from the i386 arch.
|
|
||||||
# apt-get update is part of this action because newly-added foreign
|
|
||||||
# archs need a fresh package list before any :i386 package resolves.
|
|
||||||
'command': 'dpkg --add-architecture i386 && apt-get update',
|
|
||||||
'unless': 'dpkg --print-foreign-architectures | grep -qx i386',
|
|
||||||
'cascade_skip': False,
|
|
||||||
},
|
|
||||||
'left4me_install_steamcmd': {
|
|
||||||
# Steam's tarball is rolling with no published checksum, so we can't
|
|
||||||
# use download: (which requires a hash). Guard with a presence check
|
|
||||||
# on steamcmd.sh — steamcmd self-updates at runtime, so chasing the
|
|
||||||
# tarball version from bw isn't useful.
|
|
||||||
'command': (
|
|
||||||
'sudo -u left4me sh -c "'
|
|
||||||
'cd /var/lib/left4me/steam && '
|
|
||||||
'curl -fsSL https://media.steampowered.com/installer/steamcmd_linux.tar.gz | '
|
|
||||||
'tar -xz'
|
|
||||||
'"'
|
|
||||||
),
|
|
||||||
'unless': 'test -x /var/lib/left4me/steam/steamcmd.sh',
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'directory:/var/lib/left4me/steam',
|
|
||||||
'pkg_apt:curl',
|
|
||||||
'pkg_apt:libc6_i386', # bw pkg_apt convention: _ → :
|
|
||||||
'pkg_apt:lib32z1',
|
|
||||||
'user:left4me',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
# steamcmd is invoked by absolute path (LEFT4ME_STEAMCMD in host.env),
|
|
||||||
# not via PATH lookup — see l4d2host/cli.py:install. We don't need to put
|
|
||||||
# anything in /usr/local/bin for it.
|
|
||||||
|
|
||||||
git_deploy = {
|
|
||||||
'/opt/left4me/src': {
|
|
||||||
'repo': node.metadata.get('left4me/git_url'),
|
|
||||||
'rev': node.metadata.get('left4me/git_branch'),
|
|
||||||
'triggers': [
|
|
||||||
# Re-sync the workspace whenever the checkout changes. uv reads
|
|
||||||
# the committed uv.lock at /opt/left4me/src and installs both
|
|
||||||
# workspace members (l4d2host, l4d2web) editable into
|
|
||||||
# /var/lib/left4me/.venv. Hatchling's PEP 660 editable install
|
|
||||||
# doesn't write to the source tree, so /opt/left4me/src stays
|
|
||||||
# root-owned and untouched. uv_sync cascades into
|
|
||||||
# alembic_upgrade → seed_overlays → web restart.
|
|
||||||
'action:left4me_uv_sync',
|
|
||||||
# alembic upgrade head is idempotent — keeping it as a direct
|
|
||||||
# trigger off git_deploy is belt-and-braces in case the
|
|
||||||
# uv_sync cascade is ever short-circuited.
|
|
||||||
'action:left4me_alembic_upgrade',
|
|
||||||
# Reload systemd unit definitions whenever the checkout changes;
|
|
||||||
# handles updates to hardening drop-in content without requiring
|
|
||||||
# a symlink change.
|
|
||||||
'action:left4me_daemon_reload',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
actions['left4me_chmod_scripts'] = {
|
|
||||||
# sudo invokes the helpers by absolute path under /usr/local/...;
|
|
||||||
# those resolve to the checkout via the symlinks above. The target
|
|
||||||
# files must be executable (mode 0755). git_deploy extracts with
|
|
||||||
# the in-repo file modes; this action is belt-and-braces in case
|
|
||||||
# any helper's repo mode regresses to 0644.
|
|
||||||
'command': (
|
|
||||||
'chmod 0755 '
|
|
||||||
'/opt/left4me/src/deploy/scripts/libexec/* '
|
|
||||||
'/opt/left4me/src/deploy/scripts/sbin/*'
|
|
||||||
),
|
|
||||||
'unless': (
|
|
||||||
'! find /opt/left4me/src/deploy/scripts -type f \\! -perm 755 -print -quit 2>/dev/null | grep -q .'
|
|
||||||
),
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
||||||
actions['left4me_install_uv'] = {
|
|
||||||
# uv is not in Debian Trixie's apt archive (only experimental/sid).
|
|
||||||
# Pin to a specific release; download the tarball + its SHA256
|
|
||||||
# sibling from astral-sh/uv releases, verify, install to
|
|
||||||
# /usr/local/bin. Idempotent via `unless` — only re-runs when the
|
|
||||||
# pinned version changes (bump the constant in two places below).
|
|
||||||
# Pattern matches left4me_install_steamcmd (curl+tar) elsewhere in
|
|
||||||
# this bundle. Bump cadence: as needed; both dev (brew uv) and
|
|
||||||
# prod should track the same minor.
|
|
||||||
'command': """set -e
|
|
||||||
tmpdir=$(mktemp -d); trap "rm -rf $tmpdir" EXIT
|
|
||||||
base=https://github.com/astral-sh/uv/releases/download/0.11.8
|
|
||||||
tar=uv-x86_64-unknown-linux-gnu.tar.gz
|
|
||||||
curl -fsSL -o $tmpdir/$tar $base/$tar
|
|
||||||
curl -fsSL -o $tmpdir/$tar.sha256 $base/$tar.sha256
|
|
||||||
(cd $tmpdir && sha256sum -c $tar.sha256)
|
|
||||||
tar -xzf $tmpdir/$tar -C $tmpdir --strip-components=1
|
|
||||||
install -m 0755 $tmpdir/uv /usr/local/bin/uv
|
|
||||||
install -m 0755 $tmpdir/uvx /usr/local/bin/uvx
|
|
||||||
""",
|
|
||||||
'unless': '/usr/local/bin/uv --version 2>/dev/null | grep -qx "uv 0.11.8"',
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'pkg_apt:curl',
|
|
||||||
],
|
|
||||||
# No triggers — install_uv is a one-shot bootstrap. uv_sync needs
|
|
||||||
# it (via `needs`), so the dependency runs install_uv first on a
|
|
||||||
# clean host. After that, this action is a no-op on every apply
|
|
||||||
# unless the version pin changes.
|
|
||||||
}
|
|
||||||
|
|
||||||
actions['left4me_uv_sync'] = {
|
|
||||||
# The whole "install/refresh the workspace" deploy step, in one
|
|
||||||
# action. uv reads /opt/left4me/src/uv.lock + the workspace's
|
|
||||||
# pyproject.toml and installs both members (l4d2host, l4d2web)
|
|
||||||
# editable into /var/lib/left4me/.venv. Hatchling's PEP 660
|
|
||||||
# editable install drops a .pth pointing at the source tree — no
|
|
||||||
# writes to source, so the root-owned /opt/left4me/src stays clean.
|
|
||||||
#
|
|
||||||
# UV_PROJECT_ENVIRONMENT redirects uv's default venv path
|
|
||||||
# (<project>/.venv) to our writable runtime location. HOME is set
|
|
||||||
# explicitly so uv's cache lands in /var/lib/left4me/.cache/uv
|
|
||||||
# instead of the inherited sudo HOME (which can be unwritable for
|
|
||||||
# the left4me user). cd /var/lib/left4me ensures uv's project-config
|
|
||||||
# walk-up doesn't trip over an unreadable parent (e.g., /root or
|
|
||||||
# /home/ckn). --frozen requires uv.lock to be present and
|
|
||||||
# consistent with pyproject.toml — refuses to silently update the
|
|
||||||
# lockfile during deploy.
|
|
||||||
'command': (
|
|
||||||
'sudo -u left4me sh -c "'
|
|
||||||
'cd /var/lib/left4me && '
|
|
||||||
'env HOME=/var/lib/left4me '
|
|
||||||
'UV_PROJECT_ENVIRONMENT=/var/lib/left4me/.venv '
|
|
||||||
'/usr/local/bin/uv sync --frozen --project /opt/left4me/src'
|
|
||||||
'"'
|
|
||||||
),
|
|
||||||
'triggered': True,
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'git_deploy:/opt/left4me/src',
|
|
||||||
'action:left4me_install_uv',
|
|
||||||
'directory:/var/lib/left4me',
|
|
||||||
'user:left4me',
|
|
||||||
],
|
|
||||||
'triggers': [
|
|
||||||
'action:left4me_alembic_upgrade',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
||||||
actions['left4me_alembic_upgrade'] = {
|
|
||||||
# Mirrors deploy-test-server.sh:239-242. Runs as left4me with both env
|
|
||||||
# files sourced; JOB_WORKER_ENABLED=false so a stray worker doesn't race
|
|
||||||
# with the migration.
|
|
||||||
'command': (
|
|
||||||
'sudo -u left4me sh -c "'
|
|
||||||
'cd /opt/left4me/src/l4d2web && '
|
|
||||||
'set -a && . /etc/left4me/host.env && . /etc/left4me/web.env && set +a && '
|
|
||||||
'env JOB_WORKER_ENABLED=false '
|
|
||||||
'/var/lib/left4me/.venv/bin/alembic -c /opt/left4me/src/l4d2web/alembic.ini upgrade head'
|
|
||||||
'"'
|
|
||||||
),
|
|
||||||
'triggered': True,
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'action:left4me_uv_sync',
|
|
||||||
'file:/etc/left4me/host.env',
|
|
||||||
'file:/etc/left4me/web.env',
|
|
||||||
],
|
|
||||||
'triggers': [
|
|
||||||
'action:left4me_seed_overlays',
|
|
||||||
'svc_systemd:left4me-web.service:restart',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
||||||
actions['left4me_seed_overlays'] = {
|
|
||||||
# Idempotent: refreshes script bodies in place; existing overlay rows keep their ids.
|
|
||||||
'command': (
|
|
||||||
'sudo -u left4me sh -c "'
|
|
||||||
'set -a && . /etc/left4me/host.env && . /etc/left4me/web.env && set +a && '
|
|
||||||
'env JOB_WORKER_ENABLED=false '
|
|
||||||
'/var/lib/left4me/.venv/bin/flask --app l4d2web.app:create_app '
|
|
||||||
'seed-script-overlays /opt/left4me/src/examples/script-overlays'
|
|
||||||
'"'
|
|
||||||
),
|
|
||||||
'triggered': True,
|
|
||||||
'cascade_skip': False,
|
|
||||||
'needs': [
|
|
||||||
'action:left4me_alembic_upgrade',
|
|
||||||
],
|
|
||||||
}
|
|
||||||
|
|
@ -1,305 +0,0 @@
|
||||||
assert node.has_bundle('nftables')
|
|
||||||
assert node.has_bundle('systemd')
|
|
||||||
assert node.has_bundle('systemd-timers')
|
|
||||||
|
|
||||||
|
|
||||||
defaults = {
|
|
||||||
'left4me': {
|
|
||||||
# Application-wide defaults; node only overrides if it really needs to.
|
|
||||||
'git_url': 'https://git.sublimity.de/cronekorkn/left4me.git',
|
|
||||||
'git_branch': 'master',
|
|
||||||
'secret_key': repo.vault.random_bytes_as_base64_for(f'{node.name} left4me secret_key', length=32).value,
|
|
||||||
'gunicorn_workers': 1,
|
|
||||||
'gunicorn_threads': 32,
|
|
||||||
'job_worker_threads': 4,
|
|
||||||
# Steam Web API key for the live-state panel's GetPlayerSummaries
|
|
||||||
# lookups (persona names + avatars). Empty default — nodes override
|
|
||||||
# in their own metadata with the actual key. If left empty in prod,
|
|
||||||
# the live-state panel still works but falls back to RCON in-game
|
|
||||||
# names and placeholder avatars.
|
|
||||||
'steam_web_api_key': '',
|
|
||||||
# Whole 27000-block: covers Steam's defaults (27015 game, 27005
|
|
||||||
# client/RCON) plus headroom for ad-hoc ports without further
|
|
||||||
# nftables changes. Mirrored into LEFT4ME_PORT_RANGE_{START,END}
|
|
||||||
# by web.env.mako and into the nftables input rule by the
|
|
||||||
# nftables_input reactor below.
|
|
||||||
'port_range_start': 27000,
|
|
||||||
'port_range_end': 27999,
|
|
||||||
},
|
|
||||||
'apt': {
|
|
||||||
'packages': {
|
|
||||||
'p7zip-full': {},
|
|
||||||
'nftables': {},
|
|
||||||
'iproute2': {},
|
|
||||||
'curl': {},
|
|
||||||
'ca-certificates': {},
|
|
||||||
'python3': {},
|
|
||||||
'python3-dev': {},
|
|
||||||
# steamcmd is a 32-bit ELF; needs i386 multiarch + these libs.
|
|
||||||
# `_` → `:` is bundlewrap's pkg_apt convention for multiarch
|
|
||||||
# names (see pkg_apt.py:48).
|
|
||||||
'libc6_i386': { # installs libc6:i386
|
|
||||||
'needs': ['action:left4me_dpkg_add_i386_arch'],
|
|
||||||
},
|
|
||||||
'lib32z1': {
|
|
||||||
'needs': ['action:left4me_dpkg_add_i386_arch'],
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'nftables': {
|
|
||||||
# Match deploy/files/usr/local/lib/left4me/nft/left4me-mark.nft.
|
|
||||||
# Mark srcds UDP egress (uid left4me) with DSCP EF + skb priority 6
|
|
||||||
# so CAKE classifies it into the priority tin.
|
|
||||||
'output': {
|
|
||||||
'meta skuid "left4me" meta l4proto udp ip dscp set ef meta priority set 0006:0000',
|
|
||||||
'meta skuid "left4me" meta l4proto udp ip6 dscp set ef meta priority set 0006:0000',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'systemd': {
|
|
||||||
'services': {
|
|
||||||
'left4me-web.service': {
|
|
||||||
'enabled': True,
|
|
||||||
'running': True,
|
|
||||||
'needs': [
|
|
||||||
'action:left4me_alembic_upgrade',
|
|
||||||
'file:/etc/left4me/host.env',
|
|
||||||
'file:/etc/left4me/web.env',
|
|
||||||
],
|
|
||||||
},
|
|
||||||
# Note: left4me-server@.service is a TEMPLATE — instances are
|
|
||||||
# started on-demand by the web app via the left4me-systemctl
|
|
||||||
# helper. Don't enable/start it from here.
|
|
||||||
# The slices are installed (file present) but don't need
|
|
||||||
# enable/start — they're activated implicitly when a unit
|
|
||||||
# uses Slice=.
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'backup': {
|
|
||||||
# Application-owned paths. Set-merged with backup group / node-level paths.
|
|
||||||
'paths': {
|
|
||||||
'/var/lib/left4me',
|
|
||||||
'/etc/left4me',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'systemd-timers': {
|
|
||||||
# Daily re-fetch of Steam Workshop metadata + .vpk downloads for any
|
|
||||||
# item whose author published an update. The CLI just inserts a
|
|
||||||
# `refresh_workshop_items` job; the web worker picks it up next.
|
|
||||||
# Idempotent — a re-fire while a refresh is already queued/running
|
|
||||||
# is a no-op (see l4d2web/cli.py:workshop_refresh).
|
|
||||||
'left4me-workshop-refresh': {
|
|
||||||
'command': '/var/lib/left4me/.venv/bin/flask --app l4d2web.app:create_app workshop-refresh',
|
|
||||||
'when': '*-*-* 04:00:00',
|
|
||||||
'persistent': True,
|
|
||||||
'user': 'left4me',
|
|
||||||
'working_dir': '/opt/left4me/src',
|
|
||||||
'environment_files': (
|
|
||||||
'/etc/left4me/host.env',
|
|
||||||
'/etc/left4me/web.env',
|
|
||||||
),
|
|
||||||
'after': {
|
|
||||||
'network-online.target',
|
|
||||||
'left4me-web.service',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
|
||||||
'nginx/vhosts',
|
|
||||||
)
|
|
||||||
def nginx_vhosts(metadata):
|
|
||||||
# letsencrypt/domains and monitoring/services for the vhost are auto-
|
|
||||||
# populated by bundles/nginx/metadata.py. We just declare check_path:
|
|
||||||
# '/health' so the auto-check hits the Flask health endpoint, not '/'.
|
|
||||||
domain = metadata.get('left4me/domain')
|
|
||||||
return {
|
|
||||||
'nginx': {
|
|
||||||
'vhosts': {
|
|
||||||
domain: {
|
|
||||||
'content': 'nginx/proxy_pass.conf',
|
|
||||||
'context': {
|
|
||||||
'target': 'http://127.0.0.1:8000',
|
|
||||||
},
|
|
||||||
'check_path': '/health',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
|
||||||
'nftables/input',
|
|
||||||
)
|
|
||||||
def nftables_input(metadata):
|
|
||||||
port_start = metadata.get('left4me/port_range_start')
|
|
||||||
port_end = metadata.get('left4me/port_range_end')
|
|
||||||
return {
|
|
||||||
'nftables': {
|
|
||||||
'input': {
|
|
||||||
# Players connect via UDP. TCP on the same port range is RCON
|
|
||||||
# — only the local web app should reach it. Loopback bypasses
|
|
||||||
# the input chain (iifname lo accept in bundles/nftables/...),
|
|
||||||
# so 127.0.0.1 RCON works without an explicit TCP accept here.
|
|
||||||
# External TCP on these ports stays blocked by the default
|
|
||||||
# input-chain drop.
|
|
||||||
f'udp dport {port_start}-{port_end} accept',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
|
||||||
'systemd/units',
|
|
||||||
)
|
|
||||||
def systemd_units(metadata):
|
|
||||||
workers = metadata.get('left4me/gunicorn_workers')
|
|
||||||
threads = metadata.get('left4me/gunicorn_threads')
|
|
||||||
|
|
||||||
# cgroup-v2 cpuset. `system_cpus` (set of int CPU ids, declared per
|
|
||||||
# node) pins system/user/build; the complement pins l4d2-game. On HT
|
|
||||||
# hosts, list both siblings of a physical core so games don't share
|
|
||||||
# L1/L2 with system work — pairings via
|
|
||||||
# /sys/devices/system/cpu/cpu<n>/topology/thread_siblings_list.
|
|
||||||
vm_threads = metadata.get('vm/threads', metadata.get('vm/cores'))
|
|
||||||
all_cpus = set(range(vm_threads))
|
|
||||||
system_cpus = metadata.get('left4me/system_cpus')
|
|
||||||
if not system_cpus <= all_cpus:
|
|
||||||
raise Exception(
|
|
||||||
f'left4me/system_cpus={sorted(system_cpus)} on {vm_threads}-thread host '
|
|
||||||
f'includes CPUs outside [0, {vm_threads})'
|
|
||||||
)
|
|
||||||
game_cpus = all_cpus - system_cpus
|
|
||||||
if not game_cpus:
|
|
||||||
raise Exception(
|
|
||||||
f'left4me/system_cpus={sorted(system_cpus)} on {vm_threads}-thread host '
|
|
||||||
f'leaves no cores for games'
|
|
||||||
)
|
|
||||||
system_cpus_string = ','.join(str(t) for t in sorted(system_cpus))
|
|
||||||
game_cpus_string = ','.join(str(t) for t in sorted(game_cpus))
|
|
||||||
|
|
||||||
# Drop-in for upstream system.slice / user.slice (units we don't own).
|
|
||||||
# Same '<parent>.d/<basename>.conf' convention as nginx and autologin.
|
|
||||||
cpuset_dropin = {'Slice': {'AllowedCPUs': system_cpus_string}}
|
|
||||||
|
|
||||||
return {
|
|
||||||
'systemd': {
|
|
||||||
'units': {
|
|
||||||
'left4me-web.service': {
|
|
||||||
'Unit': {
|
|
||||||
'Description': 'left4me web application',
|
|
||||||
'After': 'network-online.target',
|
|
||||||
'Wants': 'network-online.target',
|
|
||||||
},
|
|
||||||
'Service': {
|
|
||||||
'Type': 'simple',
|
|
||||||
'User': 'left4me',
|
|
||||||
'Group': 'left4me',
|
|
||||||
'WorkingDirectory': '/opt/left4me/src',
|
|
||||||
'Environment': {
|
|
||||||
'HOME=/var/lib/left4me',
|
|
||||||
'PATH=/var/lib/left4me/.venv/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin',
|
|
||||||
},
|
|
||||||
'EnvironmentFile': (
|
|
||||||
'/etc/left4me/host.env',
|
|
||||||
'/etc/left4me/web.env',
|
|
||||||
),
|
|
||||||
'ExecStart': (
|
|
||||||
'/var/lib/left4me/.venv/bin/gunicorn '
|
|
||||||
f'--workers {workers} --threads {threads} '
|
|
||||||
"--bind 127.0.0.1:8000 'l4d2web.app:create_app()'"
|
|
||||||
),
|
|
||||||
'Restart': 'on-failure',
|
|
||||||
'RestartSec': '3',
|
|
||||||
|
|
||||||
# Web app writes broadly under /var/lib/left4me. Kept inline
|
|
||||||
# because it's web-specific (server@ uses BindPaths to bind
|
|
||||||
# only its instance dir).
|
|
||||||
'ReadWritePaths': '/var/lib/left4me',
|
|
||||||
|
|
||||||
# Hardening profile delivered via
|
|
||||||
# /etc/systemd/system/left4me-web.service.d/10-hardening.conf
|
|
||||||
# (target-side symlink into left4me/deploy/files/, owned by left4me).
|
|
||||||
},
|
|
||||||
'Install': {
|
|
||||||
'WantedBy': {'multi-user.target'},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'left4me-server@.service': {
|
|
||||||
'Unit': {
|
|
||||||
'Description': 'left4me server instance %i',
|
|
||||||
'After': 'network-online.target',
|
|
||||||
'Wants': 'network-online.target',
|
|
||||||
'StartLimitBurst': '5',
|
|
||||||
'StartLimitIntervalSec': '60s',
|
|
||||||
},
|
|
||||||
'Service': {
|
|
||||||
'Type': 'simple',
|
|
||||||
'User': 'left4me',
|
|
||||||
'Group': 'left4me',
|
|
||||||
'EnvironmentFile': (
|
|
||||||
'/etc/left4me/host.env',
|
|
||||||
'/var/lib/left4me/instances/%i/instance.env',
|
|
||||||
),
|
|
||||||
'WorkingDirectory': '-/var/lib/left4me/runtime/%i/merged/left4dead2',
|
|
||||||
'ExecStartPre': '+/usr/bin/nsenter --mount=/proc/1/ns/mnt -- /usr/local/libexec/left4me/left4me-overlay mount %i',
|
|
||||||
# +ip 0.0.0.0 binds RCON (TCP) to all interfaces incl. loopback;
|
|
||||||
# without this, Source auto-selects the primary IP and the web
|
|
||||||
# app's 127.0.0.1 RCON connect gets ECONNREFUSED. External TCP
|
|
||||||
# on the game port range is firewall-blocked in nftables_input.
|
|
||||||
'ExecStart': '/var/lib/left4me/runtime/%i/merged/srcds_run -game left4dead2 +ip 0.0.0.0 +hostport ${L4D2_PORT} $L4D2_ARGS',
|
|
||||||
'ExecStopPost': '+/usr/bin/nsenter --mount=/proc/1/ns/mnt -- /usr/local/libexec/left4me/left4me-overlay umount %i',
|
|
||||||
'Restart': 'on-failure',
|
|
||||||
'RestartSec': '5',
|
|
||||||
|
|
||||||
# Resource control (baseline from prior performance work).
|
|
||||||
'Slice': 'l4d2-game.slice',
|
|
||||||
'Nice': '-5',
|
|
||||||
'IOSchedulingClass': 'best-effort',
|
|
||||||
'IOSchedulingPriority': '4',
|
|
||||||
'OOMScoreAdjust': '-200',
|
|
||||||
'MemoryHigh': '1.5G',
|
|
||||||
'MemoryMax': '2G',
|
|
||||||
'TasksMax': '256',
|
|
||||||
'LimitNOFILE': '65536',
|
|
||||||
'KillSignal': 'SIGINT',
|
|
||||||
'TimeoutStopSec': '15s',
|
|
||||||
'LogRateLimitIntervalSec': '0',
|
|
||||||
|
|
||||||
# Hardening profile delivered via
|
|
||||||
# /etc/systemd/system/left4me-server@.service.d/10-hardening.conf
|
|
||||||
# (target-side symlink into left4me/deploy/files/, owned by left4me).
|
|
||||||
},
|
|
||||||
'Install': {
|
|
||||||
'WantedBy': {'multi-user.target'},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'l4d2-game.slice': {
|
|
||||||
'Unit': {
|
|
||||||
'Description': 'left4me game-server slice',
|
|
||||||
'Before': 'slices.target',
|
|
||||||
},
|
|
||||||
'Slice': {
|
|
||||||
'CPUWeight': '1000',
|
|
||||||
'IOWeight': '1000',
|
|
||||||
'AllowedCPUs': game_cpus_string,
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'l4d2-build.slice': {
|
|
||||||
'Unit': {
|
|
||||||
'Description': 'left4me script-sandbox build slice',
|
|
||||||
'Before': 'slices.target',
|
|
||||||
},
|
|
||||||
'Slice': {
|
|
||||||
'CPUWeight': '10',
|
|
||||||
'IOWeight': '10',
|
|
||||||
'AllowedCPUs': system_cpus_string,
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'system.slice.d/99-left4me-cpuset.conf': cpuset_dropin,
|
|
||||||
'user.slice.d/99-left4me-cpuset.conf': cpuset_dropin,
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
@ -1,60 +1,9 @@
|
||||||
# letsencrypt
|
https://github.com/dehydrated-io/dehydrated/wiki/example-dns-01-nsupdate-script
|
||||||
|
|
||||||
Issues and renews Let's Encrypt certs via [dehydrated][upstream] with
|
|
||||||
DNS-01 against the in-house bind-acme server.
|
|
||||||
|
|
||||||
[upstream]: https://github.com/dehydrated-io/dehydrated/wiki/example-dns-01-nsupdate-script
|
|
||||||
|
|
||||||
## First-apply behaviour
|
|
||||||
|
|
||||||
Immediately after `bw apply <node>`, nginx serves a **self-signed
|
|
||||||
cert** for each declared domain — generated by
|
|
||||||
`/etc/dehydrated/letsencrypt-ensure-some-certificate` so nginx has
|
|
||||||
something to start with. The real Let's Encrypt cert arrives at most
|
|
||||||
24h later when the systemd timer fires
|
|
||||||
(`/usr/bin/dehydrated --cron --accept-terms --challenge dns-01`). To
|
|
||||||
shortcut the wait:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
ssh <node> 'sudo /usr/bin/dehydrated --cron --accept-terms --challenge dns-01'
|
|
||||||
ssh <node> 'sudo systemctl reload nginx'
|
|
||||||
```
|
|
||||||
|
|
||||||
## DNS-01 prerequisites
|
|
||||||
|
|
||||||
`hook.sh` does `nsupdate` against the bind-acme server (referenced
|
|
||||||
by `letsencrypt/acme_node`). For the challenge to succeed:
|
|
||||||
|
|
||||||
1. The acme node must be in the same metadata graph (so
|
|
||||||
`bw metadata <node> -k letsencrypt/acme_node` resolves).
|
|
||||||
2. **All NS servers** for the validated domain must serve the
|
|
||||||
`_acme-challenge.<domain>` CNAME — Let's Encrypt validates from
|
|
||||||
primary AND secondary geographic regions; both authoritative
|
|
||||||
servers must agree. If a secondary NS is also a bw-managed node,
|
|
||||||
`bw apply` it after adding the domain (see e.g. `ovh.secondary`).
|
|
||||||
3. The bind-acme node's TSIG key must be reachable. `hook.sh` is
|
|
||||||
rendered with the bind-acme server's `network/internal/ipv4` —
|
|
||||||
for clients outside that LAN, the route must exist (typically via
|
|
||||||
wireguard `s2s` peer membership).
|
|
||||||
|
|
||||||
## Negative-cache penalty
|
|
||||||
|
|
||||||
If the first DNS-01 attempt fails (e.g. zone not yet applied to the
|
|
||||||
secondary NS), Let's Encrypt's resolvers cache NXDOMAIN for the SOA's
|
|
||||||
negative TTL (often 900s = 15 min). Subsequent attempts during that
|
|
||||||
window also fail and refresh the cache. Combined with LE's rate limit
|
|
||||||
of **5 failed authorisations per domain per hour**, recovery requires
|
|
||||||
you to **stop retrying** for ~15 minutes after fixing the DNS, then
|
|
||||||
make at most one attempt.
|
|
||||||
|
|
||||||
## nsupdate sample
|
|
||||||
|
|
||||||
For interactive testing of the bind-acme TSIG path:
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
printf "server 127.0.0.1
|
printf "server 127.0.0.1
|
||||||
zone acme.resolver.name.
|
zone acme.resolver.name.
|
||||||
update add _acme-challenge.ckn.li.acme.resolver.name. 600 IN TXT \"hello\"
|
update add _acme-challenge.ckn.li.acme.resolver.name. 600 IN TXT "hello"
|
||||||
send
|
send
|
||||||
" | nsupdate -y hmac-sha512:acme:XXXXXX
|
" | nsupdate -y hmac-sha512:acme:Y9BHl85l352BGZDXa/vg90hh2+5PYe4oJxpkq/oQvIODDkW8bAyQSFr0gKQQxjyIOyYlTjf0MGcdWFv46G/3Rg==
|
||||||
```
|
```
|
||||||
|
|
|
||||||
|
|
@ -31,12 +31,6 @@ deploy_cert() {
|
||||||
% for domain, conf in sorted(domains.items()):
|
% for domain, conf in sorted(domains.items()):
|
||||||
<% if not conf: continue %>\
|
<% if not conf: continue %>\
|
||||||
${domain})
|
${domain})
|
||||||
% if conf.get('scp', None):
|
|
||||||
scp "$KEYFILE" "${conf['scp']}/${conf.get('privkey_name', 'privkey.pem')}"
|
|
||||||
scp "$CERTFILE" "${conf['scp']}/${conf.get('cert_name', 'cert.pem')}"
|
|
||||||
scp "$FULLCHAINFILE" "${conf['scp']}/${conf.get('fullchain_name', 'fullchain.pem')}"
|
|
||||||
scp "$CHAINFILE" "${conf['scp']}/${conf.get('chain_name', 'chain.pem')}"
|
|
||||||
% endif
|
|
||||||
% if conf.get('location', None):
|
% if conf.get('location', None):
|
||||||
cat "$KEYFILE" > "${conf['location']}/${conf.get('privkey_name', 'privkey.pem')}"
|
cat "$KEYFILE" > "${conf['location']}/${conf.get('privkey_name', 'privkey.pem')}"
|
||||||
cat "$CERTFILE" > "${conf['location']}/${conf.get('cert_name', 'cert.pem')}"
|
cat "$CERTFILE" > "${conf['location']}/${conf.get('cert_name', 'cert.pem')}"
|
||||||
|
|
|
||||||
|
|
@ -42,7 +42,7 @@ files = {
|
||||||
}
|
}
|
||||||
|
|
||||||
actions['letsencrypt_update_certificates'] = {
|
actions['letsencrypt_update_certificates'] = {
|
||||||
'command': 'systemctl start letsencrypt.service',
|
'command': 'dehydrated --cron --accept-terms --challenge dns-01',
|
||||||
'triggered': True,
|
'triggered': True,
|
||||||
'skip': delegated,
|
'skip': delegated,
|
||||||
'needs': {
|
'needs': {
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@ defaults = {
|
||||||
'apt': {
|
'apt': {
|
||||||
'packages': {
|
'packages': {
|
||||||
'dehydrated': {},
|
'dehydrated': {},
|
||||||
'bind9-dnsutils': {},
|
'dnsutils': {},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'letsencrypt': {
|
'letsencrypt': {
|
||||||
|
|
|
||||||
|
|
@ -12,8 +12,9 @@ def generate_sysctl_key_value_pairs_from_json(json_data, parents=[]):
|
||||||
|
|
||||||
key_value_pairs = generate_sysctl_key_value_pairs_from_json(node.metadata.get('sysctl'))
|
key_value_pairs = generate_sysctl_key_value_pairs_from_json(node.metadata.get('sysctl'))
|
||||||
|
|
||||||
|
|
||||||
files= {
|
files= {
|
||||||
'/etc/sysctl.d/managed.conf': {
|
'/etc/sysctl.conf': {
|
||||||
'content': '\n'.join(
|
'content': '\n'.join(
|
||||||
sorted(
|
sorted(
|
||||||
f"{'.'.join(path)}={value}"
|
f"{'.'.join(path)}={value}"
|
||||||
|
|
@ -24,9 +25,6 @@ files= {
|
||||||
'svc_systemd:systemd-sysctl.service:restart',
|
'svc_systemd:systemd-sysctl.service:restart',
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
'/etc/modules-load.d/managed.conf': {
|
|
||||||
'content': '\n'.join(sorted(node.metadata.get('modules-load'))),
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
svc_systemd = {
|
svc_systemd = {
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,3 @@
|
||||||
defaults = {
|
defaults = {
|
||||||
'sysctl': {
|
'sysctl': {},
|
||||||
'net.ipv4.icmp_ratelimit': '100',
|
|
||||||
},
|
|
||||||
'modules-load': set(),
|
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -7,7 +7,12 @@ defaults = {
|
||||||
'locale': {
|
'locale': {
|
||||||
'default': ('en_US.UTF-8', 'UTF-8'),
|
'default': ('en_US.UTF-8', 'UTF-8'),
|
||||||
'installed': {
|
'installed': {
|
||||||
|
('de_AT.UTF-8', 'UTF-8'),
|
||||||
|
('de_CH.UTF-8', 'UTF-8'),
|
||||||
('de_DE.UTF-8', 'UTF-8'),
|
('de_DE.UTF-8', 'UTF-8'),
|
||||||
|
('de_LU.UTF-8', 'UTF-8'),
|
||||||
|
('en_CA.UTF-8', 'UTF-8'),
|
||||||
|
('en_GB.UTF-8', 'UTF-8'),
|
||||||
('en_US.UTF-8', 'UTF-8'),
|
('en_US.UTF-8', 'UTF-8'),
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -2,8 +2,6 @@
|
||||||
|
|
||||||
cd "$OLDPWD"
|
cd "$OLDPWD"
|
||||||
|
|
||||||
pyenv install --skip-existing
|
|
||||||
|
|
||||||
if test -f .venv/bin/python && test "$(realpath .venv/bin/python)" != "$(realpath "$(pyenv which python)")"
|
if test -f .venv/bin/python && test "$(realpath .venv/bin/python)" != "$(realpath "$(pyenv which python)")"
|
||||||
then
|
then
|
||||||
echo "rebuilding venv für new python version"
|
echo "rebuilding venv für new python version"
|
||||||
|
|
|
||||||
|
|
@ -1,26 +0,0 @@
|
||||||
# Mailman
|
|
||||||
|
|
||||||
- django admin udner /admin
|
|
||||||
|
|
||||||
## Testmail
|
|
||||||
|
|
||||||
`echo export REST_API_PASS=$(bw metadata mseibert.mailman -k mailman/api_password | jq -r .mailman.api_password)`
|
|
||||||
```sh
|
|
||||||
curl -s -o /dev/null \
|
|
||||||
-w "Status: %{http_code}\nTime: %{time_total}s\n" \
|
|
||||||
-u restadmin:$REST_API_PASS \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-X POST http://localhost:8001/3.1/queues/in \
|
|
||||||
-d "{
|
|
||||||
\"list_id\": \"testlist-2.mailman.ckn.li\",
|
|
||||||
\"text\": \"From: i@ckn.li\nTo: testlist-2@mailman.ckn.li\nSubject: Curl Test $(date '+%Y-%m-%d %H:%M:%S')\n\nThis message was sent at $(date '+%Y-%m-%d %H:%M:%S').\"
|
|
||||||
}"
|
|
||||||
```
|
|
||||||
|
|
||||||
## Log locations
|
|
||||||
|
|
||||||
`tail -f /var/log/mailman3/*.log`
|
|
||||||
|
|
||||||
`journalctl -f | grep postfix/`
|
|
||||||
|
|
||||||
`mailq | head -20`
|
|
||||||
|
|
@ -250,6 +250,12 @@ outgoing: mailman.mta.deliver.deliver
|
||||||
|
|
||||||
# How to connect to the outgoing MTA. If smtp_user and smtp_pass is given,
|
# How to connect to the outgoing MTA. If smtp_user and smtp_pass is given,
|
||||||
# then Mailman will attempt to log into the MTA when making a new connection.
|
# then Mailman will attempt to log into the MTA when making a new connection.
|
||||||
|
# smtp_host: smtp.ionos.de
|
||||||
|
# smtp_port: 587
|
||||||
|
# smtp_user: ${smtp_user}
|
||||||
|
# smtp_pass: ${smtp_password}
|
||||||
|
# smtp_secure_mode: starttls
|
||||||
|
|
||||||
smtp_host: 127.0.0.1
|
smtp_host: 127.0.0.1
|
||||||
smtp_port: 25
|
smtp_port: 25
|
||||||
smtp_user:
|
smtp_user:
|
||||||
|
|
|
||||||
|
|
@ -39,8 +39,7 @@ mynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128
|
||||||
mailbox_size_limit = 0
|
mailbox_size_limit = 0
|
||||||
recipient_delimiter = +
|
recipient_delimiter = +
|
||||||
inet_interfaces = all
|
inet_interfaces = all
|
||||||
#inet_protocols = all
|
inet_protocols = all
|
||||||
inet_protocols = ipv4
|
|
||||||
|
|
||||||
unknown_local_recipient_reject_code = 550
|
unknown_local_recipient_reject_code = 550
|
||||||
owner_request_special = no
|
owner_request_special = no
|
||||||
|
|
|
||||||
|
|
@ -114,36 +114,3 @@ def secrets(metadata):
|
||||||
'archiver_key': derive_mailadmin_secret(metadata, 'archiver_key'),
|
'archiver_key': derive_mailadmin_secret(metadata, 'archiver_key'),
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
|
||||||
'dns',
|
|
||||||
)
|
|
||||||
def dns(metadata):
|
|
||||||
report_email = metadata.get('mailman/dmarc_report_email')
|
|
||||||
|
|
||||||
return {
|
|
||||||
'dns': {
|
|
||||||
metadata.get('mailman/hostname'): {
|
|
||||||
'MX': [f"5 {metadata.get('mailman/hostname')}."],
|
|
||||||
'TXT': [
|
|
||||||
'v=spf1 a mx -all',
|
|
||||||
'; '.join(f'{k}={v}' for k, v in {
|
|
||||||
# dmarc version
|
|
||||||
'v': 'DMARC1',
|
|
||||||
# reject on failure
|
|
||||||
'p': 'reject',
|
|
||||||
# standard reports
|
|
||||||
'rua': f'mailto:{report_email}',
|
|
||||||
# forensic reports
|
|
||||||
'fo': 1,
|
|
||||||
'ruf': f'mailto:{report_email}',
|
|
||||||
# require alignment between the DKIM domain and the parent Header From domain
|
|
||||||
'adkim': 's',
|
|
||||||
# require alignment between the SPF domain (the sender) and the Header From domain
|
|
||||||
'aspf': 's',
|
|
||||||
}.items())
|
|
||||||
],
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
|
||||||
|
|
@ -32,14 +32,10 @@ defaults = {
|
||||||
'tank/vmail': {
|
'tank/vmail': {
|
||||||
'mountpoint': '/var/vmail',
|
'mountpoint': '/var/vmail',
|
||||||
'compression': 'on',
|
'compression': 'on',
|
||||||
'atime': 'off',
|
|
||||||
'recordsize': '16384',
|
|
||||||
},
|
},
|
||||||
'tank/vmail/index': {
|
'tank/vmail/index': {
|
||||||
'mountpoint': '/var/vmail/index',
|
'mountpoint': '/var/vmail/index',
|
||||||
'compression': 'on',
|
'compression': 'on',
|
||||||
'atime': 'off',
|
|
||||||
'recordsize': '4096',
|
|
||||||
'com.sun:auto-snapshot': 'false',
|
'com.sun:auto-snapshot': 'false',
|
||||||
'backup': False,
|
'backup': False,
|
||||||
},
|
},
|
||||||
|
|
@ -82,7 +78,6 @@ def dns(metadata):
|
||||||
'dns': dns,
|
'dns': dns,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'letsencrypt/domains',
|
'letsencrypt/domains',
|
||||||
)
|
)
|
||||||
|
|
|
||||||
|
|
@ -42,7 +42,7 @@ def user(metadata):
|
||||||
'users': {
|
'users': {
|
||||||
'sshmon': {
|
'sshmon': {
|
||||||
'authorized_users': {
|
'authorized_users': {
|
||||||
'nagios@' + metadata.get('monitoring/icinga2_node'): {},
|
'nagios@' + metadata.get('monitoring/icinga2_node'),
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
@ -50,7 +50,7 @@ def user(metadata):
|
||||||
'sshmon': {
|
'sshmon': {
|
||||||
conf['vars.command']
|
conf['vars.command']
|
||||||
for conf in metadata.get('monitoring/services').values()
|
for conf in metadata.get('monitoring/services').values()
|
||||||
if conf.get('check_command') == 'sshmon'
|
if conf['check_command'] == 'sshmon'
|
||||||
and conf.get('vars.sudo', None)
|
and conf.get('vars.sudo', None)
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -1,19 +0,0 @@
|
||||||
for network_name, network_conf in node.metadata.get('network').items():
|
|
||||||
if 'qdisc' in network_conf:
|
|
||||||
svc_systemd[f'qdisc-{network_name}.service'] = {
|
|
||||||
'enabled': True,
|
|
||||||
'running': None,
|
|
||||||
'needs': {
|
|
||||||
f'file:/usr/local/lib/systemd/system/qdisc-{network_name}.service',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
actions[f'qdisc-{network_name}.service_restart_workaround'] = {
|
|
||||||
'command': 'true',
|
|
||||||
'triggered': True,
|
|
||||||
'triggered_by': {
|
|
||||||
f'file:/usr/local/lib/systemd/system/qdisc-{network_name}.service',
|
|
||||||
},
|
|
||||||
'triggers': {
|
|
||||||
f'svc_systemd:qdisc-{network_name}.service:restart',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
@ -34,15 +34,12 @@ def dhcp(metadata):
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'systemd/units',
|
'systemd/units',
|
||||||
'modules-load',
|
|
||||||
)
|
)
|
||||||
def units(metadata):
|
def units(metadata):
|
||||||
networks = metadata.get('network', {})
|
|
||||||
if node.has_bundle('systemd-networkd'):
|
if node.has_bundle('systemd-networkd'):
|
||||||
units = {}
|
units = {}
|
||||||
modules_load = set()
|
|
||||||
|
|
||||||
for network_name, network_conf in networks.items():
|
for network_name, network_conf in metadata.get('network').items():
|
||||||
interface_type = network_conf.get('type', None)
|
interface_type = network_conf.get('type', None)
|
||||||
|
|
||||||
# network
|
# network
|
||||||
|
|
@ -53,12 +50,8 @@ def units(metadata):
|
||||||
},
|
},
|
||||||
'Network': {
|
'Network': {
|
||||||
'DHCP': network_conf.get('dhcp', 'no'),
|
'DHCP': network_conf.get('dhcp', 'no'),
|
||||||
'IPv6AcceptRA': network_conf.get('IPv6AcceptRA', 'no'),
|
'IPv6AcceptRA': network_conf.get('dhcp', 'no'),
|
||||||
'VLAN': set(
|
'VLAN': set(network_conf.get('vlans', set()))
|
||||||
other_network_name
|
|
||||||
for other_network_name, other_network_conf in metadata.get('network', {}).items()
|
|
||||||
if other_network_conf.get('type') == 'vlan' and other_network_conf['vlan_interface'] == network_name
|
|
||||||
)
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -97,51 +90,10 @@ def units(metadata):
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
# cake WIP
|
|
||||||
|
|
||||||
if 'cake' in network_conf:
|
|
||||||
units[f'{network_name}.network']['CAKE'] = network_conf['cake']
|
|
||||||
modules_load.add('sch_cake')
|
|
||||||
|
|
||||||
return {
|
return {
|
||||||
'systemd': {
|
'systemd': {
|
||||||
'units': units,
|
'units': units,
|
||||||
},
|
}
|
||||||
'modules-load': modules_load,
|
|
||||||
}
|
|
||||||
else:
|
|
||||||
return {}
|
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
|
||||||
'systemd/units',
|
|
||||||
)
|
|
||||||
def queuing_disciplines(metadata):
|
|
||||||
networks = metadata.get('network', {})
|
|
||||||
if node.has_bundle('systemd-networkd'):
|
|
||||||
return {
|
|
||||||
'systemd': {
|
|
||||||
'units': {
|
|
||||||
f'qdisc-{network_name}.service': {
|
|
||||||
'Unit': {
|
|
||||||
'Description': f'setup queuing discipline for interface {network_name}',
|
|
||||||
'Wants': 'network.target',
|
|
||||||
'After': 'network.target',
|
|
||||||
'BindsTo': 'network.target',
|
|
||||||
},
|
|
||||||
'Service': {
|
|
||||||
'Type': 'oneshot',
|
|
||||||
'ExecStart': f'/sbin/tc qdisc replace root dev {network_name} {network_conf["qdisc"]}',
|
|
||||||
'RemainAfterExit': 'yes',
|
|
||||||
},
|
|
||||||
'Install': {
|
|
||||||
'WantedBy': 'network-online.target',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
for network_name, network_conf in networks.items()
|
|
||||||
if 'qdisc' in network_conf
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
else:
|
else:
|
||||||
return {}
|
return {}
|
||||||
|
|
|
||||||
|
|
@ -1,209 +1,78 @@
|
||||||
#!/usr/bin/env python3
|
#!/bin/bash
|
||||||
import argparse
|
|
||||||
import base64
|
|
||||||
import hashlib
|
|
||||||
import os
|
|
||||||
import shutil
|
|
||||||
import subprocess
|
|
||||||
from concurrent.futures import ThreadPoolExecutor, as_completed
|
|
||||||
from datetime import datetime
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
|
USER="$1"
|
||||||
|
|
||||||
ALLOWED_EXTS = {
|
REL_SOURCE_PATH="/$1/files/$2"
|
||||||
".png", ".jpg", ".jpeg", ".heic", ".cr2", ".cr3", ".mp4", ".mov",
|
ABS_SOURCE_PATH="/var/lib/nextcloud/$1/files/$2"
|
||||||
".webp", ".avif", ".gif",
|
|
||||||
}
|
|
||||||
|
|
||||||
DATETIME_KEYS = [
|
REL_DEST_PATH="/$1/files/$3"
|
||||||
("Composite", "SubSecDateTimeOriginal"),
|
ABS_DEST_PATH="/var/lib/nextcloud/$1/files/$3"
|
||||||
("Composite", "SubSecCreateDate"),
|
|
||||||
("ExifIFD", "DateTimeOriginal"),
|
|
||||||
("ExifIFD", "CreateDate"),
|
|
||||||
("XMP-xmp", "CreateDate"),
|
|
||||||
("Keys", "CreationDate"),
|
|
||||||
("QuickTime", "CreateDate"),
|
|
||||||
("XMP-photoshop", "DateCreated"),
|
|
||||||
]
|
|
||||||
|
|
||||||
|
REL_UNSORTABLE_PATH="/$1/files/$4"
|
||||||
|
ABS_UNSORTABLE_PATH="/var/lib/nextcloud/$1/files/$4"
|
||||||
|
|
||||||
def run(command: list[str], check: bool = True) -> subprocess.CompletedProcess:
|
echo "STARTING..."
|
||||||
return subprocess.run(command, text=True, capture_output=True, check=check)
|
|
||||||
|
|
||||||
|
chown -R www-data:www-data "$ABS_SOURCE_PATH"
|
||||||
|
chmod -R 770 "$ABS_SOURCE_PATH"
|
||||||
|
|
||||||
def exiftool_data(file: Path) -> dict | None:
|
SCAN="FALSE"
|
||||||
result = run([
|
IFS=$'\n'
|
||||||
"exiftool",
|
for f in `find "$ABS_SOURCE_PATH" -iname *.PNG -o -iname *.JPG -o -iname *.JPEG -o -iname *.HEIC -o -iname *.CR2 -o -iname *.CR3 -o -iname *.MP4 -o -iname *.MOV`; do
|
||||||
"-j",
|
SCAN="TRUE"
|
||||||
"-a",
|
echo "PROCESSING: $f"
|
||||||
"-u",
|
|
||||||
"-g1",
|
|
||||||
"-time:all",
|
|
||||||
"-api", "QuickTimeUTC=1",
|
|
||||||
"-d", "%Y-%m-%dT%H:%M:%S%z",
|
|
||||||
str(file),
|
|
||||||
], check=False)
|
|
||||||
if result.returncode != 0:
|
|
||||||
return None
|
|
||||||
try:
|
|
||||||
data = __import__("json").loads(result.stdout)
|
|
||||||
return data[0] if data else None
|
|
||||||
except Exception:
|
|
||||||
return None
|
|
||||||
|
|
||||||
|
EXIF=`exiftool "$f"`
|
||||||
|
if grep -q '^Create Date' <<< $EXIF
|
||||||
|
then
|
||||||
|
DATETIME=`grep -m 1 "^Create Date" <<< $EXIF | cut -d: -f2- | xargs`
|
||||||
|
elif grep -q '^File Modification Date' <<< $EXIF
|
||||||
|
then
|
||||||
|
DATETIME=`grep -m 1 '^File Modification Date' <<< $EXIF | cut -d: -f2- | xargs`
|
||||||
|
else
|
||||||
|
RELPATH=$(realpath --relative-to="$ABS_SOURCE_PATH" "$f")
|
||||||
|
DIRNAME=$(dirname "$ABS_UNSORTABLE_PATH/$RELPATH")
|
||||||
|
echo "UNSORTABLE: $f"
|
||||||
|
mkdir -p "$DIRNAME"
|
||||||
|
mv "$f" "$DIRNAME"
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
def exiftool_timestamp(file: Path) -> datetime | None:
|
DATE=`cut -d' ' -f1 <<< $DATETIME`
|
||||||
data = exiftool_data(file)
|
TIME=`cut -d' ' -f2 <<< $DATETIME | cut -d'+' -f1`
|
||||||
if not data:
|
|
||||||
return None
|
|
||||||
|
|
||||||
for category, key in DATETIME_KEYS:
|
YEAR=`cut -d':' -f1 <<< $DATE`
|
||||||
try:
|
MONTH=`cut -d':' -f2 <<< $DATE`
|
||||||
value = data[category][key]
|
DAY=`cut -d':' -f3 <<< $DATE`
|
||||||
except (KeyError, TypeError):
|
HOUR=`cut -d':' -f1 <<< $TIME`
|
||||||
continue
|
MINUTE=`cut -d':' -f2 <<< $TIME`
|
||||||
try:
|
SECOND=`cut -d':' -f3 <<< $TIME`
|
||||||
return datetime.strptime(value, "%Y-%m-%dT%H:%M:%S%z")
|
|
||||||
except ValueError:
|
|
||||||
continue
|
|
||||||
|
|
||||||
return None
|
HASH=`sha256sum "$f" | xxd -r -p | base64 | head -c 3 | tr '/+' '_-'`
|
||||||
|
EXT=`echo "${f##*.}" | tr '[:upper:]' '[:lower:]'`
|
||||||
|
if [[ "$EXT" = "cr2" ]] || [[ "$EXT" = "cr3" ]]
|
||||||
|
then
|
||||||
|
RAW="raw/"
|
||||||
|
else
|
||||||
|
RAW=""
|
||||||
|
fi
|
||||||
|
FILE="$ABS_DEST_PATH/$YEAR-$MONTH/$RAW$YEAR$MONTH$DAY"-"$HOUR$MINUTE$SECOND"_"$HASH"."$EXT"
|
||||||
|
echo "DESTINATION: $FILE"
|
||||||
|
mkdir -p "$(dirname "$FILE")"
|
||||||
|
mv -v "$f" "$FILE"
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ "$SCAN" == "TRUE" ]; then
|
||||||
|
echo "SCANNING..."
|
||||||
|
# find "$ABS_SOURCE_PATH/"* -type d -empty -delete >> /var/echo/nc-picsort.echo # nextcloud app bug when deleting folders
|
||||||
|
chown -R www-data:www-data "$ABS_DEST_PATH"
|
||||||
|
chown -R www-data:www-data "$ABS_UNSORTABLE_PATH"
|
||||||
|
chmod -R 770 "$ABS_DEST_PATH"
|
||||||
|
chmod -R 770 "$ABS_UNSORTABLE_PATH"
|
||||||
|
sudo -u www-data php /opt/nextcloud/occ files:scan --path "$REL_SOURCE_PATH"
|
||||||
|
sudo -u www-data php /opt/nextcloud/occ files:scan --path "$REL_UNSORTABLE_PATH"
|
||||||
|
sudo -u www-data php /opt/nextcloud/occ files:scan --path "$REL_DEST_PATH"
|
||||||
|
#sudo -u www-data php /opt/nextcloud/occ preview:pre-generate
|
||||||
|
fi
|
||||||
|
|
||||||
def short_hash(file: Path) -> str:
|
echo "FINISH."
|
||||||
h = hashlib.sha256()
|
|
||||||
with file.open("rb") as fh:
|
|
||||||
for chunk in iter(lambda: fh.read(1024 * 1024), b""):
|
|
||||||
h.update(chunk)
|
|
||||||
digest = h.digest()
|
|
||||||
b64 = base64.b64encode(digest).decode("ascii")
|
|
||||||
return b64[:3].replace("/", "_").replace("+", "-")
|
|
||||||
|
|
||||||
|
|
||||||
def build_destination(dest_root: Path, file: Path, ts: datetime) -> Path:
|
|
||||||
ext = file.suffix.lower().lstrip(".")
|
|
||||||
year = ts.strftime("%Y")
|
|
||||||
month = ts.strftime("%m")
|
|
||||||
day = ts.strftime("%d")
|
|
||||||
hour = ts.strftime("%H")
|
|
||||||
minute = ts.strftime("%M")
|
|
||||||
second = ts.strftime("%S")
|
|
||||||
hash_part = short_hash(file)
|
|
||||||
|
|
||||||
raw_subdir = "raw" if ext in {"cr2", "cr3"} else None
|
|
||||||
month_dir = dest_root / f"{year}-{month}"
|
|
||||||
if raw_subdir:
|
|
||||||
month_dir = month_dir / raw_subdir
|
|
||||||
|
|
||||||
filename = f"{year}{month}{day}-{hour}{minute}{second}_{hash_part}.{ext}"
|
|
||||||
return month_dir / filename
|
|
||||||
|
|
||||||
|
|
||||||
def move_unsortable(file: Path, source_root: Path, unsortable_root: Path) -> None:
|
|
||||||
relpath = file.relative_to(source_root)
|
|
||||||
target_dir = (unsortable_root / relpath).parent
|
|
||||||
target_dir.mkdir(parents=True, exist_ok=True)
|
|
||||||
shutil.chown(str(target_dir), user="www-data", group="www-data")
|
|
||||||
target = target_dir / file.name
|
|
||||||
if target.exists():
|
|
||||||
return
|
|
||||||
shutil.move(str(file), str(target))
|
|
||||||
shutil.chown(str(target), user="www-data", group="www-data")
|
|
||||||
|
|
||||||
|
|
||||||
def move_sorted(file: Path, target: Path) -> None:
|
|
||||||
target.parent.mkdir(parents=True, exist_ok=True)
|
|
||||||
shutil.chown(str(target.parent), user="www-data", group="www-data")
|
|
||||||
shutil.move(str(file), str(target))
|
|
||||||
shutil.chown(str(target), user="www-data", group="www-data")
|
|
||||||
|
|
||||||
def process_file(file: Path, source_root: Path, dest_root: Path, unsortable_root: Path) -> tuple[Path, str]:
|
|
||||||
print(f"PROCESSING: {file}")
|
|
||||||
ts = exiftool_timestamp(file)
|
|
||||||
|
|
||||||
if ts is None:
|
|
||||||
print(f"UNSORTABLE: {file}")
|
|
||||||
move_unsortable(file, source_root, unsortable_root)
|
|
||||||
return file, "unsortable"
|
|
||||||
|
|
||||||
target = build_destination(dest_root, file, ts)
|
|
||||||
print(f"DESTINATION: {target}")
|
|
||||||
move_sorted(file, target)
|
|
||||||
return file, "sorted"
|
|
||||||
|
|
||||||
|
|
||||||
def scan_nextcloud(rel_source: str, rel_unsortable: str, rel_dest: str) -> None:
|
|
||||||
print("SCANNING...")
|
|
||||||
# run(["chown", "-R", "www-data:www-data", abs_source_path], check=True)
|
|
||||||
# run(["chmod", "-R", "770", abs_source_path], check=True)
|
|
||||||
|
|
||||||
# run(["chown", "-R", "www-data:www-data", abs_dest_path], check=True)
|
|
||||||
# run(["chown", "-R", "www-data:www-data", abs_unsortable_path], check=True)
|
|
||||||
# run(["chmod", "-R", "770", abs_dest_path], check=True)
|
|
||||||
# run(["chmod", "-R", "770", abs_unsortable_path], check=True)
|
|
||||||
|
|
||||||
run(["sudo", "-u", "www-data", "php", "/opt/nextcloud/occ", "files:scan", "--path", rel_source], check=True)
|
|
||||||
run(["sudo", "-u", "www-data", "php", "/opt/nextcloud/occ", "files:scan", "--path", rel_unsortable], check=True)
|
|
||||||
run(["sudo", "-u", "www-data", "php", "/opt/nextcloud/occ", "files:scan", "--path", rel_dest], check=True)
|
|
||||||
|
|
||||||
run(["systemctl", "start", "nextcloud-generate-new-previews.service"], check=True)
|
|
||||||
|
|
||||||
|
|
||||||
def iter_files(source_root: Path):
|
|
||||||
for path in source_root.rglob("*"):
|
|
||||||
if path.is_file() and path.suffix.lower() in ALLOWED_EXTS:
|
|
||||||
yield path
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
parser = argparse.ArgumentParser(
|
|
||||||
description="Sort Nextcloud media files by embedded timestamp."
|
|
||||||
)
|
|
||||||
parser.add_argument("nc_user")
|
|
||||||
parser.add_argument("source_subdir")
|
|
||||||
parser.add_argument("dest_subdir")
|
|
||||||
parser.add_argument("unsortable_subdir")
|
|
||||||
parser.add_argument("--workers", type=int, default=os.cpu_count() or 1)
|
|
||||||
args = parser.parse_args()
|
|
||||||
|
|
||||||
nc_user = args.nc_user
|
|
||||||
source_subdir = args.source_subdir
|
|
||||||
dest_subdir = args.dest_subdir
|
|
||||||
unsortable_subdir = args.unsortable_subdir
|
|
||||||
|
|
||||||
rel_source_path = f"/{nc_user}/files/{source_subdir}"
|
|
||||||
abs_source_path = f"/var/lib/nextcloud/{nc_user}/files/{source_subdir}"
|
|
||||||
|
|
||||||
rel_dest_path = f"/{nc_user}/files/{dest_subdir}"
|
|
||||||
abs_dest_path = f"/var/lib/nextcloud/{nc_user}/files/{dest_subdir}"
|
|
||||||
|
|
||||||
rel_unsortable_path = f"/{nc_user}/files/{unsortable_subdir}"
|
|
||||||
abs_unsortable_path = f"/var/lib/nextcloud/{nc_user}/files/{unsortable_subdir}"
|
|
||||||
|
|
||||||
source_root = Path(abs_source_path)
|
|
||||||
dest_root = Path(abs_dest_path)
|
|
||||||
unsortable_root = Path(abs_unsortable_path)
|
|
||||||
|
|
||||||
print("STARTING...")
|
|
||||||
|
|
||||||
run(["chown", "-R", "www-data:www-data", str(source_root)], check=True)
|
|
||||||
run(["chmod", "-R", "770", str(source_root)], check=True)
|
|
||||||
|
|
||||||
files = list(iter_files(source_root))
|
|
||||||
|
|
||||||
if not files:
|
|
||||||
print("NO MATCHING FILES FOUND.")
|
|
||||||
print("FINISH.")
|
|
||||||
raise SystemExit(0)
|
|
||||||
|
|
||||||
with ThreadPoolExecutor(max_workers=max(1, args.workers)) as executor:
|
|
||||||
futures = {
|
|
||||||
executor.submit(process_file, file, source_root, dest_root, unsortable_root): file
|
|
||||||
for file in files
|
|
||||||
}
|
|
||||||
for future in as_completed(futures):
|
|
||||||
future.result()
|
|
||||||
|
|
||||||
scan_nextcloud(rel_source_path, rel_unsortable_path, rel_dest_path)
|
|
||||||
|
|
||||||
print("FINISH.")
|
|
||||||
|
|
|
||||||
|
|
@ -1,71 +0,0 @@
|
||||||
Nextcloud
|
|
||||||
=========
|
|
||||||
|
|
||||||
import iphone pictures
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
Use Photos app on macOS
|
|
||||||
- select library in the left sidebar
|
|
||||||
- select the pictures
|
|
||||||
- in menu bar open File > Export Unmodified Original for X Photos
|
|
||||||
|
|
||||||
The only reliable way to get some files creation time is being lost with rsync, so
|
|
||||||
we need to embed those timestamps on macos first:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
PHOTOS_PATH="/Users/mwiegand/Desktop/photos"
|
|
||||||
bin/timestamp_icloud_photos_for_nextcloud -d "$PHOTOS_PATH"
|
|
||||||
rsync -avh --progress --rsync-path="sudo rsync" "$PHOTOS_PATH/" ckn@10.0.0.2:/var/lib/nextcloud/ckn/files/SofortUpload/AutoSort/
|
|
||||||
```
|
|
||||||
|
|
||||||
preview generator
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
```
|
|
||||||
sudo -u www-data php /opt/nextcloud/occ preview:generate-all -w "$(nproc)" -n -vvv
|
|
||||||
```
|
|
||||||
|
|
||||||
This index speeds up preview generator dramatically:
|
|
||||||
```sh
|
|
||||||
CREATE INDEX CONCURRENTLY oc_filecache_path_hash_idx
|
|
||||||
ON oc_filecache (path_hash);
|
|
||||||
```
|
|
||||||
|
|
||||||
delete previews:
|
|
||||||
```sh
|
|
||||||
psql nextcloud -x -c "DELETE FROM oc_previews;"
|
|
||||||
rm -rf /var/lib/nextcloud/appdata_oci6dw1woodz/preview/*
|
|
||||||
```
|
|
||||||
|
|
||||||
https://docs.nextcloud.com/server/stable/admin_manual/configuration_files/previews_configuration.html#maximum-preview-size
|
|
||||||
```php
|
|
||||||
'preview_max_x' => 1920,
|
|
||||||
'preview_max_y' => 1920,
|
|
||||||
'preview_max_scale_factor' => 4,
|
|
||||||
```
|
|
||||||
|
|
||||||
https://github.com/nextcloud/previewgenerator?tab=readme-ov-file#i-dont-want-to-generate-all-the-preview-sizes
|
|
||||||
```sh
|
|
||||||
sudo -u www-data php /opt/nextcloud/occ config:app:set --value="64 256" previewgenerator squareSizes
|
|
||||||
sudo -u www-data php /opt/nextcloud/occ config:app:set --value="" previewgenerator fillWidthHeightSizes # changed
|
|
||||||
sudo -u www-data php /opt/nextcloud/occ config:app:set --value="" previewgenerator widthSizes
|
|
||||||
sudo -u www-data php /opt/nextcloud/occ config:app:set --value="" previewgenerator heightSizes
|
|
||||||
sudo -u www-data php /opt/nextcloud/occ config:app:set preview jpeg_quality --value="75"
|
|
||||||
sudo -u www-data php /opt/nextcloud/occ config:app:set --value=0 --type=integer previewgenerator job_max_previews # in favour of systemd timer
|
|
||||||
```
|
|
||||||
|
|
||||||
gen previews
|
|
||||||
```sh
|
|
||||||
php /opt/nextcloud/occ preview:generate-all --workers="$(nproc)" --no-interaction -vvv
|
|
||||||
```
|
|
||||||
|
|
||||||
check preview geenration
|
|
||||||
```sh
|
|
||||||
find /var/lib/nextcloud/appdata_oci6dw1woodz/preview
|
|
||||||
# /var/lib/nextcloud/appdata_oci6dw1woodz/preview/6/9/1/f/7/b/4/2822419/64-64-crop.jpg
|
|
||||||
# /var/lib/nextcloud/appdata_oci6dw1woodz/preview/6/9/1/f/7/b/4/2822419/256-256-crop.jpg
|
|
||||||
# /var/lib/nextcloud/appdata_oci6dw1woodz/preview/6/9/1/f/7/b/4/2822419/1280-1920-max.jpg
|
|
||||||
|
|
||||||
du -sh /var/lib/nextcloud/appdata_oci6dw1woodz/preview
|
|
||||||
# 28G /var/lib/nextcloud/appdata_oci6dw1woodz/preview
|
|
||||||
```
|
|
||||||
5
bundles/nextcloud/files/rescan
Normal file
5
bundles/nextcloud/files/rescan
Normal file
|
|
@ -0,0 +1,5 @@
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
php /opt/nextcloud/occ files:scan --all
|
||||||
|
php /opt/nextcloud/occ files:scan-app-data
|
||||||
|
#php /opt/nextcloud/occ preview:generate-all
|
||||||
|
|
@ -146,3 +146,15 @@ actions['nextcloud_add_missing_inidces'] = {
|
||||||
f'action:extract_nextcloud',
|
f'action:extract_nextcloud',
|
||||||
],
|
],
|
||||||
}
|
}
|
||||||
|
|
||||||
|
# RESCAN
|
||||||
|
|
||||||
|
files['/opt/nextcloud_rescan'] = {
|
||||||
|
'source': 'rescan',
|
||||||
|
'owner': 'www-data',
|
||||||
|
'group': 'www-data',
|
||||||
|
'mode': '550',
|
||||||
|
'needs': [
|
||||||
|
'action:extract_nextcloud',
|
||||||
|
],
|
||||||
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
from shlex import quote
|
import string
|
||||||
|
from uuid import UUID
|
||||||
|
|
||||||
defaults = {
|
defaults = {
|
||||||
'apt': {
|
'apt': {
|
||||||
|
|
@ -85,35 +85,11 @@ defaults = {
|
||||||
'user': 'www-data',
|
'user': 'www-data',
|
||||||
'kill_mode': 'process',
|
'kill_mode': 'process',
|
||||||
},
|
},
|
||||||
'nextcloud-scan-app-data': {
|
'nextcloud-rescan': {
|
||||||
'command': '/usr/bin/php /opt/nextcloud/occ files:scan-app-data',
|
'command': '/opt/nextcloud_rescan',
|
||||||
'when': 'yearly',
|
'when': 'Sun 00:00:00',
|
||||||
'user': 'www-data',
|
'user': 'www-data',
|
||||||
},
|
},
|
||||||
'nextcloud-scan-files': {
|
|
||||||
'command': '/usr/bin/php /opt/nextcloud/occ files:scan --all',
|
|
||||||
'when': 'weekly',
|
|
||||||
'user': 'www-data',
|
|
||||||
'after': {
|
|
||||||
'nextcloud-scan-app-data.service',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'nextcloud-generate-all-previews': {
|
|
||||||
'command': '/bin/bash -c ' + quote('php /opt/nextcloud/occ preview:generate-all --workers="$(nproc)" --no-interaction -vvv'),
|
|
||||||
'when': 'monthly',
|
|
||||||
'user': 'www-data',
|
|
||||||
'after': {
|
|
||||||
'nextcloud-scan-files.service',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
'nextcloud-generate-new-previews': {
|
|
||||||
'command': '/usr/bin/php /opt/nextcloud/occ preview:pre-generate --no-interaction -vvv',
|
|
||||||
'when': '*:0/5', # every 5 minutes
|
|
||||||
'user': 'www-data',
|
|
||||||
'after': {
|
|
||||||
'nextcloud-generate-all-previews.service',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -158,18 +134,10 @@ def config(metadata):
|
||||||
'127.0.0.1',
|
'127.0.0.1',
|
||||||
metadata.get('nextcloud/hostname'),
|
metadata.get('nextcloud/hostname'),
|
||||||
],
|
],
|
||||||
'enabledPreviewProviders': [
|
|
||||||
'OC\\Preview\\Image',
|
|
||||||
'OC\\Preview\\Movie',
|
|
||||||
'OC\\Preview\\HEIC',
|
|
||||||
],
|
|
||||||
'preview_max_x': 1920,
|
|
||||||
'preview_max_y': 1920,
|
|
||||||
'preview_max_scale_factor': 4,
|
|
||||||
'log_type': 'syslog',
|
'log_type': 'syslog',
|
||||||
'syslog_tag': 'nextcloud',
|
'syslog_tag': 'nextcloud',
|
||||||
'logfile': '',
|
'logfile': '',
|
||||||
'loglevel': 2,
|
'loglevel': 3,
|
||||||
'default_phone_region': 'DE',
|
'default_phone_region': 'DE',
|
||||||
'versions_retention_obligation': 'auto, 90',
|
'versions_retention_obligation': 'auto, 90',
|
||||||
'simpleSignUpLink.shown': False,
|
'simpleSignUpLink.shown': False,
|
||||||
|
|
|
||||||
|
|
@ -8,5 +8,4 @@ examples
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
nft add rule inet filter input tcp dport 5201 accept
|
nft add rule inet filter input tcp dport 5201 accept
|
||||||
nft add rule inet filter input udp dport 5201 accept
|
|
||||||
```
|
```
|
||||||
|
|
|
||||||
|
|
@ -2,23 +2,6 @@
|
||||||
|
|
||||||
flush ruleset
|
flush ruleset
|
||||||
|
|
||||||
% if nat:
|
|
||||||
table ip nat {
|
|
||||||
|
|
||||||
# NAT
|
|
||||||
|
|
||||||
chain postrouting {
|
|
||||||
type nat hook postrouting priority 100
|
|
||||||
policy accept
|
|
||||||
|
|
||||||
# rules
|
|
||||||
% for rule in sorted(nat):
|
|
||||||
${rule}
|
|
||||||
% endfor
|
|
||||||
}
|
|
||||||
}
|
|
||||||
% endif
|
|
||||||
|
|
||||||
table inet filter {
|
table inet filter {
|
||||||
|
|
||||||
# INPUT
|
# INPUT
|
||||||
|
|
|
||||||
|
|
@ -6,7 +6,6 @@ files = {
|
||||||
'input': node.metadata.get('nftables/input'),
|
'input': node.metadata.get('nftables/input'),
|
||||||
'forward': node.metadata.get('nftables/forward'),
|
'forward': node.metadata.get('nftables/forward'),
|
||||||
'output': node.metadata.get('nftables/output'),
|
'output': node.metadata.get('nftables/output'),
|
||||||
'nat': node.metadata.get('nftables/nat'),
|
|
||||||
},
|
},
|
||||||
'triggers': [
|
'triggers': [
|
||||||
'svc_systemd:nftables.service:reload',
|
'svc_systemd:nftables.service:reload',
|
||||||
|
|
|
||||||
|
|
@ -8,8 +8,7 @@ defaults = {
|
||||||
'input': {
|
'input': {
|
||||||
'tcp dport 22 accept',
|
'tcp dport 22 accept',
|
||||||
},
|
},
|
||||||
'forward': set(),
|
'forward': {},
|
||||||
'nat': set(),
|
'output': {},
|
||||||
'output': set(),
|
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,36 +0,0 @@
|
||||||
# nginx
|
|
||||||
|
|
||||||
Webserver. Per-node vhosts in `nginx/vhosts`; per-vhost templates in
|
|
||||||
`data/nginx/*.conf`.
|
|
||||||
|
|
||||||
## How port 80 is served
|
|
||||||
|
|
||||||
The bundle ships a fixed `80.conf` to
|
|
||||||
`/etc/nginx/sites-available/80.conf` (picked up by the
|
|
||||||
`sites-enabled/` symlink) that handles **all** port-80 traffic
|
|
||||||
across vhosts:
|
|
||||||
|
|
||||||
1. ACME HTTP-01 challenges (`/.well-known/acme-challenge/`) are
|
|
||||||
served from `/var/lib/dehydrated/acme-challenges/`.
|
|
||||||
2. All other port-80 requests are 301-redirected to
|
|
||||||
`https://$host$request_uri`.
|
|
||||||
|
|
||||||
Per-vhost templates only declare `listen 443 ssl http2;`, so they
|
|
||||||
don't need their own port-80 server blocks. If you need vhost-
|
|
||||||
specific port-80 behaviour (e.g. plain-HTTP without redirect),
|
|
||||||
override 80.conf or add a per-vhost block.
|
|
||||||
|
|
||||||
## Required metadata
|
|
||||||
|
|
||||||
- `vm/cores` — read directly by `items.py` for `worker_processes`.
|
|
||||||
No default; `bw items <node>` raises at item-build time if missing.
|
|
||||||
Typically supplied by the `vm` bundle / hetzner-vm group; double-
|
|
||||||
check on bare-metal hosts.
|
|
||||||
- `nginx/vhosts` — dict of vhost-name → vhost-config.
|
|
||||||
- `nginx/modules` — list of dynamic modules to load.
|
|
||||||
|
|
||||||
## Cross-namespace
|
|
||||||
|
|
||||||
`items.py` reads `letsencrypt/domains` to skip emitting a per-vhost
|
|
||||||
HTTPS block when LE hasn't declared the domain yet — keeps the
|
|
||||||
bundle loadable on a node where letsencrypt isn't fully wired up.
|
|
||||||
|
|
@ -32,13 +32,12 @@ http {
|
||||||
|
|
||||||
% endif
|
% endif
|
||||||
|
|
||||||
# Always defined: serves both WS-enabled vhosts (Connection: upgrade for
|
% if has_websockets:
|
||||||
# ws clients) and SSE/keep-alive vhosts (Connection: "" lets nginx manage
|
|
||||||
# the upstream connection for keep-alive, instead of forcing "close").
|
|
||||||
map $http_upgrade $connection_upgrade {
|
map $http_upgrade $connection_upgrade {
|
||||||
default upgrade;
|
default upgrade;
|
||||||
'' '';
|
'' close;
|
||||||
}
|
}
|
||||||
|
% endif
|
||||||
|
|
||||||
include /etc/nginx/sites-enabled/*;
|
include /etc/nginx/sites-enabled/*;
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -64,7 +64,7 @@ files = {
|
||||||
'svc_systemd:nginx:restart',
|
'svc_systemd:nginx:restart',
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'/etc/nginx/sites-available/80.conf': {
|
'/etc/nginx/sites/80.conf': {
|
||||||
'triggers': {
|
'triggers': {
|
||||||
'svc_systemd:nginx:restart',
|
'svc_systemd:nginx:restart',
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -25,9 +25,9 @@ defaults = {
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
'telegraf': {
|
'telegraf': {
|
||||||
'inputs': {
|
'config': {
|
||||||
'postfix': {
|
'inputs': {
|
||||||
'default': {},
|
'postfix': [{}],
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -31,17 +31,6 @@ defaults = {
|
||||||
'grafana_rows': set(),
|
'grafana_rows': set(),
|
||||||
}
|
}
|
||||||
|
|
||||||
if node.has_bundle('zfs'):
|
|
||||||
defaults['zfs'] = {
|
|
||||||
'datasets': {
|
|
||||||
'tank/postgresql': {
|
|
||||||
'mountpoint': '/var/lib/postgresql',
|
|
||||||
'recordsize': '8192',
|
|
||||||
'atime': 'off',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'postgresql/conf',
|
'postgresql/conf',
|
||||||
|
|
@ -89,17 +78,37 @@ def apt(metadata):
|
||||||
|
|
||||||
|
|
||||||
@metadata_reactor.provides(
|
@metadata_reactor.provides(
|
||||||
'telegraf/inputs/postgresql/default',
|
'zfs/datasets',
|
||||||
)
|
)
|
||||||
def telegraf(metadata):
|
def zfs(metadata):
|
||||||
|
if not node.has_bundle('zfs'):
|
||||||
|
return {}
|
||||||
|
|
||||||
return {
|
return {
|
||||||
'telegraf': {
|
'zfs': {
|
||||||
'inputs': {
|
'datasets': {
|
||||||
'postgresql': {
|
'tank/postgresql': {
|
||||||
'default': {
|
'mountpoint': '/var/lib/postgresql',
|
||||||
'address': f'postgres://root:{root_password}@localhost:5432/postgres',
|
'recordsize': '8192',
|
||||||
'databases': sorted(list(node.metadata.get('postgresql/databases').keys())),
|
'atime': 'off',
|
||||||
},
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@metadata_reactor.provides(
|
||||||
|
'telegraf/config/inputs/postgresql',
|
||||||
|
)
|
||||||
|
def telegraf(metadata):
|
||||||
|
return {
|
||||||
|
'telegraf': {
|
||||||
|
'config': {
|
||||||
|
'inputs': {
|
||||||
|
'postgresql': [{
|
||||||
|
'address': f'postgres://root:{root_password}@localhost:5432/postgres',
|
||||||
|
'databases': sorted(list(node.metadata.get('postgresql/databases').keys())),
|
||||||
|
}],
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -1,36 +0,0 @@
|
||||||
# Firtzbox
|
|
||||||
|
|
||||||
Internet > Zugangsdaten
|
|
||||||
|
|
||||||
Internetanbieter
|
|
||||||
- weitere Internetanbieter
|
|
||||||
- anderer Internetanbieter
|
|
||||||
- Name: "My PPPOE" (nicht leer lassen)
|
|
||||||
|
|
||||||
Anschluss
|
|
||||||
(x) Anschluss an einen DSL-Anschluss
|
|
||||||
|
|
||||||
Zugangsdaten
|
|
||||||
(x) Nein
|
|
||||||
|
|
||||||
Verbindungseinstellungen
|
|
||||||
|
|
||||||
[x] VLAN für den Internetanschluss verwenden
|
|
||||||
VLAN-ID: 7
|
|
||||||
PBit: 0
|
|
||||||
|
|
||||||
DSL-ATM-Einstellungen
|
|
||||||
VPI: 1
|
|
||||||
VCI: 32
|
|
||||||
|
|
||||||
Kapselung
|
|
||||||
(x) Routed Bridge Encapsulation
|
|
||||||
[x] IP-Adresse automatisch über DHCP beziehen
|
|
||||||
DHCP-Hostname: fritz.box
|
|
||||||
|
|
||||||
PPPoE-Passthrough
|
|
||||||
[x] Angeschlossene Netzwerkgeräte dürfen zusätzlich ihre eigene Internetverbindung aufbauen (nicht empfohlen)
|
|
||||||
|
|
||||||
[ ] Internetzugang nach dem "Übernehmen" prüfen
|
|
||||||
|
|
||||||
-> Danach muss bei "Internetanbieter" statt "weitere Internetanbieter" der gewählte Name stehen, also zB "My PPPOE"
|
|
||||||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue