PKR-Lab

Design: Migration ugreen-paperless → home-server

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/archiv/superpowers/specs/2026-05-26-ugreen-nas-migration-design.md

Design: Migration ugreen-paperless → home-server

Datum: 2026-05-26
Status: Approved

Ziel

Alle Geräte des Home-Labs (Home-Server, UGREEN NAS) werden ausschließlich aus
dem home-server-Repo gepflegt. Das ugreen-paperless-Repo wird nach
erfolgreicher Migration archiviert.

Scope

Migriert:

Nicht migriert (fallen weg):

Verzeichnisstruktur

ansible/
├── inventory/
│   └── hosts.yml                   # GEÄNDERT: ugreen-nas hinzugefügt
├── host_vars/                      # NEU
│   └── ugreen-nas/
│       ├── vars.yml                # NAS-Variablen (ports, image-tags, paths)
│       └── vault.yml               # Ansible-Vault: Passwörter, API-Keys, Tokens
├── group_vars/
│   └── all.yml                     # UNVERÄNDERT (nur Home-Server-Vars)
├── roles/
│   ├── (bestehende Rollen)         # UNVERÄNDERT
│   ├── paperless/                  # NEU (migriert)
│   ├── node_exporter_nas/          # NEU (migriert + umbenannt)
│   ├── opencode/                   # NEU (migriert)
│   ├── tinyteller/                 # NEU (migriert)
│   └── day_pilot/                  # NEU (migriert + umbenannt)
├── site.yml                        # UNVERÄNDERT (Home-Server-Playbook)
└── ugreen-nas.yml                  # NEU: NAS-Playbook

Inventory

capulus-ansible/inventory/hosts.yml bekommt ugreen-nas als zweiten Host:

all:
  hosts:
    home-server:
      ansible_host: 192.168.178.94
      ansible_user: ubuntu
    ugreen-nas:
      ansible_host: jays-ugreen
      ansible_user: ubuntu

Playbook ansible/ugreen-nas.yml

- name: Deploy NAS services
  hosts: ugreen-nas
  become: true
  roles:
    - paperless
    - node_exporter_nas
    - opencode
    - tinyteller
    - day_pilot

Variablen & Secrets

Alle NAS-spezifischen Variablen liegen in capulus-ansible/host_vars/ugreen-nas/:

Vault-Konvention (identisch zum bestehenden Repo):

# vault.yml (encrypted)
vault_paperless_db_password: ...

# vars.yml
paperless_db_password: "{{ vault_paperless_db_password }}"

Gleiche Vault-Passphrase wie group_vars/all.yml — ein --ask-vault-pass reicht.

Makefile

Neue Targets:

nas         # ansible-playbook ansible/ugreen-nas.yml --ask-vault-pass
nas-check   # Dry-run (--check) des NAS-Playbooks

Monitoring-Integration

Die node_exporter_nas-Rolle deployt Node-Exporter (Port 9100) und cAdvisor
(Port 18080) per Docker Compose auf dem NAS.

Im Cluster wird argocd/apps/tech/monitoring/ um einen VMStaticScrape erweitert,
der auf jays-ugreen:9100 und jays-ugreen:18080 zeigt. Kein separater
Grafana-/Prometheus-Stack auf dem NAS.

Semaphore

semaphore_projects in group_vars/all.yml wird angepasst:

Altes Repo

Nach erstem erfolgreichem make nas-Run: ugreen-paperless-Repo auf GitHub
auf read-only (archived) setzen.