Bygga själv med GitHub Actions
Vill du bygga sajten själv — med din egen Hugo-version, npm, Tailwind, ett annat verktyg än Hugo eller en egen testsvit — kan du göra det i din CI och skicka det färdiga resultatet till oss. Vi publicerar det precis som det är.
Allt annat fungerar som vanligt: din egen domän, HTTPS, domänverifiering, sparade versioner och mejl om något går fel.
Det finns två sätt. Uppladdning är enklast: ditt workflow skickar den färdiga sajten direkt till oss. Vill du hellre att vi hämtar den från ditt repo går det också, via en egen gren.
Sätt 1: Ladda upp (rekommenderas)
Vi behöver ingen åtkomst till ditt repo alls — ingen deploynyckel och ingen webhook.
1. Lägg uppladdningsadressen som en hemlighet
Uppladdningsadressen finns under din tjänst i portalen
(Tjänster → GetGeek Static → Uppladdningsadress). Lägg in den sista delen av
adressen — nyckeln efter /upload/<sajt>/ — som en hemlighet i ditt repo:
Settings → Secrets and variables → Actions → New repository secret, med
namnet GETGEEK_UPLOAD_TOKEN.
Till skillnad från webhook-adressen kan den här nyckeln ändra innehållet på din sajt. Lägg den bara som en hemlighet i GitHub, aldrig i en fil i repot. Tror du att den läckt, tryck Ny webhook- och uppladdningsnyckel på tjänstesidan. Den gamla nyckeln slutar fungera när bytet är klart, normalt inom 1–2 minuter.
2. Lägg till ett workflow
Byt <sajt> mot ditt sajtnamn (det står i uppladdningsadressen i portalen).
Byggsteget kan du ändra fritt — det enda vi bryr oss om är arkivet: ett tar.gz
med den färdiga sajten och index.html överst.
Workflowet behöver bara läsrätt till repot (contents: read), eftersom inget
pushas tillbaka.
Bra att veta om uppladdning
- Svar
202= mottaget, sajten publiceras inom några sekunder.403= fel nyckel,413= arkivet är större än 1 GB,415= inte etttar.gz-arkiv. - Går publiceringen fel — till exempel om
index.htmlsaknas — får du ett mejl, och din sajt fortsätter visa senaste fungerande version. - Symboliska länkar publiceras aldrig. Ett arkiv som innehåller sådana avvisas.
- Samma arkiv två gånger ger ingen ny version.
- Det fungerar likadant från alla CI-system och från din egen dator — det är ett vanligt HTTP-anrop.
Sätt 2: Via grenen gh-pages
Här pushar ditt workflow resultatet till en gren i ditt repo, och vi hämtar den med deploynyckeln. Det passar om du vill ha den byggda sajten versionerad i git.
1. Lägg till ett workflow (gh-pages)
Skapa filen .github/workflows/deploy.yml i ditt repo:
Workflowet bygger sajten vid varje push till main och lägger det färdiga
resultatet i grenen gh-pages. Byt gärna byggsteget mot vad du vill — det enda
vi bryr oss om är att gh-pages innehåller den färdiga sajten, med index.html
överst.
GITHUB_TOKEN till?
Bara inne i GitHub, för att workflowet ska kunna pusha den byggda sajten till
grenen gh-pages i ditt eget repo.
- Det är ingen hemlighet du skapar själv. GitHub skapar automatiskt en token för varje körning, och den slutar gälla när jobbet är klart.
- Den gäller bara ditt repo, med de rättigheter workflowet ber om. Därför står
permissions: contents: writei filen — steget som pushar tillgh-pagesbehöver skrivrätt. - Den lämnar aldrig GitHub, och GetGeek ser den aldrig. Vår åtkomst till ditt
repo är bara deploynyckeln, som är läsbehörig. Vi hämtar
gh-pagesefter att GitHub har pushat dit.
Vill du inte ge workflowet skrivrätt via GITHUB_TOKEN kan actions-gh-pages
i stället använda en egen deploynyckel med skrivbehörighet (deploy_key: i
stället för github_token:). Resultatet blir detsamma, men det är en nyckel
till att hålla reda på.
2. Välj läget Färdigbyggd gren i repot
Välj Färdigbyggd gren i repot i beställningen, eller byt senare med länken
Uppgradera/nedgradera under Hur publicerar ni sajten? på tjänstesidan (gratis). Lämna Gren tom för gh-pages. Sajten
ställs då in så att vi bara kopierar grenen.
3. Deploynyckel, webhook och DNS
Precis som vanligt — se Koppla GitHub och Kom igång. Webhooken ska skicka vid push.
Bra att veta om gh-pages
- GitHub skickar webhooken för pushar till alla grenar. När du pushar till
mainhör vi av oss direkt, men ser attgh-pagesinte har ändrats än och gör ingenting. När ditt workflow sedan pushar tillgh-pagespublicerar vi. Räkna med en halv minut från push till publicerad sajt. - Publiceringen är en ren kopia. Filen
.nojekyll, som workflowet lägger i grenen, följer med men gör ingen skillnad. - Ställ inte in
cnameiactions-gh-pages— den gäller GitHub Pages, inte oss. - Går ditt bygge fel syns det i GitHub (fliken Actions), inte i ett mejl
från oss: grenen
gh-pagesändras då inte, och din sajt fortsätter visa senaste version. - Andra CI-system fungerar på samma sätt — GitLab CI, Gitea Actions och andra — så länge resultatet pushas till en egen gren i repot.