Gå til hovedinnhold

Kom i gang

Denne veiledningen tar deg fra registrering til en fungerende CI-pipeline. Den forutsetter at du har en terminal åpen med git installert.

Skal du kjøpe eller administrere fremforge i stedet for å kode på det? Din første time med fremforge går gjennom registrering, SSO, betaling og oppsett av break-glass-tilgang i et enkelt språk med et flytdiagram. Les den først hvis du er eier av organisasjonen, og kom tilbake hit når du er klar til å pushe kode.

Trinn 1: Registrer deg

  1. Gå til www.frem.sh og klikk på Sign up i toppmenyen (eller gå rett til frem.sh/_app/signup). Fyll inn jobb-e-posten din, organisasjonens slug (for eksempel acme, 3–30 tegn) og et visningsnavn.
  2. Se etter en bekreftelses-e-post fra noreply@frem.sh i innboksen din. Klikk på lenken Verify email. Den er gyldig i 24 timer.
  3. Velg passord på bekreftelsessiden, og klikk på Opprett organisasjon.

Organisasjonen din er tilgjengelig med en gang på https://frem.sh/<your-org>.

Trinn 2: Sett opp Git Credential Manager (HTTPS + MFA)

fremforge anbefaler innlogging via HTTPS + Git Credential Manager (GCM): interaktiv innlogging gjennom organisasjonens IdP, der MFA kreves hver gang tokenet fornyes. Nye organisasjoner har SSH slått av som standard; HTTPS+GCM er veien å gå.

  1. Installer 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+
  1. Konfigurer GCM for fremforge (én gang per arbeidsstasjon):
git config --global credential.https://frem.sh.gitProvider gitea
git config --global credential.https://frem.sh.oauthClientId e90ee53c-94e2-48ac-9358-a874fb9e0662

Klient-ID-en er Forgejos innebygde git-credential-manager-app, så det trengs ikke noe oppsett per organisasjon.

Hele oppsettet, med detaljer om MFA-flyten, alternative veier (PAT for CI, SSH for organisasjoner som har slått det på igjen) og merknader per plattform, finner du i veiledningen for sikker innlogging.

Trinn 3: Opprett ditt første repository

Fra brukergrensesnittet: gå til frem.sh/<your-org> → + Nytt repository. Fyll inn navnet på repositoryet, velg synlighet (offentlig eller privat), initialiser eventuelt med en README, og klikk på Opprett repository.

Push et eksisterende lokalt repo (HTTPS, anbefalt):

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.

Hvis administratoren i organisasjonen din har slått på SSH igjen og du foretrekker det, fungerer SSH-varianten også. Se Koble til.

Finnes ikke repositoryet ennå, oppretter fremforge det automatisk ved første push, forutsatt at du har rettigheten Opprette repositoryer (som alle eiere av organisasjonen har som standard).

Trinn 4: Inviter teammedlemmer

Teammedlemskap håndteres i Forgejos eget grensesnitt for organisasjonsteam. fremforge har ingen egen kopi av rolleredigeringen.

  1. Gå til https://frem.sh/org/<your-org>/teams og velg teamet du vil invitere til (eller Nytt team for å opprette et).
  2. Skriv inn e-postadressen til personen du inviterer (eller fremforge-brukernavnet deres, hvis de allerede har en konto).
  3. Velg en rolle:
RolleTilgang
Eier (eier)Full administrasjon av organisasjonen: fakturering, SSO, sikkerhetspolicy, administrasjon av medlemmer, alle repositoryer
Medlem (medlem)Bare tilgang til repositoryer, ytterligere avgrenset av rettigheter per repo

Den inviterte får en e-post med en lenke for å godta invitasjonen. Inntil invitasjonen er godtatt, står personen som Venter i medlemslisten og teller ikke som en betalt bruker.

Trinn 5: Din første CI-workflow

Opprett filen .forgejo/workflows/ci.yaml i repositoryet ditt. Forgejo Actions bruker det samme YAML-skjemaet som GitHub Actions:

on: [push, pull_request]

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

Commit og push. Workflowen starter med en gang. Følg kjøringen her:

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

