Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Innan du sätter igång med detta, läs igenom: Utveckling
Där har vi författat viktiga saker att känna till som systemutvecklare på Sundsvalls Kommun.

1. Repository (repo)

Open-source repos placeras här: https://github.com/Sundsvallskommun
Kontakta Per Persson för beställning av repo.

Interna repos placeras här: https://gitlab.sundsvall.se
Kontakta Per Persson för beställning av repo.

Guide SSH GitLab

Denna instruktion gäller för de som inte har en kommundator. Om du har en kommundator och är uppkopplad via VPN så kan du nå GitLab som vanligt via denna länk: https://gitlab.sundsvall.se/ .

För att kunna ansluta mot GitLab, som ligger på Sundsvalls kommuns interna nät så krävs det lite konfigurering.

  1. Logga in i mobilityguard på login.sundsvall.se med sms-kod.

  2. Klicka på ”Gitlab SSH”.

  3. Följ instruktionerna på skärmen med att installera en klient på datorn och sedan ladda in config-filen in i klienten. Man kan behöva klicka på Gitlab SSH en gång till efter man har laddat in configen.

    1. MG kommer nu skapa en tunnel till dig som gör att localhost:1494 pekar mot GitLab servern.

  4. Skapa upp SSH nyckelpar och lägg in det i din profil i GitLab. För att komma åt GitLab krävs det att du har en dator som kommer åt det interna nätet. Om du inte har det, ta hjälp från någon som har det.

    1. Guide för skapande av SSH-nyckel: https://dev.to/sndrx/how-to-set-up-an-ssh-key-and-use-it-in-gitlab--42p1

    2. Namnsätt din privata nyckel till: id_gitlab och placera den under ~/.ssh/

  5. Ladda ned Git Bash: https://git-scm.com/downloads . Från Git Bash kan du utföra alla kommande kommandon.

  6. Verifiera att din SSH-nyckel fungerar med följande kommando: ssh git@localhost –p 1494

    1. Du ska nu se en välkomstfras med ditt användarnamn.

  7. Nu krävs det att du skapar upp/ändrar din ”config” fil i ssh. Den är placerad i ~/.ssh/config

    1. Lägg till följande:
      Host localhost
      HostName localhost
      User git
      Port 1494
      IdentityFile ~/.ssh/id_gitlab

  8. Nu ska du kunna klona ned ett repo. Testa med följande kommando: git clone git@localhost:{sökväg till ditt repo}.git

2. Skapande av applikation

  1. Surfa in på: https://code.quarkus.io/ och ange följande:

    1. Group - Ange se.sundsvall . Detta blir grunden i paketstrukturen.

    2. Artifact - Ange namnet på din applikation.

    3. Buildtool - Låt vara Maven.

    4. Version - Låt vara “1.0.0-SNAPSHOT”.

    5. Example code - Välj om du vill ha några exempelklasser. Om du väljer detta kommer paketstrukturen genereras, vilket kan vara skönt. Kom dock ihåg att ersätta exempelklasserna.

  2. Under “Pick your extensions” kan du lägga till Maven-dependencies. Följande kan vara bra att ha, men det är självklart beroende på vad du ska bygga:

  3. Klicka på “Generate your application” och ladda ned som .zip-fil.

  4. Packa upp innehållet till ditt repo. Döp om mappen från ditt applikationsnamn till “kod” och ersätt den befintliga “kod”-mappen i repot.

  5. Nu är det äntligen dags att koda!

3. Driftsättning

  1. När du har kodat klart och känner att det är dags att installera din applikation så är det några saker du behöver ha koll på.

  2. Det finns två brancher

    1. Sandbox - En branch som helt enkelt fungerar som en sandlåda. Där kan du experimentera lite.

      1. Nås efter installation på: https://microservices.sundsvall.se/sandbox/{namnet på ditt repo}

    2. Master - Produktionsbranchen. Det som pushas hit avses vara produktionskod.

      1. Nås efter installation på: https://microservices.sundsvall.se/{namnet på ditt repo}

  3. Så hur gör du för att installera? Det är ganska enkelt. Gör en push till ditt repo på branchen du avser bygga på och installationen startar automatiskt.
    Former user (Deleted) har varit snäll och satt upp en Dockerfile + en .gitlab-ci.yml som sköter bygget.

  • No labels