mates-install-scripts/README.md

mates-install-scripts

Bash skripty pro správu Dockeru na Macu i Linuxu. Jedná se o přesné kopie skriptů z tvého lokálního ~/Skripty/docker-domov/.

Jsi začátečník? Čti od Začínáme - vše je krok za krokem.

---

Co tu je

Skript	Alias	Co dělá
docker-update.sh	dk-update	Aktualizuje Docker Compose projekty (stáhne nové image, restartuje)
docker-backup.sh	dk-backup	Zálohuje Docker projekty a named volumes (na NAS)
docker-cleanup.sh	dk-cleanup	Čistí Docker odpad (dangling images, build cache, orphaned sítě)
docker-restore.sh	dk-restore	Obnovuje Docker projekty ze zálohy
disk-watch.sh	dk-watch	Sleduje volné místo na Docker datech
mount-nas.sh	dk-nas	Připojí/odpojí NAS SMB share do /Volumes/<ssd-data-mount>/multimedia
update-macos.sh	-	Aktualizace macOS přes Software Update

Všechny skripty jsou idempotentní (můžeš spustit víckrát), mají --help, podporují dry-run a bez potvrzení nic destruktivního neprovádějí.

---

Začínáme

Krok 1: Naklonuj repo

git clone http://<server-ip>:3000/mates/mates-install-scripts.git
cd mates-install-scripts

Krok 2: Nastav aliasy

Přidej do ~/.config/fish/config.fish (Fish) nebo ~/.zshrc (Zsh):

Fish:

# Docker skripty (~/Skripty/docker-domov/)
alias dk-update="~/git-repos/mates-install-scripts/docker-update.sh"
alias dk-backup="~/git-repos/mates-install-scripts/docker-backup.sh"
alias dk-cleanup="~/git-repos/mates-install-scripts/docker-cleanup.sh"
alias dk-restore="~/git-repos/mates-install-scripts/docker-restore.sh"
alias dk-watch="~/git-repos/mates-install-scripts/disk-watch.sh"
alias dk-nas="~/git-repos/mates-install-scripts/mount-nas.sh"

# Casto pouzivane zkratky
alias dk-list="~/git-repos/mates-install-scripts/docker-restore.sh --list"
alias dk-cleanup-dry="~/git-repos/mates-install-scripts/docker-cleanup.sh --all --dry-run"
alias dk-watch-alert="~/git-repos/mates-install-scripts/disk-watch.sh --alert"
alias dk-nas-status="~/git-repos/mates-install-scripts/mount-nas.sh --status"
alias dk-nas-mount="~/git-repos/mates-install-scripts/mount-nas.sh --auto"

Zsh:

alias dk-update="~/git-repos/mates-install-scripts/docker-update.sh"
alias dk-backup="~/git-repos/mates-install-scripts/docker-backup.sh"
# ... atd.

Nebo použij configure-fish.sh z mates-macos-setup repo.

Krok 3: Vytvoř složku s projekty

Skripty očekávají Docker projekty v /Volumes/<ssd-data-mount>/Dockery/ (na Macu) nebo /home/deploy/docker/ (na Linuxu). Každý projekt je složka s docker-compose.yml.

Příklad struktury:

~/DockerProjects/
+-- portainer/
| +-- docker-compose.yml
| +-- data/
+-- vaultwarden/
| +-- docker-compose.yml
| +-- data/
+-- nextcloud/
 +-- docker-compose.yml

Konfigurace cesty:

export DOCKERY="/Volumes/<ssd-data-mount>/Dockery" # macOS
# nebo
export DOCKERY="/home/deploy/docker" # Linux

Krok 4: První použití

# Podívej se, co skript dělá (bez provedení)
docker-backup.sh --help
docker-backup.sh --dry-run

# Nebo s aliasem
dk-backup --dry-run

---

Detail ke každému skriptu

docker-update.sh -> dk-update

Bezpečná aktualizace Docker Compose projektů.

dk-update # aktualizuje všechny projekty v DOCKERY
dk-update portainer # aktualizuje jen portainer
dk-update --dry-run # ukáže co by se dělalo, neprovede

Workflow:

1. Zastaví všechny kontejnery
2. Stáhne nové image (docker compose pull)
3. Restartuje s novými image
4. Ověří, že vše běží

docker-backup.sh -> dk-backup

Záloha Docker projektů na NAS.

dk-backup # zalohuj vse
dk-backup --only portainer # jen jeden projekt
dk-backup --dry-run # ukaz co by se delalo
dk-backup --auto # bez dotazovani (cron-friendly)

Výchozí nastavení:

• Zálohy jdou do /Volumes/Backups/Prace/server-backups/<hostname>/
• Používá tar --zstd (moderní komprese)
• Staré zálohy se nemazou (musíš ručně)

docker-cleanup.sh -> dk-cleanup

Bezpečné čištění Docker odpadu.

dk-cleanup # zobrazi plan, zepta se na souhlas
dk-cleanup --dry-run # jen vypise co by smazal
dk-cleanup --auto # bez ptani
dk-cleanup --all # dangling + build cache + sites + tmp

Nikdy nemaže:

• Používané images
• Bind-mount ani named volume data
• Běžící kontejnery

docker-restore.sh -> dk-restore

Obnova ze zálohy.

dk-list # seznam dostupnych zaloh
dk-restore # obnov vse (nejnovejsi)
dk-restore --only portainer # jen jeden projekt
dk-restore --from 20240801-120000 # konkretni zaloha

disk-watch.sh -> dk-watch

Sledování volného místa.

dk-watch # jen info o aktualnim stavu
dk-watch --alert # posli Telegram alert kdyz < 10% volneho

mount-nas.sh -> dk-nas

Připojí NAS SMB share.

dk-nas-status # je pripojeno?
dk-nas-mount # pripoj (auto = chybejici chybu)
dk-nas --umount # odpoj

Konfigurace:

• SMB_SERVER - default <nas-ip>
• SMB_SHARE - default Multimedia
• SMB_USER - default mates
• TARGET - default /Volumes/<ssd-data-mount>/multimedia
• Heslo je v macOS keychainu pod SMB:<server>/<share>

update-macos.sh

Spustí softwareupdate na macOS.

~/Skripty/update-macos.sh

---

Bezpečnost

• Všechny skripty kontrolují $EUID == 0 (musíš být root pro sudo)
• Všechny skripty podporují --dry-run
• Žádné destruktivní akce bez potvrzení
• Hesla v macOS keychainu, ne v skriptech

---

Struktura

mates-install-scripts/
+-- README.md # Tento soubor
+-- LICENSE # MIT
+-- docker-update.sh # Aktualizace Docker
+-- docker-backup.sh # Záloha na NAS
+-- docker-cleanup.sh # Čištění odpadu
+-- docker-restore.sh # Obnova ze zálohy
+-- disk-watch.sh # Sledování místa
+-- mount-nas.sh # Mount NAS
+-- update-macos.sh # Aktualizace macOS

---

Související

• Jotty: knowledge base (detailní postupy, troubleshooting)
• mates-docker-services: Docker Compose šablony pro 14 služeb
• mates-ansible: Ansible playbooky pro nový server

---

Poslední update: 2026-08-01