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 skapas här: https://github.com/Sundsvallskommun
Kontakta Per Persson för beställning av repo.
Interna repos placeras skapas här: https://gitlab.sundsvall.seKontakta Per Persson för beställning av repo.
2. Skapande av applikation
Surfa in på: https://code.quarkus.io/ och ange följande:
Group - Ange
se.sundsvall. Detta blir grunden i paketstrukturen.Artifact - Ange namnet på din applikation.
Buildtool - Låt vara Maven.
Version - Låt vara “1.0.0-SNAPSHOT”.
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.
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:
Klicka på “Generate your application” och ladda ned som .zip-fil.
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.
Nu är det äntligen dags att koda!
3. Driftsättning
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å.
Det finns två brancher
Sandbox - En branch som helt enkelt fungerar som en sandlåda. Där kan du experimentera lite.
Nås efter installation på: https://microservices.sundsvall.se/sandbox/{namnet på ditt repo}
Master - Produktionsbranchen. Det som pushas hit avses vara produktionskod.
Nås efter installation på: https://microservices.sundsvall.se/{namnet på ditt repo}
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.