Beskrivning för att skapa en ny pipeline för en spring boot mikrotjänst som deployas i openshift, genom att nyttja den gemensama pipeline som finns för utvecklingsfabriken.
Skapa nytt
...
repository
Lägg till en nytt repository för med tjänsten tjänstens namn här https://gitlab.sundsvall.se/argocd/api-services
Lägg till två brancher,
test
(default) ochprod
. Dessa kommer användas för att separera vad som ska deployas i test och vad som ska deployas i produktionLägg till en
.gitignore
:Code Block /charts *.tgz *.lock
Skapa två kataloger i roten,
deployment
ochpipeline
. Katalogenpipeline
kommer innehålla definitionen för mikrotjänstens pipeline. Katalogendeployment
kommer innehålla definitionen för hur mikrotjänsten ska deployas.
...
Code Block |
---|
apiVersion: v2 name: api-<service> description: A Helm chart for simulator service<service> type: application version: 0.1.0 dependencies: - name: spring-boot-chart version: ^0.1.* repository: http://nexus.sundsvall.se/repository/sundsvall-helm/ |
...
Note: appName
bör matcha spring-boot-pipeline.applicationName
som sattes i pipeline charten. Alternativt sätt kan image.nameOverride
sättas till att matcha spring-boot-pipeline.applicationName
.
Verifiering kan göras med hjälp av Helm. Detta kräver Helm CLI och att https://nexus.sundsvall.se/repository/sundsvall-helm/ läggs till som repo (Se Helm Repo Add).
user@computer ~/repos/argocd/api-services/service/deployment $ helm template --dependency-update .
Lägg till bevakning av repo i Argo CD
Logga in i Argo CD på test klustret (länk till sub page för Argo) och gå till Repositories
Klicka på CONNECT REPO USING SSH. Fyll i Name och Repository URL och klicka på CONNECT
Klicka på Create application. (Detta kommer göras två gånger. En för pipeline och en för deployment)
Sätt Application Name (pipeline suffixas med “-pipeline”)
Sätt Project Name (TODO, skapa fler projekt, sätt default tills vidare)
Sätt Revision till
test
(kan sättas till annat, men det är default i spring-boot-pipeline chart)Sätt Path till
pipeline
för pipeline applikationen ellerdeployment
för deployment av mikrotjänstSätt Cluster URL till
https://kubernetes.default.svc
(deployment samma kluster som Argo CD kör i)Kryssa i DIRECTORY RECURSE
Klicka CREATE
När detta är gjort för både pipeline och deployment kan respektive manifest synkas.
Nu bevakar Argo CD två applikationer. En för pipeline och en för deployment. Hamnar något i osynk mellan klustret och gitlab-repot syns detta i Argo CD. Man kan också välja att låta Argo CD synka automatiskt och på så vis slippa synka manuellt.
För produktionsklustret sätts endast en applikation upp i Argo CD. Denna applikation ska peka på deployment med branch prod. Bygge av image sker alltså bara en gång per commit och promotas sedan till varje miljö.
Lägg till webhook i github.com
Gå till tjänsten repository → Settings → Webhooks → Add webhook
TODO: Lägg till info när proxy för webooks är klar.