Files

T

tomasz-syn-grzegorza 359afb3a59 Initial import: bare-metal stacks, Server UI, GPU fan, tutorials.

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>

2026-07-05 12:02:04 +00:00

3.9 KiB

Raw Blame History

Przygotowanie repozytorium pod Gitea

Raport z sesji przygotowującej pierwszy commit ubuntu-bare-metal.

Analiza stanu wyjściowego

Aspekt	Wynik
Git	Katalog nie był repozytorium — wykonano `git init`
Gitea remote	Nie skonfigurowany — URL do podania przez użytkownika
Pliki `.env`	7 na dysku (sekrety) — wykluczone przez root `.gitignore`
`.venv`	`stacks/server-ui/.venv`, `stacks/gpu-fan/.venv` (~54 MB każdy) — wykluczone
Bloker bezpieczeństwa	Prawdziwy `API_KEY` w `manual-tutorial/04a-api-key.md` — zredagowany na placeholder

Zmiany przygotowawcze (ta sesja)

Root .gitignore — .env, .venv, __pycache__, upstream/, .cursor/
Redakcja manual-tutorial/04a-api-key.md — przykład API_KEY to placeholder xxxxxxxx…, nie produkcyjny klucz
git init + branch main
Pierwszy commit — pełny import repo (bez push)

Zakres pierwszego commita

ubuntu-bare-metal/
├── README.md
├── .gitignore
├── scripts/
├── manual-tutorial/          # 13 rozdziałów (00–10, 04a)
├── coding-agent/             # handoff, ADR, deployment notes
└── stacks/
    ├── vllm/
    ├── localai/
    ├── comfyui/
    ├── gpu-fan/
    ├── server-ui/            # panel :8091, CLI PTY, Pliki, GPU Fan
    ├── control-plane/        # env_loader, wspólny API_KEY
    ├── npmplus/
    └── llamacpp/

Nie trafia do gita

**/.env (produkcja: /opt/control-plane/.env poza repo)
**/.venv/, **/__pycache__/
stacks/localai/upstream/ (jeśli sklonowany lokalnie)

Ostatnie zmiany Server UI (GPU Fan chart)

W stacks/server-ui/static/index.html:

Siatka i podziałka temperatury (°C) / prędkości (%)
Linijki kreskowe (zamiast kolorowych pasków gradientowych)
Odstęp etykiet Y od lewej linijki (yLabelX)
Odstęp etykiet X od dolnej linijki (xLabelY)
Responsywne SVG: aspect-ratio: 600/360, height: auto (bez rozciągania na mobile)
Wyśrodkowanie wykresu w karcie: margin: 0 auto

Powiązane docs: manual-tutorial/06-gpu-fan-control.md, SERVER-UI-CLI.md, SERVER-UI-CLI-BUGFIX.md.

Push na Gitea (gdy masz URL)

cd ~/cursor/ubuntu-bare-metal

# jednorazowo — podstaw URL z Gitea (SSH lub HTTPS)
git remote add origin <URL_GITEA>

# jeśli repo na Gitea ma już README / initial commit:
# git pull origin main --allow-unrelated-histories
# (rozwiąż ewentualne konflikty, potem push)

git push -u origin main

Przykładowe URL:

HTTPS: https://gitea.example.com/user/ubuntu-bare-metal.git
SSH: git@gitea.example.com:user/ubuntu-bare-metal.git

Checklist bezpieczeństwa przed każdym commitem

cd ~/cursor/ubuntu-bare-metal

# 1. Brak sekretów w staged plikach
git diff --cached | grep -iE 'API_KEY=|HF_TOKEN=|password=|secret=' && echo 'STOP: sekret w diff!' || echo 'OK'

# 2. .env nie jest śledzony
git status --short | grep '\.env' && echo 'STOP: .env w staging!' || echo 'OK'

# 3. Dry-run — co trafi do commita
git add -n .

# 4. Szukaj przypadkowych kluczy w docs
grep -rE '[a-f0-9]{32}' manual-tutorial/ coding-agent/ --include='*.md' | grep -v xxxxxxxx

Zalecenia po redakcji klucza w tutorialu

Klucz produkcyjny był kiedyś w 04a-api-key.md. Rozważ rotację API_KEY w /opt/control-plane/.env i restart server-ui / gpu-fan, jeśli repo będzie publiczne lub współdzielone.

Weryfikacja po clone na innym hoście

git clone <URL_GITEA> ubuntu-bare-metal
cd ubuntu-bare-metal/stacks/control-plane
cp .env.example .env   # uzupełnij API_KEY lokalnie

Wygenerowano przy pierwszym imporcie git — lipiec 2026.

3.9 KiB Raw Blame History Unescape Escape