Klikk på kjøringen for å se loggene for hvert steg. Den hostede fremforge-runneren kjører på T Cloud Public ECS (en kortlevd VM per commit) i eu-de. Koden din forlater ikke EU.

Et realistisk workflow-eksempel

Bytt ut echo-kommandoen med de faktiske bygge- og testkommandoene dine:

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-runnere for tilgjengelige runner-etiketter, inkluderte verktøy og grenser for samtidighet.

Trinn 6: Legg til en secret

Secrets krypteres ved lagring med T Cloud Public DEW KMS og gis til workflow-jobber som miljøvariabler. Verdiene maskeres i jobbloggene.

Secret for organisasjonen (tilgjengelig for alle repositoryer i organisasjonen):

  1. Gå til Organisasjonsadministrasjon → Secrets → New secret (frem.sh/<your-org>/_admin/secrets).
  2. Skriv inn et navn (store bokstaver og understrek, for eksempel DEPLOY_API_KEY) og verdien.
  3. Lagre.

Secret for ett repository (bare tilgjengelig for det ene repositoryet):

  1. Gå til Repository → Innstillinger → Secrets → Legg til secret.
  2. Skriv inn navn og verdi. Lagre.

Bruk den i workflowen din:

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

For legitimasjon til skyleverandører (AWS, T Cloud Public, GCP, Azure) bør du bruke OIDC-tokenføderasjon i stedet for langlivede secrets. Da finnes det ingen secret å lagre og ingen secret å rotere.

Se Secrets for den fullstendige referansen, inkludert secrets per miljø og arv av secrets.

Trinn 7: Koble til IdP-en din (valgfritt, men anbefalt)

Hvis teamet ditt bruker Okta, Entra ID, Google Workspace eller Authentik, bør du sette opp SSO slik at medlemmene logger inn med bedriftsidentiteten sin. SSO er valgfritt, men sterkt anbefalt for team med flere enn to personer.

OIDC SSO (anbefalt):

  1. Gå til Organisasjonsadministrasjon → SSO → Autentiseringskilder → New auth source.
  2. Velg OIDC.
  3. Skriv inn discovery-URL-en, klient-ID-en og klienthemmeligheten fra IdP-en din.
  4. Lagre og test.

Når SSO er konfigurert, kommer medlemmene til organisasjonens egen innlogging på frem.sh/user/login?redirect_to=/<your-org> og autentiserer seg via IdP-en din. Enda enklere er discovery-innloggingen på frem.sh/_app/login, som sender dem til riktig organisasjon ut fra e-postdomenet. Se Slik fungerer innlogging for hele modellen.

IdPVeiledning
OktaOIDC SSO
Microsoft Entra IDOIDC SSO
Google WorkspaceOIDC SSO
ADFSOIDC SSO

Når SSO fungerer, bør du sette opp SCIM-provisjonering for å automatisere brukernes livssyklus. Nyansatte får tilgang automatisk, og ansatte som slutter, mister tilgangen i det øyeblikket kontoen deres i IdP-en deaktiveres.

Trinn 8: Migrer fra GitHub, GitLab eller Azure DevOps

Migreringsverktøyene er klare allerede. Se Migrering for veiledningene for GitHub, GitLab og Azure DevOps, den innebygde importøren og sjekken før migrering.

Råd om hvordan du tilpasser eksisterende workflower, og en kompatibilitetsreferanse, finner du i migreringsveiledningene.

Neste steg

Når den første pipelinen din er grønn:

  • Styrk forsyningskjeden: slå på overstyringer for secret-skanning, SAST, skanning av avhengigheter og signerte commits. Se Sikkerhet og forsyningskjede.
  • Konfigurer branch-beskyttelse: krev gjennomgang av pull requests og grønn CI før merge. Stilles inn under Repository → Innstillinger → Brancher → <branch>.
  • Sett opp miljøer: bruk utrullingsmiljøer for å kreve manuell godkjenning før utrulling til produksjon. Konfigureres under Organisasjonsadministrasjon → Miljøer (https://frem.sh/<org>/_admin/environments).
  • Utforsk pakkeregisteret: push Docker-images, npm-pakker eller Maven-artefakter. Se dokumentasjonen for pakkeregisteret for push-endepunkt og autentisering.

Se også