websitedev/docs/helyi-staging-deploy.md

Helyi staging kiadás

A staging kiadás szándékosan nem használ Gitea Actions runnert. A kiadásért felelős fejlesztő saját gépén vezérli a folyamatot; nincs állandó CI-host, runner-regisztráció vagy extra szerveroldali jogosultság.

Egy parancsos folyamat

./scripts/deploy_to_stage_on_local.sh

A script rögzített sorrendben fut:

1. Ellenőrzi, hogy a helyi main ág és a Git munkakönyvtár tiszta-e.
2. A proto könyvtárban futtatja a determinisztikus npm ci telepítést és az unit teszteket.
3. Feltolja a main commitot a Gitea-ra.
4. SSH-n belép a staging hostra (sadmin@llmdev.mozdit.hu), a /home/sadmin/websitedev könyvtárban fast-forward Git frissítést végez, majd futtatja a ./deploy.sh staging parancsot.
5. A helyi gépről a https://stage.mozdit.hu ellen lefuttatja az öt Playwright smoke tesztet.

Hiba esetén a script azonnal leáll. Ez különösen fontos: sikertelen unit teszt esetén nincs push vagy deploy; sikertelen szerveroldali healthcheck esetén nincs sikeres kiadás jelzés; sikertelen smoke teszt esetén a staging kiadás további ellenőrzést igényel.

Előfeltételek a helyi gépen

• Git-hozzáférés a origin Gitea remote-hoz
• SSH-hozzáférés sadmin@llmdev.mozdit.hu célhoz
• Node.js és npm
• a Playwright Chromium böngészője. Új gépen egyszer:

cd proto
npx playwright install chromium

Egyedi célok

A paraméterek szükség esetén környezeti változóval felülírhatók:

STAGE_HOST=felhasznalo@masik-stage-host \
STAGE_PATH=/srv/websitedev \
STAGE_URL=https://stage.mozdit.hu \
./scripts/deploy_to_stage_on_local.sh

Gitea Actions

A .gitea/workflows/ci.yml workflow jelenleg szünetel, mert nincs dedikált, biztonságosan elkülönített runner. A régi Gitea Actions futásokat a Gitea felületén a Cancel gombbal meg kell szakítani. Ha később dedikált CI-host készül, a workflow visszaállítható és a telepítési modell újraértékelhető.