Live zetten vanuit git
Een website vanuit broncode zet je live vanuit je pipeline: elke push naar je branch bouwt de site en publiceert een nieuwe versie. In Hub valt dan niets te bewerken; de code in de repository is leidend.
1. Website en API-sleutel
- Maak de website aan met de + in Websites en kies Vanuit broncode. Vul de repository, de map van de site in de repository en de branch in.
- Laat Hub in dezelfde stap een API-sleutel maken met het doel Website publiceren. Die sleutel mag alleen versies publiceren. Je kunt hem ook later maken via Instellingen → API-sleutels.
- Hub geeft je meteen het CI-bestand met de juiste waarden.
2. De pipeline
Gebruik een van de templates van files.giantpanda.site (opens in a new tab):
- GitLab:
ci/v1/gitlab-ci.yml(opens in a new tab) - GitHub:
ci/v1/github-actions.yml(opens in a new tab)
Ze bouwen de site (npm ci && npm run build) en draaien daarna het deploy-script
deploy-gianthost.mjs (opens in a new tab) op de build-map.
| Variabele | Waar | Inhoud |
|---|---|---|
GIANTHOST_API_KEY | Geheim in je CI (masked + protected) | De API-sleutel "Website publiceren" |
GIANTHOST_PROFILE_ID | In het CI-bestand | Het id van je bedrijfsprofiel |
GIANTHOST_SITE_ID | In het CI-bestand | De site-id, bijvoorbeeld bakker-jansen-actie |
GIANTHOST_SOURCE_PATH | In het CI-bestand | Map van de site in de repository; leeg is de root |
GIANTHOST_BUILD_DIR | In het CI-bestand | De build-map, bijvoorbeeld dist |
Het script uploadt alle bestanden, controleert dat alles is aangekomen, zet de versie live en noteert de commit bij de versie. In Hub zie je per versie van welke commit hij komt.
Het script wordt bij elke run opnieuw opgehaald (altijd de nieuwste v1). Wil je een vaste versie, vergelijk het dan
met de checksum (opens in a new tab). Een wijziging die bestaande
pipelines zou breken, komt in een nieuwe v2.
Terugdraaien
Een versie terugzetten doe je in Hub, via de knop naast Bekijk site. De volgende push maakt weer een nieuwe versie.