Short Run Book

# Runbook: Neues Scoreboard-Paket bauen und ausrollen

Kurzfassung. Ausführliche Erklärungen stehen im
ausführlichen Runbook.

---

Teil 1 – Auf dem Packagebuilder

1. Quellverzeichnis aktualisieren**

Den Stand aus `/opt/scoreboard` nach `source` übernehmen –
so wie bisher, zum Beispiel:

```bash
sudo rsync -a --delete /opt/scoreboard/ \
    /opt/package-build/scoreboard-system/source/
```

2. Versionsnummer hochsetzen**

```bash
sudo nano /opt/package-build/scoreboard-system/build.conf
```

Nur diese eine Zeile ändern:

```bash
PACKAGE_VERSION="3.0.7"
```

Die Nummer muss größer sein als die installierte, sonst
verweigert dpkg das Update.

3. Bauen**

```bash
cd /opt/package-build/scoreboard-system
sudo ./buildpackage.sh
```

Das Skript prüft am Ende selbst, ob im fertigen Paket die
Version aus der `build.conf` steht, und bricht sonst ab.

4. Ergebnis**

```
dist/scoreboard-system_3.0.7_arm64.deb
dist/install-package.sh
```

---

Teil 2 – Auf dem Zielrechner

5. Beide Dateien hinüberkopieren**

```bash
scp dist/scoreboard-system_3.0.7_arm64.deb \
    dist/install-package.sh \
    benutzer@zielrechner:/tmp/
```

6. Installieren**

```bash
cd /tmp
sudo ./install-package.sh scoreboard-system_3.0.7_arm64.deb
```

Nicht `dpkg -i` direkt verwenden.

7. Kontrollieren**

```bash
dpkg -s scoreboard-system | grep ^Version
systemctl status scoreboard
```

---

Wenn etwas schiefgeht

`install-package.sh` legt vor einem riskanten Update eine
Sicherung an:

```bash
ls -lt /var/backups/scoreboard-system-*.tar.gz
```

Zurückspielen:

```bash
sudo systemctl stop scoreboard
sudo tar xzf /var/backups/scoreboard-system-3.0.6-<zeitstempel>.tar.gz -C /opt
sudo systemctl start scoreboard
```

---

Merksätze

- Die Versionsnummer steht **nur** in der `build.conf`.
- Gebaut wird immer aus `source`, nie direkt aus `/opt/scoreboard`.
- Auf dem Zielrechner immer `install-package.sh`, nie `dpkg -i`.
- `/opt/scoreboard` wird beim Bauen nicht angefasst und beim
  Update nicht gelöscht.