Files

T

mates 9e078207b2 fix: odstranit emoji ze vsech souboru

Kompletne odstraneno:
- Emoji (smajliky, symboly, boxes, arrows) z README
- Emoji ze skriptu (sipky, symboly)
- Emoji z docker-compose (adresare)

Nahrano za:
- Textove alternativy (sipky -> '->', boxes -> '+', atd.)
- ASCII pouze kde to slo

Ciste vsechny 7 repo (overeno Python skriptem).

2026-08-02 08:50:09 +02:00

3.9 KiB

Raw Blame History

mates-infra

Profil a rozcestník pro home infrastructure as code projekty. Toto je úvodní stránka celého GitHub/Gitea profilu.

Jsi tu nový? Čti od Začínáme - vše krok za krokem.

Co je mates-infra?

Sada 6 repozitářů pro správu domácí infrastruktury:

Docker služby (Portainer, Vaultwarden, Gitea, Nextcloud, ...)
Ansible pro nový server
Bash skripty pro správu Dockeru
macOS workstation setup
Metadata NAS projektů

Vše verzované, replikovatelné a připravené pro obnovu na jiném stroji.

Repozitáře

Repo	Co tu je	Kdy použít
`mates-docker-services`	14× `docker-compose.yml` (portainer, npm, vaultwarden, gitea, jotty, nextcloud, ...)	Když chceš nasadit novou službu
`mates-ansible`	4× Ansible playbook + 5 rolí	Když chceš připravit nový server
`mates-install-scripts`	7× bash skript + aliasy `dk-*`	Když chceš spravovat Docker (update/backup/cleanup)
`mates-macos-setup`	Brewfile + osx-defaults + Fish + Hermes	Když chceš nastavit macOS
`mates-home-nas-tools`	Metadata k NAS projektům (bez binárek)	Když hledáš archiv na NAS

Začínáme

Krok 1: Naklonuj hlavní repo

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

Toto repo slouží jako rozcestník - otevři ho v prohlížeči nebo v editoru a podívej se na ostatní repozitáře.

Krok 2: Najdi co potřebuješ

Chci...	Jdi do...
Připravit nový server	`mates-ansible`
Nasadit Docker službu	`mates-docker-services`
Spravovat Docker (zálohy, update)	`mates-install-scripts`
Nastavit nový Mac	`mates-macos-setup`
Najít archiv na NAS	`mates-home-nas-tools`

Krok 3: Klonuj potřebné repo

git clone http://<server-ip>:3000/mates/mates-<repo>.git
cd mates-<repo>
cat README.md # vse je v README

Jak to celé funguje

+-------------------------------------------------------------+
| mates-infra (toto repo) |
| Hlavni index, rozcestnik, profil |
+-------------------------------------------------------------+
 |
 +-- mates-docker-services # Implementace (Docker)
 +-- mates-ansible # Implementace (Ansible)
 +-- mates-install-scripts # Implementace (bash)
 +-- mates-macos-setup # Implementace (macOS)
 +-- mates-home-nas-tools # Metadata k NAS

Dokumentace (architektura, návody, rozhodnutí) je v Jotty knowledge base - ne v gitu.

Typické scénáře

"Chci připravit nový server od nuly"

Připrav inventory.yml a SSH klíč
Spusť ansible-playbook -i inventory.yml playbooks/priprav-novy-server.yml
Nasaď služby: ansible-playbook -i inventory.yml playbooks/nasad-sluzby.yml

-> Detail v mates-ansible/README.md

"Chci přidat novou Docker službu"

Přidej složku moje-sluzba/ do mates-docker-services/
Vytvoř docker-compose.yml, .env.example, README.md
Commitni a pushni

-> Detail v mates-docker-services/README.md

"Chci zálohovat Docker na NAS"

Nastav DOCKERY env proměnnou
Spusť dk-backup --auto (cron-friendly)
Zálohy jsou v /Volumes/Backups/Prace/server-backups/

-> Detail v mates-install-scripts/README.md

"Chci nastavit nový Mac"

Nainstaluj Homebrew
Spusť brew bundle --file=Brewfile
Spusť osx-defaults.sh, configure-fish.sh, install-hermes.sh

-> Detail v mates-macos-setup/README.md

Bezpečnost

Žádné PII v git - IP adresy, emaily, klíče nahrazeny placeholdery
API tokeny v macOS keychainu, ne v URL ani v env
SSH klíče pro přístup k serverům (hesla zakázána)
Historie git je čistá - bez PII v minulých commitech

Dokumentace

Co hledáš	Kde je
Architektura	Jotty knowledge base
Postupy	`README.md` každého repo
Reference	`.gitignore`, `.env.example`

Poslední update: 2026-08-01

3.9 KiB Raw Blame History Unescape Escape