Gå til hovedinnhold

GitLab og import av Maven prosjektet

GitLab​

gitlab.sikt.no

Sikt bruker GitLab som vår kildekoderepositorium og CI/CD plattform for fs-plattform.
Kildekoden ligger her: gitlab.sikt.no/fs/fs-plattform

Logg på GitLab​

Du trenger en bruker i GitLab for å kunne laste ned FS-plattform prosjektet. Som ansatt eller konsulent i Sikt, kan du følge disse stegene:

  1. Logg på gitlab.sikt.no ved å benytte Feide-pålogging slik at brukerkonto opprettes for deg
  2. Be gruppeeier om å legge deg til i de gruppene du mener du tilhører. Spør tech lead om hvem som er gruppeeier.
  3. Gå til din GitLab konto og under Change username bytter du brukernavn til noe som passer.
    Eksempel:
Med følgende epostadresse og Feide-ID
    EPOSTADRESSE: 'espen.askeladd@sikt.no'   
    FEIDE-ID: 'espenas@sikt.no'  
bytter du brukernavn til 'espen.askeladd' eller 'espenas'

Neste gang synkronisering kjøres, vil du komme inn i gruppene du er medlem av. Synkroniseringen kjøres én gang i timen, i tidsrommet 7:00-20:00

Opprett Personal Access Token​

Personal Access Token

Generelt om Personal Access Token på Wikipedia
Personal access tokens på GitLab

gitlab-profile-menu-choice-access-tokens

  1. Klikk på din avatar i GitLab, oppe i høyre hjørne og velge Edit profile
  2. Her finner du User Settings sidebar på venstre side
  3. Klikk sidebar-valget Access Tokens
  4. Skriv inn et navn og utløpsdato for tokenet
  5. Tokenet utløper på denne datoen ved midnatt UTC
  6. Hvis du ikke endrer foreslått utløpsdato, settes utløpsdatoen automatisk til en måned senere enn gjeldende dato
  7. Dersom du oppretter et token med blankt Expiration date felt, vil utløpsdato være Never (inntil du sletter tokenet selv)
  8. Velg ønsket scope, som oftest er det nok med write_repository
  9. Klikk på Create personal access token

Tokenet blir nå opprettet og du finner det øverst på siden under Your new personal access token. Kopier tokenet og lagre det på et sikkert sted - du vil ikke kunne finne det igjen etter at du har lukket websiden.

KeePass

KeePass is a free open source password manager, which helps you to manage your passwords in a secure way
(fra keepass.info)

Du kan installere KeePass via Sikt sin Firmaportal

Laste ned fs-plattform repoet​

gitlab_clone_repo_with_https

Ytelsesproblem grunnet virus/malware-skanning

Sikt PC-ene kommer med Microsoft Defender med sanntidsbeskyttelse aktivert. For å unngå at virus/malware-skanning skal reagere på alle endringene som skjer i ditt kildekoderepo, må du opprette en mappe med navn 'dev' like under din bruker og legge dine lokale repo der. Microsoft Defender vil ikke skanne mappen C:\Users\ditt_brukernavn\dev.

Eksempel for Espen Askeladd som arbeider med FS-plattform: C:\Users\espenas\dev\fs-plattform

  1. Opprett en mappe på din pc like under din bruker: C:\Users\ditt_brukernavn\dev
  2. I denne mappen skal du nå laste ned fs-plattform kildekoden i form av et Maven prosjekt
  3. Åpne Git Bash i mappen C:\Users\ditt_brukernavn\dev
  4. Gå inn i GitLab og finn fs_plattform repoet
  5. Klikk blå knapp Clone på høyre side og velg Clone with HTTPS ved å kopiere URL
  6. I Git Bash skriver du inn git clone og limer inn (shift + insert) https://gitlab.sikt.no/fs/fs-plattform.git
    Hele teksten blir da: git clone https://gitlab.sikt.no/fs/fs-plattform.git
  7. Trykke enter
  8. Du får en dialogboks som ber om Username or email og Personal access token.
  9. Velg Token
  10. Fyll inn Username or email
  11. Lim inn Personal access token (som du nylig har opprettet og oppbevarer på trygt steg)
  12. Klikk Sign in

Git Bash:

SIKT+ditt_brukernavn@SIKT-4793 MINGW64 ~/dev/fs-plattform
$ git clone https://gitlab.sikt.no/fs/fs-plattform.git
Cloning into 'fs-plattform'...
warning: missing OAuth configuration for gitlab.sikt.no - see https://aka.ms/gcm/gitlab for more information
remote: Enumerating objects: 68181, done.
remote: Counting objects: 100% (1392/1392), done.
remote: Compressing objects: 100% (656/656), done.
Receiving objects:  48% (33230/68181), 225.67 MiB | 6.34 MiB/s
Receiving objects: 100% (68181/68181), 295.62 MiB | 6.33 MiB/s, done.
Resolving deltas: 100% (35086/35086), done.
Updating files: 100% (4619/4619), done.

Kildekoden for prosjektet fs-plattform ligger nå lokalt på din pc i denne mappen: c:\Users\ditt_brukernavn\dev\fs-plattform