diff --git a/6-homelab-docs/README.md b/6-homelab-docs/README.md new file mode 100644 index 0000000..8ede051 --- /dev/null +++ b/6-homelab-docs/README.md @@ -0,0 +1,195 @@ +# Homelab Documentation / Homelab Dokumentáció + +## Áttekintés / Overview + +Professzionális dokumentáció a homelab infrastruktúrához, beleértve architektúra diagramokat, leltárt, runbook-okat és sablonokat. + +Professional documentation for homelab infrastructure including architecture diagrams, inventory, runbooks, and templates. + +## Dokumentáció Struktúra / Documentation Structure + +``` +6-homelab-docs/ +├── README.md # Ez a dokumentum / This document +├── architecture/ +│ └── network-architecture.md # Hálózati architektúra / Network architecture +├── inventory/ +│ └── servers.md # Szerver leltár / Server inventory +├── runbooks/ +│ └── incident-response.md # Incidenskezelési runbook / Incident response +└── templates/ + └── change-request.md # Változtatási kérelem sablon / Change request +``` + +## Architektúra / Architecture + +### Hálózati Architektúra / Network Architecture + +A `architecture/network-architecture.md` dokumentum tartalmazza: +- Hálózati topológia diagram (Mermaid) +- VLAN konfiguráció +- IP címtartományok +- Tűzfal szabályok +- DNS konfiguráció +- Port kiosztások + +**Fő komponensek / Key components:** +- 5 VLAN (Servers, Management, Clients, IoT, Quarantine) +- Szegmentált hálózati zónák / Segmented network zones +- Firewall szabályok zónák között / Firewall rules between zones + +## Leltár / Inventory + +### Szerver Leltár / Server Inventory + +A `inventory/servers.md` dokumentum tartalmazza: +- Fizikai szerverek listája / Physical servers list +- Virtuális gépek / Virtual machines +- Docker containerek / Docker containers +- Hálózati eszközök / Network devices +- Szolgáltatások és portok / Services and ports + +**Nyomon követett információk / Tracked information:** +- IP címek / IP addresses +- Hardware specifikációk / Hardware specifications +- Szoftver verziók / Software versions +- Állapot és elérhetőség / Status and availability + +## Runbook-ok / Runbooks + +### Incidenskezelés / Incident Response + +A `runbooks/incident-response.md` runbook tartalmazza: + +**Súlyossági szintek / Severity levels:** +- P0 (Critical) - 15 perc válaszidő / 15 min response +- P1 (High) - 1 óra válaszidő / 1 hour response +- P2 (Medium) - 4 óra válaszidő / 4 hour response +- P3 (Low) - 1 nap válaszidő / 1 day response + +**Minden szinthez / For each level:** +- Jellemző problémák / Typical problems +- Diagnosztikai parancsok / Diagnostic commands +- Helyreállítási lépések / Recovery steps +- Eszkalációs útvonal / Escalation path + +**Kommunikációs sablonok / Communication templates:** +- Incidensnyitás / Incident opening +- Státusz frissítés / Status update +- Incidenzárás / Incident closing +- Post-mortem riport / Post-mortem report + +## Sablonok / Templates + +### Változtatási Kérelem / Change Request + +A `templates/change-request.md` sablon tartalmazza: + +**Szakaszok / Sections:** +1. Változtatás információk / Change information +2. Leírás és indoklás / Description and justification +3. Implementációs terv / Implementation plan +4. Ellenőrzési pontok / Verification points +5. Visszaállítási terv / Rollback plan +6. Kockázat értékelés / Risk assessment +7. Ütemezés / Scheduling +8. Kommunikáció / Communication +9. Jóváhagyás / Approval + +**Használat / Usage:** +1. Másold le a sablont / Copy the template +2. Töltsd ki a mezőket / Fill in the fields +3. Kérj jóváhagyást / Request approval +4. Implementáld / Implement +5. Dokumentáld az eredményt / Document the result + +## Használati Útmutató / Usage Guide + +### Új Szerver Hozzáadása / Adding a New Server + +1. **Dokumentáld a szervert / Document the server** + - Frissítsd a `inventory/servers.md` fájlt + - Add hozzá az IP címet, hardvert, OS-t + +2. **Frissítsd a hálózati diagramot / Update network diagram** + - Módosítsd az `architecture/network-architecture.md` fájlt + - Adj hozzá új node-ot a Mermaid diagramhoz + +3. **Konfiguráld a monitorozást / Configure monitoring** + - Add hozzá a Prometheus target-hez + - Készíts dashboard-ot Grafana-ban + +### Incidens Kezelése / Handling an Incident + +1. **Nyiss incidensriportot / Open incident report** + - Használd a kommunikációs sablont + - Azonosítsd a súlyossági szintet + +2. **Kövesd a runbook-ot / Follow the runbook** + - Nézd meg a `runbooks/incident-response.md` fájlt + - Futtasd a diagnosztikai parancsokat + +3. **Dokumentáld a megoldást / Document the solution** + - Készíts post-mortem riportot + - Frissítsd a runbook-ot ha szükséges + +### Változtatás Kezdeményezése / Initiating a Change + +1. **Töltsd ki a change request-et / Fill out change request** + - Használd a `templates/change-request.md` sablont + - Dokumentáld a változtatást részletesen + +2. **Kérj jóváhagyást / Request approval** + - Küldd el áttekintésre + - Válaszolj a kérdésekre + +3. **Implementáld / Implement** + - Kövesd az implementációs tervet + - Ellenőrizd minden lépésnél + +4. **Zárás / Close** + - Dokumentáld az eredményt + - Frissítsd a leltárat ha szükséges + +## Best Practices + +### Dokumentáció Karbantartás / Documentation Maintenance + +- **Rendszeres frissítés / Regular updates:** Minden változtatás után +- **Verziókezelés / Version control:** Git használata +- **Felülvizsgálat / Review:** Negyedévente +- **Pontosság / Accuracy:** Valós állapot tükrözése + +### Diagram Karbantartás / Diagram Maintenance + +- Használj Mermaid formátumot / Use Mermaid format +- Tartsd egyszerűnek / Keep it simple +- Frissítsd változtatások után / Update after changes +- Színkódolás konzisztens / Consistent color coding + +### Runbook Karbantartás / Runbook Maintenance + +- Teszteld a parancsokat / Test the commands +- Dokumentáld a változásokat / Document changes +- Add hozzá a tanulságokat / Add lessons learned +- Konkrét legyen / Be specific + +## Referenciák / References + +### Külső Dokumentáció / External Documentation + +- [Prometheus Documentation](https://prometheus.io/docs/) +- [Grafana Documentation](https://grafana.com/docs/) +- [Microsoft Graph API](https://docs.microsoft.com/graph/) +- [Docker Documentation](https://docs.docker.com/) + +### Belső Dokumentáció / Internal Documentation + +- [Monitoring Stack README](../2-infra-monitoring/README.md) +- [Network Health Checker](../network_health_checker/README.md) +- [SysAdmin Toolkit](../1-sysadmin-toolkit/README.md) +- [Backup Automation](../5-backup-automation/README.md) + +## Licenc / License + +MIT License diff --git a/6-homelab-docs/architecture/network-architecture.md b/6-homelab-docs/architecture/network-architecture.md new file mode 100644 index 0000000..89b9795 --- /dev/null +++ b/6-homelab-docs/architecture/network-architecture.md @@ -0,0 +1,126 @@ +# Network Architecture / Hálózati Architektúra + +## Áttekintés / Overview + +Ez a dokumentum a homelab hálózati architektúrát írja le. +This document describes the homelab network architecture. + +## Hálózati Topológia / Network Topology + +```mermaid +graph TB + subgraph Internet + ISP[ISP Router] + end + + subgraph Core Network + FW[Firewall/Router
192.168.1.1] + SW1[Core Switch
Layer 3] + end + + subgraph Server VLAN - 10 + SRV1[Monitoring Server
192.168.10.10] + SRV2[Docker Host
192.168.10.20] + SRV3[Backup Server
192.168.10.30] + end + + subgraph Management VLAN - 20 + MGT1[Management Workstation
192.168.20.10] + MGT2[Jump Server
192.168.20.20] + end + + subgraph Client VLAN - 30 + CLI1[Client Devices] + end + + ISP --> FW + FW --> SW1 + SW1 --> SRV1 + SW1 --> SRV2 + SW1 --> SRV3 + SW1 --> MGT1 + SW1 --> MGT2 + SW1 --> CLI1 +``` + +## IP Címtartományok / IP Address Ranges + +| VLAN | Név / Name | Subnet | Gateway | Leírás / Description | +|------|------------|--------|---------|---------------------| +| 1 | Management | 192.168.1.0/24 | 192.168.1.1 | Alapértelmezett / Default | +| 10 | Servers | 192.168.10.0/24 | 192.168.10.1 | Szerverek / Servers | +| 20 | Management | 192.168.20.0/24 | 192.168.20.1 | Kezelési eszközök / Management tools | +| 30 | Clients | 192.168.30.0/24 | 192.168.30.1 | Kliens gépek / Client devices | +| 40 | IoT | 192.168.40.0/24 | 192.168.40.1 | IoT eszközök / IoT devices | +| 99 | Quarantine | 192.168.99.0/24 | 192.168.99.1 | Karantén / Quarantine | + +## Tűzfal Szabályok / Firewall Rules + +### Alapértelmezett Szabályok / Default Rules + +| Forrás / Source | Cél / Destination | Port | Protokoll | Művelet / Action | +|----------------|------------------|------|-----------|-----------------| +| Any | Internet | 80, 443 | TCP | ALLOW | +| Servers | Internet | 80, 443, 53 | TCP/UDP | ALLOW | +| Management | Servers | 22, 3389, 9090, 3000 | TCP | ALLOW | +| Clients | Servers | 80, 443 | TCP | ALLOW | +| Internet | DMZ | 80, 443 | TCP | ALLOW (NAT) | +| IoT | Internet | 443 | TCP | ALLOW | +| IoT | Internal | * | * | DENY | + +### Port Kiosztások / Port Assignments + +| Szolgáltatás / Service | Port | Protokoll | Leírás / Description | +|------------------------|------|-----------|---------------------| +| SSH | 22 | TCP | Secure Shell | +| HTTP | 80 | TCP | Web traffic | +| HTTPS | 443 | TCP | Secure web traffic | +| Grafana | 3000 | TCP | Monitoring dashboard | +| Prometheus | 9090 | TCP | Metrics collection | +| Alertmanager | 9093 | TCP | Alert management | +| Node Exporter | 9100 | TCP | Host metrics | +| Blackbox Exporter | 9115 | TCP | Endpoint probes | + +## DNS Konfiguráció / DNS Configuration + +### DNS Szerverek / DNS Servers + +| Típus / Type | IP Cím | Leírás / Description | +|--------------|--------|---------------------| +| Primary | 192.168.1.1 | Internal DNS | +| Secondary | 8.8.8.8 | Google DNS | +| Tertiary | 1.1.1.1 | Cloudflare DNS | + +### DNS Zónák / DNS Zones + +``` +homelab.local (belső / internal) +├── monitoring.homelab.local → 192.168.10.10 +├── docker.homelab.local → 192.168.10.20 +├── backup.homelab.local → 192.168.10.30 +└── jumpserver.homelab.local → 192.168.20.20 +``` + +## Biztonság / Security + +### Hálózati Szegmentálás / Network Segmentation +- VLAN izoláció különböző hálózati zónákhoz +- Firewall szabályok zónák között +- IoT hálózat izoláció + +### Hozzáférés Szabályozás / Access Control +- Management VLAN csak autorizált eszközökről +- SSH kulcs alapú hitelesítés +- VPN hozzáférés távoli menedzsmenthez + +### Monitorozás / Monitoring +- Prometheus + Grafana +- Blackbox Exporter endpoint ellenőrzéshez +- Alert szabályok kritikus eseményekhez + +## Bővítési Lehetőségek / Expansion Options + +- DMZ VLAN külső szolgáltatásokhoz +- Guest VLAN vendégeknek +- VPN VLAN távoli hozzáféréshez +- Backup VLAN dedikált mentési hálózat diff --git a/6-homelab-docs/inventory/servers.md b/6-homelab-docs/inventory/servers.md new file mode 100644 index 0000000..d0bbf99 --- /dev/null +++ b/6-homelab-docs/inventory/servers.md @@ -0,0 +1,110 @@ +# Server Inventory / Szerver Leltár + +## Áttekintés / Overview + +Homelab szerverek és szolgáltatások leltára. +Inventory of homelab servers and services. + +## Fizikai Szerverek / Physical Servers + +| Név / Name | IP Cím | CPU | RAM | Lemez / Disk | OS | Szerep / Role | +|------------|--------|-----|-----|--------------|----|--------------| +| monitoring-server | 192.168.10.10 | 4 cores | 8 GB | 500 GB SSD | Ubuntu 22.04 LTS | Monitoring Stack | +| docker-host | 192.168.10.20 | 8 cores | 16 GB | 1 TB SSD | Ubuntu 22.04 LTS | Container Host | +| backup-server | 192.168.10.30 | 4 cores | 8 GB | 2 TB HDD | Ubuntu 22.04 LTS | Backup Storage | + +## Virtuális Gépek / Virtual Machines + +| Név / Name | Hoszt / Host | vCPU | vRAM | vDisk | OS | Állapot / Status | +|------------|--------------|------|------|-------|----|-----------------| +| jumpserver | docker-host | 2 | 4 GB | 50 GB | Ubuntu 22.04 | Running | +| dev-workstation | docker-host | 4 | 8 GB | 100 GB | Ubuntu 22.04 | Running | + +## Docker Containerek / Docker Containers + +### Monitoring Stack (monitoring-server) + +| Container | Image | Port | Verzió / Version | Állapot / Status | +|-----------|-------|------|-----------------|-----------------| +| prometheus | prom/prometheus | 9090 | v2.47.0 | Running | +| grafana | grafana/grafana | 3000 | v10.1.0 | Running | +| alertmanager | prom/alertmanager | 9093 | v0.26.0 | Running | +| node-exporter | prom/node-exporter | 9100 | v1.6.1 | Running | +| blackbox-exporter | prom/blackbox-exporter | 9115 | v0.24.0 | Running | +| cadvisor | gcr.io/cadvisor/cadvisor | 8080 | v0.47.2 | Running | + +### Application Stack (docker-host) + +| Container | Image | Port | Leírás / Description | +|-----------|-------|------|---------------------| +| Example | - | - | Placeholder for applications | + +## Hálózati Eszközök / Network Devices + +| Eszköz / Device | IP Cím | Típus / Type | Modell / Model | Szerep / Role | +|----------------|--------|--------------|----------------|---------------| +| fw-01 | 192.168.1.1 | Firewall | Generic | Gateway/Firewall | +| sw-core-01 | 192.168.1.2 | Switch | Managed L3 | Core Switch | +| ap-office-01 | 192.168.1.10 | Access Point | Wireless | WiFi Coverage | + +## Szolgáltatások / Services + +### Kritikus Szolgáltatások / Critical Services + +| Szolgáltatás / Service | Szerver / Server | Port | Monitorozva / Monitored | +|------------------------|------------------|------|------------------------| +| Prometheus | monitoring-server | 9090 | ✅ | +| Grafana | monitoring-server | 3000 | ✅ | +| SSH | All servers | 22 | ✅ | +| Docker | docker-host | 2376 | ✅ | + +### Mentési Ütemezés / Backup Schedule + +| Szerver / Server | Adat / Data | Gyakoriság / Frequency | Megőrzés / Retention | +|------------------|-------------|------------------------|---------------------| +| monitoring-server | /etc, /var/lib/grafana | Napi / Daily | 7 nap | +| docker-host | Docker volumes | Napi / Daily | 14 nap | +| backup-server | Config files | Heti / Weekly | 30 nap | + +## Karbantartási Ablak / Maintenance Windows + +| Nap / Day | Időpont / Time | Típus / Type | Leírás / Description | +|-----------|---------------|--------------|---------------------| +| Szerda / Wednesday | 02:00-04:00 | Tervezett / Scheduled | Rendszer frissítések / System updates | +| Vasárnap / Sunday | 03:00-05:00 | Mentés / Backup | Heti teljes mentés / Weekly full backup | + +## Elérhetőségek / Access Points + +### Web Interfészek / Web Interfaces + +| Szolgáltatás / Service | URL | Hitelesítés / Auth | +|------------------------|-----|-------------------| +| Grafana | http://192.168.10.10:3000 | Username/Password | +| Prometheus | http://192.168.10.10:9090 | None (internal) | +| Alertmanager | http://192.168.10.10:9093 | None (internal) | + +### SSH Hozzáférés / SSH Access + +```bash +# Monitoring szerver / Monitoring server +ssh admin@192.168.10.10 + +# Docker host +ssh admin@192.168.10.20 + +# Jump server-en keresztül / Through jump server +ssh -J admin@192.168.20.20 admin@192.168.10.10 +``` + +## Dokumentáció Frissítés / Documentation Updates + +| Dátum / Date | Szerző / Author | Változás / Change | +|--------------|----------------|-------------------| +| 2025-12-04 | Claude Code | Kezdeti dokumentáció / Initial documentation | + +## Kapcsolattartók / Contacts + +| Szerep / Role | Név / Name | Elérhetőség / Contact | +|---------------|------------|----------------------| +| Rendszergazda / System Administrator | Portfolio Owner | portfolio@example.com | +| Mentés Felelős / Backup Responsible | Portfolio Owner | portfolio@example.com | diff --git a/6-homelab-docs/runbooks/incident-response.md b/6-homelab-docs/runbooks/incident-response.md new file mode 100644 index 0000000..5850dd4 --- /dev/null +++ b/6-homelab-docs/runbooks/incident-response.md @@ -0,0 +1,215 @@ +# Incident Response Runbook / Incidenskezelési Runbook + +## Áttekintés / Overview + +Ez a runbook leírja az incidensek kezelési folyamatát. +This runbook describes the incident handling process. + +## Súlyossági Szintek / Severity Levels + +| Szint / Level | Név / Name | Leírás / Description | Válaszidő / Response Time | +|---------------|------------|---------------------|--------------------------| +| P0 | Critical | Teljes szolgáltatáskiesés / Complete service outage | 15 perc | +| P1 | High | Jelentős funkció nem elérhető / Major function unavailable | 1 óra | +| P2 | Medium | Korlátozott hatás / Limited impact | 4 óra | +| P3 | Low | Minimális hatás / Minimal impact | 1 nap | + +## P0 - Critical Incident / Kritikus Incidens + +### Jellemzők / Characteristics +- Prometheus nem elérhető / Prometheus unreachable +- Grafana teljes kiesés / Grafana complete outage +- Több szerver offline +- Hálózati kapcsolat megszakadás + +### Válaszlépések / Response Steps + +#### 1. Azonnali Értékelés / Immediate Assessment (0-5 perc) +```bash +# Szerverek elérhetőségének ellenőrzése / Check server reachability +ping 192.168.10.10 # Monitoring server +ping 192.168.10.20 # Docker host + +# Szolgáltatások állapota / Service status +systemctl status prometheus +systemctl status grafana-server +docker ps + +# Erőforrások ellenőrzése / Check resources +df -h +free -m +top -b -n 1 | head -20 +``` + +#### 2. Szolgáltatás Újraindítás / Service Restart (5-10 perc) +```bash +# Prometheus újraindítása / Restart Prometheus +docker-compose -f /path/to/docker-compose.yml restart prometheus + +# Grafana újraindítása / Restart Grafana +docker-compose restart grafana + +# Állapot ellenőrzése / Check status +docker-compose ps +curl http://localhost:9090/-/healthy +curl http://localhost:3000/api/health +``` + +#### 3. Naplók Ellenőrzése / Log Review (10-15 perc) +```bash +# Docker container naplók / Docker container logs +docker-compose logs --tail=100 prometheus +docker-compose logs --tail=100 grafana + +# Rendszer naplók / System logs +journalctl -u prometheus -n 100 +tail -100 /var/log/syslog | grep -i error +``` + +#### 4. Eszkaláció / Escalation +Ha a probléma 15 percen belül nem oldódik meg: +- Értesítsd a backup rendszergazdát +- Készíts részletes incident riportot +- Dokumentáld a hibát és a végzett lépéseket + +## P1 - High Severity / Magas Súlyosság + +### Jellemzők / Characteristics +- Egy fő szolgáltatás nem elérhető +- Monitoring gaps (részleges adatvesztés) +- Container újraindulások + +### Válaszlépések / Response Steps + +#### 1. Probléma Azonosítás / Problem Identification +```bash +# Alert ellenőrzés / Check alerts +curl http://localhost:9093/api/v2/alerts + +# Container státusz / Container status +docker ps -a +docker stats --no-stream + +# Resource check +df -h +free -m +``` + +#### 2. Helyreállítás / Recovery +```bash +# Container restart +docker-compose restart + +# Konfiguráció reload / Reload configuration +curl -X POST http://localhost:9090/-/reload + +# Log analízis / Log analysis +python -m toolkit logs /var/log/syslog +``` + +## P2 - Medium Severity / Közepes Súlyosság + +### Jellemzők / Characteristics +- Nem kritikus alert +- Teljesítmény degradáció +- Nem esszenciális szolgáltatás hiba + +### Válaszlépések / Response Steps + +#### 1. Monitorozás / Monitoring +```bash +# Rendszer állapot / System health +python -m toolkit health + +# Top folyamatok / Top processes +python -m toolkit processes --count 20 + +# Disk használat / Disk usage +python -m toolkit disk / +``` + +#### 2. Javítás Ütemezése / Schedule Fix +- Dokumentáld a hibát +- Tervezz javítást következő karbantartási ablakra +- Készíts változtatási tervet + +## Kommunikációs Sablon / Communication Template + +### Incidensnyitás / Incident Opening + +``` +INCIDENT ID: INC-YYYYMMDD-XXX +SEVERITY: [P0/P1/P2/P3] +START TIME: YYYY-MM-DD HH:MM:SS +AFFECTED SERVICE: [Service name] + +DESCRIPTION / LEÍRÁS: +[Brief description in Hungarian and English] + +IMPACT / HATÁS: +[Who/what is affected] + +ACTIONS TAKEN / VÉGZETT LÉPÉSEK: +1. [First action] +2. [Second action] + +STATUS: [INVESTIGATING / IDENTIFIED / RESOLVING / RESOLVED] +``` + +### Incidenzárás / Incident Closing + +``` +INCIDENT ID: INC-YYYYMMDD-XXX +RESOLUTION TIME: YYYY-MM-DD HH:MM:SS +DURATION: XX minutes + +ROOT CAUSE / KIVÁLTÓ OK: +[Detailed root cause analysis] + +RESOLUTION / MEGOLDÁS: +[What was done to fix] + +PREVENTION / MEGELŐZÉS: +[How to prevent in future] + +LESSONS LEARNED / TANULSÁGOK: +[Key takeaways] +``` + +## Eszkalációs Mátrix / Escalation Matrix + +| Szint / Level | Idő / Time | Művelet / Action | +|---------------|-----------|------------------| +| 1 | 0-15 min | Elsődleges rendszergazda / Primary admin | +| 2 | 15-30 min | Backup rendszergazda / Backup admin | +| 3 | 30-60 min | Külső támogatás / External support | + +## Post-Mortem Sablon / Post-Mortem Template + +1. **Incident Összefoglaló / Summary** + - Mi történt? / What happened? + - Mikor? / When? + - Mennyi ideig? / How long? + +2. **Időrend / Timeline** + - HH:MM - Esemény 1 + - HH:MM - Esemény 2 + +3. **Kiváltó Ok / Root Cause** + - Miért történt? / Why did it happen? + +4. **Hatás / Impact** + - Kik érintettek? / Who was affected? + - Milyen következmények? / What consequences? + +5. **Megoldás / Resolution** + - Mit tettünk? / What did we do? + - Működött? / Did it work? + +6. **Megelőzés / Prevention** + - Hogyan előzhető meg? / How to prevent? + - Milyen változtatások? / What changes needed? + +7. **Tanulságok / Lessons Learned** + - Mit tanultunk? / What did we learn? + - Javítási lehetőségek / Improvement opportunities diff --git a/6-homelab-docs/templates/change-request.md b/6-homelab-docs/templates/change-request.md new file mode 100644 index 0000000..a605d9f --- /dev/null +++ b/6-homelab-docs/templates/change-request.md @@ -0,0 +1,190 @@ +# Change Request Template / Változtatási Kérelem Sablon + +## Változtatás Információk / Change Information + +**Változtatás ID / Change ID:** CHG-YYYYMMDD-XXX + +**Beküldő / Submitter:** [Név / Name] + +**Dátum / Date:** YYYY-MM-DD + +**Prioritás / Priority:** [Low / Medium / High / Critical] + +**Kategória / Category:** [Hardware / Software / Configuration / Network] + +## Leírás / Description + +### Változtatás Címe / Change Title +[Rövid, beszédes cím / Short, descriptive title] + +### Változtatás Oka / Reason for Change +[Miért szükséges ez a változtatás? / Why is this change necessary?] + +### Változtatás Hatása / Change Impact +[Milyen rendszerekre/felhasználókra van hatással? / What systems/users are affected?] + +## Részletek / Details + +### Jelenleg Állapot / Current State +[Mi a jelenlegi helyzet? / What is the current situation?] + +### Tervezett Állapot / Desired State +[Mi lesz a változtatás után? / What will it be after the change?] + +### Változtatás Típusa / Change Type +- [ ] Új funkció telepítése / New feature installation +- [ ] Konfiguráció módosítás / Configuration change +- [ ] Frissítés/patch / Update/patch +- [ ] Hardware csere / Hardware replacement +- [ ] Hálózati változtatás / Network change +- [ ] Egyéb / Other: ___________ + +## Implementációs Terv / Implementation Plan + +### Előkészület / Preparation + +1. [Előkészítő lépés 1 / Preparation step 1] +2. [Előkészítő lépés 2 / Preparation step 2] + +### Végrehajtási Lépések / Implementation Steps + +```bash +# 1. lépés / Step 1 +[Command or action] + +# 2. lépés / Step 2 +[Command or action] + +# 3. lépés / Step 3 +[Command or action] +``` + +### Ellenőrzési Pontok / Verification Points + +- [ ] [Ellenőrzési pont 1 / Verification 1] +- [ ] [Ellenőrzési pont 2 / Verification 2] +- [ ] [Ellenőrzési pont 3 / Verification 3] + +### Visszaállítási Terv / Rollback Plan + +Ha a változtatás sikertelen: +If the change fails: + +```bash +# Visszaállítás lépései / Rollback steps +[Rollback commands] +``` + +## Kockázat Értékelés / Risk Assessment + +### Kockázat Szint / Risk Level +- [ ] Alacsony / Low - Minimális hatás, könnyen visszaállítható +- [ ] Közepes / Medium - Korlátozott hatás, visszaállítható +- [ ] Magas / High - Jelentős hatás, komplex visszaállítás +- [ ] Kritikus / Critical - Teljes szolgáltatáskiesés lehetséges + +### Azonosított Kockázatok / Identified Risks + +1. [Kockázat 1 / Risk 1] + - **Valószínűség / Probability:** [Low/Medium/High] + - **Hatás / Impact:** [Low/Medium/High] + - **Enyhítés / Mitigation:** [Mit teszünk ellene / What we do about it] + +2. [Kockázat 2 / Risk 2] + - **Valószínűség / Probability:** [Low/Medium/High] + - **Hatás / Impact:** [Low/Medium/High] + - **Enyhítés / Mitigation:** [Mit teszünk ellene / What we do about it] + +## Ütemezés / Scheduling + +### Javasolt Időpont / Proposed Date/Time +**Dátum / Date:** YYYY-MM-DD +**Időpont / Time:** HH:MM - HH:MM (időzóna / timezone) +**Időtartam / Duration:** X óra / hours + +### Karbantartási Ablak / Maintenance Window +- [ ] Szabványos ablak / Standard window (Wednesday 02:00-04:00) +- [ ] Sürgősségi ablak / Emergency window (azonnal / immediate) +- [ ] Egyedi ablak / Custom window: ___________ + +### Értesítések / Notifications +- [ ] Felhasználók értesítése 24 órával előtte / Notify users 24h before +- [ ] Email értesítés / Email notification +- [ ] Dashboard banner + +## Kommunikáció / Communication + +### Érintett Felek / Stakeholders +| Szerep / Role | Név / Name | Értesítve / Notified | +|---------------|------------|---------------------| +| Rendszergazda / Admin | [Name] | [ ] Igen / Yes | +| Felhasználók / Users | All | [ ] Igen / Yes | + +### Üzenet Sablon / Message Template + +**Tárgy / Subject:** Tervezett karbantartás - [Változtatás címe] + +**Üzenet / Message:** +``` +Tisztelt Felhasználók / Dear Users, + +Tervezett rendszerkarbantartást végzünk: +Scheduled system maintenance: + +Időpont / Date: YYYY-MM-DD HH:MM +Időtartam / Duration: X óra / hours +Érintett szolgáltatások / Affected services: [List] + +A karbantartás során az alábbi szolgáltatások nem lesznek elérhetők: +During maintenance, the following services will be unavailable: +- [Service 1] +- [Service 2] + +Köszönjük a megértést! +Thank you for your understanding! +``` + +## Végrehajtás / Execution + +### Pre-Change Checklist / Változtatás Előtti Ellenőrzés + +- [ ] Változtatási terv áttekintve / Change plan reviewed +- [ ] Mentés elkészítve / Backup completed +- [ ] Tesztkörnyezetben validálva / Validated in test environment +- [ ] Rollback terv dokumentálva / Rollback plan documented +- [ ] Érintettek értesítve / Stakeholders notified +- [ ] Szükséges eszközök elérhetők / Required tools available + +### Végrehajtás Napló / Execution Log + +| Idő / Time | Művelet / Action | Eredmény / Result | Jegyzetek / Notes | +|------------|------------------|-------------------|-------------------| +| HH:MM | [Action] | [OK/FAIL] | [Notes] | + +### Post-Change Checklist / Változtatás Utáni Ellenőrzés + +- [ ] Változtatás sikeresen telepítve / Change successfully deployed +- [ ] Ellenőrzési pontok teljesítve / Verification points completed +- [ ] Szolgáltatások működnek / Services operational +- [ ] Monitoring adatok normálisak / Monitoring data normal +- [ ] Felhasználók értesítve befejezésről / Users notified of completion +- [ ] Dokumentáció frissítve / Documentation updated +- [ ] Change lezárva / Change closed + +## Jóváhagyás / Approval + +| Szerep / Role | Név / Name | Dátum / Date | Aláírás / Signature | +|---------------|------------|--------------|---------------------| +| Kérelmező / Requester | | | | +| Jóváhagyó / Approver | | | | +| Implementáló / Implementer | | | | + +## Jegyzetek / Notes + +[További megjegyzések / Additional notes] + +--- + +**Létrehozva / Created:** YYYY-MM-DD +**Frissítve / Updated:** YYYY-MM-DD +**Állapot / Status:** [DRAFT / PENDING / APPROVED / IMPLEMENTED / CLOSED]