tomasz-syn-grzegorza
359afb3a59
Infrastructure configs for GMKtec K11 (Docker, vLLM, LocalAI, ComfyUI, control-plane, gpu-fan agent, Server UI with CLI/file explorer/GPU fan curve). Co-authored-by: Cursor <cursoragent@cursor.com>
115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# 00 — Wymagania i konwencje
|
|
|
|
> Przeczytaj ten rozdział przed rozpoczęciem pracy. Nie wymaga wykonywania komend na serwerze.
|
|
|
|
## Cel
|
|
|
|
Ustalenie wspólnego kontekstu: jaki sprzęt konfigurujemy, jakie są wymagania wstępne i jak czytać kolejne rozdziały tutoriala.
|
|
|
|
## Sprzęt i system
|
|
|
|
| Parametr | Wartość |
|
|
|----------|---------|
|
|
| Hostname | `gmktec-k11` |
|
|
| System | Ubuntu 26.04 LTS (`resolute`) |
|
|
| Kernel | 7.0.x (aktualizowany przez `apt upgrade`) |
|
|
| GPU do AI | NVIDIA GeForce RTX 3090 Ti |
|
|
| Użytkownik | `tomasz-syn-grzegorza` (grupa `sudo`) |
|
|
|
|
## Wymagania wstępne
|
|
|
|
- Dostęp SSH lub fizyczna konsola do serwera
|
|
- Użytkownik z uprawnieniami `sudo`
|
|
- Stabilne połączenie internetowe
|
|
- Czysta instalacja Ubuntu minimized (bez wcześniejszej konfiguracji serwera)
|
|
|
|
**Ubuntu minimized** — nie ma edytorów (`nano`/`vim`), `rsync`, `parted`, `jq`. Doinstalowujemy je w rozdziale [03b — Narzędzia bazowe](03b-system-tools.md) przed konfiguracją dysku i vLLM.
|
|
|
|
## Konwencje w tutorialu
|
|
|
|
### Język
|
|
|
|
- **Opisy i wyjaśnienia** — po polsku
|
|
- **Komendy, nazwy pakietów, ścieżki, zmienne** — po angielsku (jak w systemie Linux)
|
|
|
|
### Format komend
|
|
|
|
```bash
|
|
# komentarz — wyjaśnienie co robi komenda
|
|
sudo apt update
|
|
```
|
|
|
|
- Komendy z prefiksem `sudo` wymagają uprawnień administratora
|
|
- `$USER` oznacza aktualnie zalogowanego użytkownika — nie zamieniaj ręcznie
|
|
- Bloki oznaczone **Opcjonalnie** możesz pominąć przy pierwszym przejściu
|
|
|
|
### Oznaczenia w tekście
|
|
|
|
| Oznaczenie | Znaczenie |
|
|
|------------|-----------|
|
|
| **Weryfikacja** | Sprawdź wynik przed przejściem dalej |
|
|
| **Troubleshooting** | Rozwiązanie typowych problemów |
|
|
| **Uwaga** | Ważna informacja — przeczytaj przed wykonaniem |
|
|
| **Następny krok** | Link do kolejnego rozdziału |
|
|
|
|
### Kolejność rozdziałów
|
|
|
|
Nie pomijaj rozdziałów i nie zmieniaj kolejności. Każdy etap buduje na poprzednim:
|
|
|
|
1. Aktualizacja systemu + Docker CE
|
|
2. Sterowniki NVIDIA
|
|
3. NVIDIA Container Toolkit (GPU w kontenerach)
|
|
4. vLLM
|
|
5. ComfyUI
|
|
6. Firewall i hardening
|
|
|
|
## Czego NIE instalujemy w kroku 01
|
|
|
|
W pierwszym rozdziale **świadomie pomijamy**:
|
|
|
|
- Sterowniki NVIDIA (`nvidia-driver-*`)
|
|
- NVIDIA Container Toolkit (`nvidia-ctk`)
|
|
- vLLM, ComfyUI i jakiekolwiek compose stacki
|
|
- Konfigurację firewalla
|
|
|
|
Te elementy pojawią się w kolejnych rozdziałach we właściwej kolejności.
|
|
|
|
## Przydatne komendy diagnostyczne (bez zmian w systemie)
|
|
|
|
Możesz je uruchomić teraz, żeby potwierdzić punkt startowy:
|
|
|
|
```bash
|
|
# wersja systemu
|
|
lsb_release -a
|
|
|
|
# kernel i architektura
|
|
uname -a
|
|
|
|
# miejsce na dysku
|
|
df -h /
|
|
|
|
# pamięć RAM
|
|
free -h
|
|
|
|
# uprawnienia sudo
|
|
groups
|
|
|
|
# czy Docker jest już zainstalowany (powinno być puste)
|
|
which docker
|
|
docker --version 2>/dev/null || echo "Docker not installed"
|
|
|
|
# GPU wykryte przez PCI (sterownik może jeszcze nie być zainstalowany)
|
|
lspci | grep -i nvidia
|
|
```
|
|
|
|
Oczekiwany stan przed rozdziałem 01:
|
|
|
|
- Ubuntu 26.04 LTS
|
|
- Użytkownik w grupie `sudo`
|
|
- Docker **nie** zainstalowany
|
|
- `nvidia-smi` **niedostępne** (to normalne — sterownik w rozdziale 02)
|
|
|
|
## Następny krok
|
|
|
|
→ [01 — Aktualizacja systemu i instalacja Docker CE](01-system-update-and-docker.md)
|