Kom igång

Den här guiden tar dig från registrering till en fungerande CI-pipeline. Den förutsätter att du har en terminal öppen med git installerat.

Ska du köpa eller administrera fremforge snarare än koda i det? Din första timme med fremforge går igenom registrering, SSO, betalning och break-glass-förberedelser på ett lättbegripligt sätt med ett flödesdiagram. Läs den först om du är ägare av organisationen, och kom tillbaka hit när du är redo att pusha kod.

Steg 1: Registrera dig

1. Gå till www.frem.sh och klicka på Sign up i toppmenyn (eller gå direkt till frem.sh/_app/signup). Fyll i din jobbmejl, organisationens slug (t.ex. acme, 3–30 tecken) och ett visningsnamn.
2. Leta i inkorgen efter ett verifieringsmejl från noreply@frem.sh. Klicka på länken Verify email. Den gäller i 24 timmar.
3. Välj ditt lösenord på bekräftelsesidan och klicka på Skapa organisation.

Din organisation är direkt tillgänglig på https://frem.sh/<your-org>.

Steg 2: Konfigurera Git Credential Manager (HTTPS + MFA)

fremforge rekommenderar inloggning via HTTPS + Git Credential Manager (GCM): interaktiv inloggning via organisationens IdP, där MFA krävs varje gång token förnyas. Nya organisationer har SSH avstängt som standard; HTTPS+GCM är vägen att gå.

1. Installera GCM:

# macOS
brew install --cask git-credential-manager

# Linux
curl -sL https://aka.ms/gcm/linux-install-source.sh | sh && git-credential-manager configure

# Windows: bundled with Git for Windows 2.28+

2. Konfigurera GCM för fremforge (en gång per arbetsstation):

git config --global credential.https://frem.sh.gitProvider gitea
git config --global credential.https://frem.sh.oauthClientId e90ee53c-94e2-48ac-9358-a874fb9e0662

Klient-id:t tillhör Forgejos inbyggda app git-credential-manager, så ingen konfiguration per organisation behövs.

Den fullständiga konfigurationen, med detaljer om MFA-flödet, alternativa vägar (PAT för CI, SSH för organisationer som har slagit på det igen) och anvisningar per plattform, finns i guiden för säker inloggning.

Steg 3: Skapa ditt första repo

Från webbgränssnittet: gå till frem.sh/<your-org> → + New repo. Fyll i namnet på repot, välj synlighet (offentligt eller privat), initiera det eventuellt med en README och klicka på Create repository.

Pusha ett befintligt lokalt repo (HTTPS, rekommenderas):

git remote add origin https://frem.sh/<your-org>/<your-repo>.git
git push -u origin main
# First push: GCM opens a browser tab → IdP sign-in + MFA → token cached.
# Subsequent pushes within the token's lifetime are silent.

Om organisationens administratör har slagit på SSH igen och du föredrar det, fungerar SSH-varianten också; se Ansluta.

Om repot inte finns ännu skapar fremforge det automatiskt vid första pushen, förutsatt att du har behörigheten Create repositories (som alla ägare av organisationen har som standard).

Steg 4: Bjud in teammedlemmar

Teammedlemskap hanteras i Forgejos eget gränssnitt för organisationsteam. fremforge har ingen egen kopia av rollredigeraren.

1. Gå till https://frem.sh/org/<your-org>/teams och välj det team du vill bjuda in till (eller New team för att skapa ett).
2. Ange mejladressen till den du bjuder in (eller personens fremforge-användarnamn när hen har ett konto).
3. Välj en roll:

Den inbjudna får ett mejl med en länk för att tacka ja. Tills inbjudan har accepterats visas personen som Väntande i medlemslistan och räknas inte som en betald användare.

Steg 5: Ditt första CI-arbetsflöde

Skapa filen .forgejo/workflows/ci.yaml i ditt repo. Forgejo Actions använder samma YAML-schema som GitHub Actions:

on: [push, pull_request]

jobs:
  test:
    runs-on: fremforge
    steps:
      - uses: actions/checkout@v4
      - run: echo "Hello from fremforge CI"

Gör commit och push. Arbetsflödet startar direkt. Följ körningen på:

frem.sh/<your-org>/<your-repo>/actions

Klicka på körningen för att se loggar för varje steg. Den hostade runnern fremforge provisioneras på T Cloud Public ECS (en kortlivad VM per commit) i eu-de. Din kod lämnar inte EU.

