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 projekteid 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álsz, a dist/ mappát commitold, 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 a repo-d nevében.

Fine-grained PAT (ajánlott):

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

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

2. Connect a PromNET dashboardon

1. /app/cloud/<projekt> oldalra navigálj
2. Görgess le a GitHub auto-deploy szekcióig
3. Töltsd ki:
   • Repo: csiber/portfolio formátumban
   • Branch: main (vagy amilyenre te dolgozol)
   • 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átod — a secret titkosítva tárolódik, később már nem mutatjuk.

1. Másold a Webhook URL-t és a Secret-et
2. Menj 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 akarsz webhookot beállítani (pl. csak alkalmi deploy), a connect után is használhatod a ”🚀 Deploy now” gombot a dashboard-on. Rate-limit: 5 deploy / óra / felhasználó.

Kvóta-limitek

• Cloud Free: 100 MB / projekt, 500 fájl
• Cloud Start / Pro: csomag-szerinti (ld. /csomagok)
• 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 kapsz; használj alkönyvtár-deploy-ot (még nem támogatott — kérj tőlünk)

Hibaelhárítás

“GitHub branch lookup 404”:

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

“GitHub blob fetch 401”:

• A PAT lejárt? Új PAT-ot generálj és cseréld 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ézd 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 adtál meg a GitHub Webhook beállításában. Disconnect a dashboardon és csatlakozz újra — új secret-et kapsz.

Lekötés / törlés

Ha nem akarod 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ád: Settings → Webhooks → töröld a PromNET-webhook-ot

Korlátozások és tervek

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