For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /static/egen-byggpipeline.md.
  • Svenska
  • 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)

    git push  ──▶  GitHub Actions bygger  ──▶  laddar upp till oss  ──▶  publicerad

    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.

    Uppladdningsnyckeln styr vad din sajt visar

    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

    .github/workflows/deploy.yml
    name: Bygg och publicera
    
    on:
      push:
        branches: [main]
    
    permissions:
      contents: read
    
    jobs:
      deploy:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v7
            with:
              submodules: true
    
          - uses: peaceiris/actions-hugo@v3
            with:
              hugo-version: "0.165.0"
              extended: true
    
          - run: hugo --minify
    
          - name: Publicera hos GetGeek Static
            env:
              UPLOAD_URL: https://static.getgeek.se/upload/<sajt>/${{ secrets.GETGEEK_UPLOAD_TOKEN }}
            run: |
              tar -C public -czf site.tar.gz .
              curl --fail-with-body -sS --data-binary @site.tar.gz "$UPLOAD_URL"

    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 ett tar.gz-arkiv.
    • Går publiceringen fel — till exempel om index.html saknas — 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

    git push  ──▶  GitHub Actions bygger  ──▶  grenen gh-pages  ──▶  vi publicerar filerna

    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:

    .github/workflows/deploy.yml
    name: Bygg och publicera
    
    on:
      push:
        branches: [main]
    
    permissions:
      contents: write
    
    jobs:
      deploy:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v7
            with:
              submodules: true
    
          - uses: peaceiris/actions-hugo@v3
            with:
              hugo-version: "0.165.0"
              extended: true
    
          - run: hugo --minify
    
          - uses: peaceiris/actions-gh-pages@v4
            with:
              github_token: ${{ secrets.GITHUB_TOKEN }}
              publish_dir: ./public
              publish_branch: gh-pages

    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.

    Vad används

    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: write i filen — steget som pushar till gh-pages behö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-pages efter 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 main hör vi av oss direkt, men ser att gh-pages inte har ändrats än och gör ingenting. När ditt workflow sedan pushar till gh-pages publicerar 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 cname i actions-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.