pan
77 lines
3.3 KiB
Markdown
77 lines
3.3 KiB
Markdown
# synadm TUI – Thüringen Edition
|
||
|
||
Die Thüringen Edition ergänzt den unveränderten Anwendungskern von [`synadm-tui`](https://git.blackwall.ipv64.de/pan/synadm-tui) um das Thüringen-Thema, das Wappen und getrennte Release-Pakete.
|
||
|
||
Programmlogik, Navigation, Assistenten und Sicherheitsfunktionen werden nicht kopiert. Das Repository bindet einen geprüften `synadm-tui`-Stand als Git-Submodul ein; dadurch bleiben beide Editionen funktional identisch.
|
||
|
||
## Quellcode testen
|
||
|
||
```bash
|
||
git clone --recurse-submodules https://git.blackwall.ipv64.de/pan/synadm-tui-thueringen.git
|
||
cd synadm-tui-thueringen
|
||
PYTHONPATH=vendor/synadm-tui python3 -m unittest discover -v
|
||
PYTHONPATH=vendor/synadm-tui python3 -m synadm_tui_thueringen --version
|
||
```
|
||
|
||
## Native Datei und Pakete bauen
|
||
|
||
```bash
|
||
python3 -m pip install pyinstaller
|
||
python3 scripts/build_native.py
|
||
python3 scripts/build_packages.py
|
||
cd dist/packages && sha256sum --check SHA256SUMS
|
||
```
|
||
|
||
## Pakete ohne Runner veröffentlichen
|
||
|
||
```bash
|
||
python3 scripts/publish_packages.py --tea-login Building --dry-run
|
||
python3 scripts/publish_packages.py --tea-login Building
|
||
```
|
||
|
||
DEB-Pakete werden in die Distribution `thueringen`, RPM-Pakete in die Gruppe `thueringen` veröffentlicht. Dadurch bleiben auch die Paketquellen von der Standard Edition getrennt.
|
||
|
||
## Über APT installieren
|
||
|
||
```bash
|
||
sudo install -d -m 0755 /etc/apt/keyrings
|
||
sudo curl -fsSL https://git.blackwall.ipv64.de/api/packages/pan/debian/repository.key \
|
||
-o /etc/apt/keyrings/pan-gitea.asc
|
||
echo "deb [signed-by=/etc/apt/keyrings/pan-gitea.asc] https://git.blackwall.ipv64.de/api/packages/pan/debian thueringen main" \
|
||
| sudo tee /etc/apt/sources.list.d/synadm-tui-thueringen.list
|
||
sudo apt update
|
||
sudo apt install synadm-tui-thueringen
|
||
```
|
||
|
||
Dieser Ablauf wurde mit Version 0.15 in einer isolierten APT-Umgebung geprüft: Signaturprüfung, Paketauflösung, Download, Dateirechte und Programmstart waren erfolgreich.
|
||
|
||
## RPM-Status
|
||
|
||
Die getrennte RPM-Quelle ist unter
|
||
`https://git.blackwall.ipv64.de/api/packages/pan/rpm/thueringen.repo` erreichbar. Metadaten, SHA256-Prüfsumme, Paketinhalt und Programmstart von Version 0.15 wurden geprüft. Ein realer Test unter Fedora 42 mit DNF5 lädt Repository und Paket korrekt, beendet die Transaktion aber mit `The package is not signed`. Die bisher veröffentlichte RPM-Datei besitzt noch keine eingebettete Paketsignatur, obwohl die Gitea-Repository-Datei `gpgcheck=1` aktiviert. Die DNF-Installation wird deshalb erst nach Einrichtung eines dauerhaften RPM-Signaturschlüssels empfohlen; `gpgcheck` sollte nicht deaktiviert werden.
|
||
|
||
## Gemeinsamen Kern aktualisieren
|
||
|
||
Nach einem neuen `synadm-tui`-Release wird ausschließlich der Submodul-Pin aktualisiert:
|
||
|
||
```bash
|
||
git -C vendor/synadm-tui fetch --tags
|
||
git -C vendor/synadm-tui checkout vNEUE_VERSION
|
||
git add vendor/synadm-tui
|
||
PYTHONPATH=vendor/synadm-tui python3 -m unittest discover -v
|
||
```
|
||
|
||
Anschließend werden Overlay-Version, Binärdatei und Pakete mit derselben Versionsnummer gebaut. Programmlogik wird nicht kopiert.
|
||
|
||
## Voraussetzungen
|
||
|
||
- Linux x86-64 oder ARM64
|
||
- Python 3.10+ für den Quellstart
|
||
- PyInstaller für native Builds
|
||
- `dpkg-deb` und `rpmbuild` für Systempakete
|
||
- separat installiertes `synadm`, wahlweise über den integrierten Installationsassistenten
|
||
|
||
## Lizenz
|
||
|
||
GPL-3.0-or-later, siehe `LICENSE`.
|