mates-ansible

Ansible role a playbooky pro přípravu nového serveru a nasazení home infrastruktury.

Playbooky

Playbook	Účel
prepare-new-server.yml	Kompletní příprava nového serveru (od nuly)
deploy-services.yml	Nasaď Docker služby z mates-docker-services/
update-services.yml	Update všech služeb (docker compose pull && up -d)
security-hardening.yml	Sysctl, auditd, auto-updates

Quickstart pro nový server

1. Příprava inventory

cp inventory.example.yml inventory.yml
nano inventory.yml   # nastavit IP a SSH klíč

2. Přidání svého SSH klíče

# Verejny klic z Macu
cat ~/.ssh/id_ed25519.pub

# Pridej do group_vars/all.yml:
deploy_ssh_public_keys:
  - "ssh-ed25519 AAAAC3Nz... hermes@mac"

3. První připojení (s heslem)

# inventory.yml - pro prvni pripojeni (jeste pred SSH klicem)
homeservers:
  hosts:
    novy-server:
      ansible_host: <server-ip>
      ansible_user: ubuntu           # nebo root
      ansible_ssh_pass: heslo        # POZOR: jen docasne
      ansible_become_pass: heslo     # POZOR: jen docasne

4. Spuštění playbooku

ansible-playbook -i inventory.yml playbooks/prepare-new-server.yml

Playbook provede:

• ✅ Update systému (apt)
• ✅ Vytvoří deploy usera (UID 1000) bez hesla
• ✅ Nastaví SSH klíč pro deploy
• ✅ Vytvoří adresářovou strukturu (/home/deploy/docker/<sluzba>/)
• ✅ Nainstaluje Docker Engine + Compose plugin
• ✅ Přidá deploy do docker group (docker bez sudo)
• ✅ Nastaví UFW firewall (povoleno 22, 80, 443)
• ✅ Nainstaluje fail2ban

5. Po dokončení

# Prihlas se jako deploy
ssh deploy@<server-ip>

# Over Docker bez sudo
docker ps

# Nasad sluzby z docker-services
git clone http://<server-ip>:3000/mates/mates-docker-services.git
cd mates-docker-services/portainer
cp .env.example .env
docker compose up -d

Role

Role	Účel
common	Update systému, base packages, timezone
deploy-user	Vytvoření deploy usera (UID 1000)
ssh-keys	Nasazení authorized_keys
firewall	UFW konfigurace
docker	Docker Engine + Compose + user v docker group
directories	/home/deploy/{docker,scripts,backups,logs,...}

Struktura

mates-ansible/
├── README.md
├── ansible.cfg
├── inventory.example.yml
├── group_vars/all.yml.example
├── playbooks/
│   ├── prepare-new-server.yml
│   ├── deploy-services.yml
│   ├── update-services.yml
│   └── security-hardening.yml
├── roles/
│   ├── common/
│   ├── deploy-user/
│   ├── ssh-keys/
│   ├── firewall/
│   ├── docker/
│   └── directories/
└── requirements.yml

Detailní návody

Detailní postupy najdeš v Jotty knowledge base.

Licence

MIT – viz LICENSE