Ett verkligt exempel på ett arbetsflöde

Byt ut echo-kommandot mot dina egentliga bygg- och testkommandon:

on: [push, pull_request]

jobs:
  test:
    runs-on: fremforge
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: "20"

      - run: npm ci
      - run: npm test

Se CI-runners för tillgängliga runner-etiketter, medföljande verktyg och gränser för samtidighet.

Steg 6: Lägg till en secret

Secrets krypteras i vila med T Cloud Public DEW KMS och skickas in i arbetsflödets jobb som miljövariabler. Värdena maskeras i jobbens loggar.

Secret på organisationsnivå (tillgänglig för alla repon i organisationen):

1. Gå till Organisationens administration → Secrets → New secret (frem.sh/<your-org>/_admin/secrets).
2. Ange ett namn (endast versaler och understreck, t.ex. DEPLOY_API_KEY) och värdet.
3. Spara.

Secret på repo-nivå (tillgänglig för ett enda repo):

1. Gå till Repot → Inställningar → Hemligheter → Lägg till hemlighet.
2. Ange namn och värde. Spara.

Använd den i ditt arbetsflöde:

steps:
  - name: Deploy
    env:
      API_KEY: ${{ secrets.DEPLOY_API_KEY }}
    run: ./deploy.sh

För inloggningsuppgifter hos molnleverantörer (AWS, T Cloud Public, GCP, Azure) bör du välja OIDC-tokenfederation framför långlivade secrets. Då finns det ingen secret att lagra och ingen secret att rotera.

Se Secrets för den fullständiga referensen, inklusive secrets avgränsade till en miljö och arv av secrets.

Steg 7: Anslut din IdP (valfritt men rekommenderat)

Om ditt team använder Okta, Entra ID, Google Workspace eller Authentik bör du konfigurera SSO så att medlemmarna loggar in med sin företagsidentitet. SSO är valfritt men rekommenderas starkt för team med fler än två personer.

OIDC SSO (rekommenderas):

1. Gå till Organisationens administration → SSO → Autentiseringskällor → New auth source.
2. Välj OIDC.
3. Ange din IdP:s discovery-URL, klient-id och klienthemlighet.
4. Spara och testa.

När SSO är konfigurerat når medlemmarna organisationens egen inloggning på frem.sh/user/login?redirect_to=/<your-org> och autentiseras via din IdP, eller enklare via discovery-inloggningen på frem.sh/_app/login, som skickar dem till din organisation utifrån mejldomänen. Se Så fungerar inloggning för hela modellen.

När SSO fungerar kan du konfigurera SCIM-provisionering för att automatisera användarnas livscykel. Nyanställda får åtkomst automatiskt, och den som slutar förlorar åtkomsten i samma ögonblick som kontot inaktiveras i IdP:n.

Steg 8: Migrera från GitHub, GitLab eller Azure DevOps

Migreringsverktygen finns redan i dag; se Migrering för guiderna för GitHub, GitLab och Azure DevOps, den inbyggda importören och kontrollen före migreringen.

Vägledning om hur du anpassar dina befintliga arbetsflöden och en kompatibilitetsreferens finns i migreringsguiderna.

Vad händer sedan?

När din första pipeline är grön:

• Stärk leveranskedjan: slå på undantag för hemlighetsskanning, SAST, skanning av beroenden och signerade commits. Se Säkerhet och leveranskedja.
• Konfigurera branch-skydd: kräv granskning av pull requests och godkänd CI före merge. Ställs in under Repot → Inställningar → Grenar → <branch>.
• Konfigurera miljöer: använd driftsättningsmiljöer för att hålla tillbaka driftsättningar till produktion tills de har godkänts manuellt. Konfigureras under Organisationens administration → Miljöer (https://frem.sh/<org>/_admin/environments).
• Utforska paketregistret: pusha Docker-images, npm-paket eller Maven-artefakter. Se dokumentationen om paketregistret för push-endpointen och autentisering.

Korsreferenser

• Migreringsguider: steg-för-steg-import från GitHub, GitLab och Azure DevOps
• CI-runners: runner-etiketter, medföljande verktyg, egna runners (BYO)
• OIDC SSO: konfigurera inloggning med Okta, Entra eller Google Workspace
• Secrets: secrets för organisation, repo och miljö
• Administration: den fullständiga referensen till administrationsgränssnittet