PromNET

SÚGÓ › Felhő tárhely

GitHub repo bekötése a Cloud projekthez (auto-deploy)

Push-on automatikus deploy: connect-folyamat, webhook beállítása, hibaelhárítás.


A PromNET Cloud projektjei GitHub repo-hoz köthetők — minden push-ra automatikusan deploy-oljuk a tartalmat az <aldomain>.promnet.hu alá. A funkció Sprint 17 óta él (2026-04-30).

Mit deploy-olunk?

V1 (jelenleg):

  • A repo gyökerében (vagy a megadott branch-en) lévő statikus fájlokat
  • HTML / CSS / JS / képek / fontok / PDF — bármi ami böngészőből letölthető
  • Skip-listán: .git/, node_modules/, .env*, dotfiles, build-output könyvtárak (dist/, .next/, .astro/)

V1 megkötés: NINCS build step — a Cloudflare Workers nem futtat npm run build-et. Ha framework-et használ, a dist/ mappát is commitolja, vagy egy CI-step generálja egy külön ágra.

V2 (jövőbeli): runtime build (Astro, Hugo, Next export) — külön builder service, később jön.

Bekötés lépésről lépésre

1. GitHub Personal Access Token (PAT) létrehozása

A PromNET-nek egy token kell ami a GitHub-API-t hívhatja az Ön tárolója nevében.

Fine-grained PAT (ajánlott):

  1. Menjen a github.com/settings/tokens?type=beta-ra
  2. Generate new token (fine-grained)
  3. Nevezze el (pl. “PromNET Cloud — portfolio”)
  4. Repository access: Only select repositories → válassza ki a deploy-olandó repo-t
  5. Permissions:
    • Repository → Contents: Read (szükséges)
    • Repository → Metadata: Read (auto)
  6. Generate token → másolja ki az értéket (ghp_… vagy github_pat_…)

Biztonság: A PAT a fiókja nevében olvas a repo-ból. Csak az egyetlen repo-ra adjon jogosultságot, és csak Contents: Read-et — push-ra nem kell írhatás.

2. Connect a PromNET dashboardon

  1. /app/cloud/<projekt> oldalra navigáljon
  2. Görgessen le a GitHub auto-deploy szekcióig
  3. Töltse ki:
    • Repo: csiber/portfolio formátumban
    • Branch: main (vagy amilyenre te dolgozik)
    • PAT: az előbb generált token
  4. Bekötés gomb

3. Webhook beállítása (push-on auto-deploy)

A connect után megjelenik egy modal a webhook URL + secret-tel. Ezeket csak most látja — a secret titkosítva tárolódik, később már nem mutatjuk.

  1. Másolja a Webhook URL-t és a Secret-et
  2. Menjen a GitHub repo Settings → Webhooks → Add webhook oldalra
  3. Payload URL: beillesztett URL
  4. Content type: application/json
  5. Secret: beillesztett titkos string
  6. Events: “Just the push event” elég
  7. Active: be
  8. Add webhook

A GitHub azonnal egy ping-eseményt küld — ha minden jól van, a webhook “Recent Deliveries” sorában 200 OK látszik a “pong” válasszal.

4. Első push

git commit -m "test deploy"
git push origin main

A dashboardon az Utolsó deploy-ok táblában megjelenik az új deploy 30-60 másodperc múlva (sha + idő + üzenet).

Manual deploy

Ha nem akar webhookot beállítani (pl. csak alkalmi deploy), a connect után is használhatja a ”🚀 Deploy now” gombot a dashboard-on. Rate-limit: 5 deploy / óra / felhasználó.

Kvóta-limitek

  • Ingyenes: 100 MB / projekt, 500 fájl
  • Honlap / Honlap Plusz: csomag szerint (lásd Tárhelycsomagok)
  • A deploy idempotens — minden push előbb törli a régi fájlokat R2-ből, aztán feltölti az újakat
  • Truncated tree: ha a repo > 100 000 fájl, hibát kap; használjon alkönyvtár-deploy-ot (még nem támogatott — kérjen tőlünk)

Hibaelhárítás

“GitHub branch lookup 404”:

  • Rosszul írta a branch-et? GitHub case-sensitive (Main ≠ main)
  • A PAT nem fér hozzá a repo-hoz? Fine-grained tokennél nézze meg a Repository access listáját.

“GitHub blob fetch 401”:

  • A PAT lejárt? Új PAT-ot generáljon és cserélje le a Disconnect → Connect-tel.

“Túl sok fájl” / “Túl nagy”:

  • Free-tier korlátok. Csomag-bővítés vagy fájl-szűrés (node_modules/ automatikusan kiesik).

Webhook “delivery failed” GitHub-on:

  • Több mint 10s-ig tartott a deploy? GitHub timeoutol. A deploy így is befejeződik a háttérben, csak a GH-on hibát jelez. Nézze meg a PromNET dashboard-on az Utolsó deploy-ok-at — ha ott success, kész vagy.

“Érvénytelen aláírás” (401-es webhook):

  • Rossz secret-et adott meg a GitHub Webhook beállításában. Disconnect a dashboardon és csatlakozzon újra — új secret-et kap.

Lekötés / törlés

Ha nem akarja tovább a GitHub-integrációt:

  1. Profil-oldalon a Cloud projekt → “Lekötés” gomb
  2. A token + webhook-secret törlődik a D1-ből
  3. A R2-ben lévő fájlok megmaradnak (a projekt él tovább)
  4. Ha a GitHub repo-t is takarítaná: Settings → Webhooks → törölje a PromNET-webhook-ot

Korlátozások és tervek

FunkcióV1 (most)V2 (jövő)
Statikus deploy✅✅
Push-on auto-deploy✅✅
Manual deploy✅✅
Astro/Hugo/Next runtime build❌🟡 builder service
Branch-onkénti staging (preview-aldomain)❌🟡 tervezett
PR-preview (per-PR aldomain)❌🟡 tervezett
Privát repo private (csak SSH-deploy-key)❌🟢 v2 (PAT helyett)

A v2-vel kapcsolatos tervekről a /blog oldalon írunk be.


← Felhő tárhely Frissítve: 2026. 05. 01.