Migrering til versjonerte charts

Migrering fra helm template filer til versjonert helm dependency.

For å forenkle oppraderings prosessen av deployment charts har vi flyttet template filene ut et sentralt repository på github. Fra her publiseres helm charts som igjen draes inn i apps repoene som avhengigheter.

Dette gir oss muligheten til å oppdatere standard måte for deploy til altinn3 i et sentralt repository og forenkler jobben for tjenesteiere ved oppgradering.

Hvordan avdekke om din app bruker gammel deployment stretegi

Åpne opp appen din i gitea eller hent siste versjon ned til din datamaskin med git.

Hvis mappen som heter deployment ser ut som nedenfor:

deployment
├── .helmignore
├── Chart.yaml
├── templates
│   ├── NOTES.txt
│   ├── _helpers.tpl
│   ├── deployment.yaml
│   ├── horizontalPodAutoscaler.yaml
│   ├── ingressRoute.yaml
│   ├── middleware.yaml
│   └── service.yaml
└── values.yaml

og innholdet i filen deployment/Chart.yaml er lignende dette:

apiVersion: v1
description: A Helm chart for Kubernetes
# name can only be lowercase. It is used in the templats.
name: deployment
version: 1.1.0

Benytter din applikasjon gammel deployment strategi og du kan følte guiden for hvordan du skal oppgradere til ny her.

Hvis mappen deployment ser sut som nedenfor:

deployment
├── .helmignore
├── Chart.yaml
└── values.yaml

og innholdet i `deployment/Chart.yaml er lignende dette:

apiVersion: v1
description: A Helm chart for Kubernetes
# name can only be lowercase. It is used in the templats.
name: deployment
version: 1.1.0

dependencies:
- name: deployment
  repository: https://charts.altinn.studio/
  version: 2.8.0

Benytter din applikasjon siste deployment strategi.

Hvordan du konfigurerer din deployment er dokumentert her

Migrere til ny deployment strategi

Migreringen er rimelig enkel og involverer bare tre endringer i mappen deployment:

1. Slett mappen templates.
2. Definer avhengigheten til den sentralt vedlikeholde helm-charten i din Chart.yaml.

   dependencies:
   - name: deployment
     repository: https://charts.altinn.studio/
     version: 2.8.0
   

   Your Chart.yaml should now look like this:

   apiVersion: v1
   description: A Helm chart for Kubernetes
   # name can only be lowercase. It is used in the templats.
   name: deployment
   version: 1.1.0
   
   dependencies:
   - name: deployment
     repository: https://charts.altinn.studio/
     version: 2.8.0
   

3. Legg til en ny linje i toppen av values.yaml og skriv inn deployment: på denne linjen. Legg til to space først på hver linje etter dette (yaml behandler tab og mellomrom forskjellig så forsikre deg om at det er mellomrom).
   
   Gitt at din values.yaml ser ut som det her:

   replicaCount: 3
   
   image:
   # Set "repository" name of your image for manual Helm install and upgrade.
     repository:
     tag: latest
     pullPolicy: Always
     pullSecrets:
       # Change this to the name of your pull secret
       - name: acr-secret
   
   service:
   name: deployment
   type: ClusterIP
   externalPort: 80
   # If your application is running on another port, change only the internal port.
   internalPort: 5005
   
   linkerd:
     enabled: true
   
   ingressRoute:
     name: Will be inserted during deploy
     entryPoints:
       - http
       - https
     routes:
       - match: Will be inserted during deploy
         kind: Rule
         services:
           - name: Will be inserted during deploy
             port: 80
         middlewares:
           - name: hsts-header
     tls:
       options:
         name: tls-options
       secretName: ssl-cert
   
   volumeMounts:
     - name: datakeys
       mountPath: /mnt/keys
     - name: accesstoken
       mountPath: "/accesstoken"
   
   volumes:
     - name : datakeys
       persistentVolumeClaim:
         claimName: keys
     - name: accesstoken
       secret:
       secretName: accesstoken
   

   Etter at du har gjort dine migrerings endringer bør denne se ut som følger:

   deployment:
     replicaCount: 3
   
     image:
       # Set "repository" name of your image for manual Helm install and upgrade.
       repository:
       tag: latest
       pullPolicy: Always
       pullSecrets:
       # Change this to the name of your pull secret
         - name: acr-secret
   
     service:
       name: deployment
       type: ClusterIP
       externalPort: 80
       # If your application is running on another port, change only the internal port.
       internalPort: 5005
   
     linkerd:
       enabled: true
   
     ingressRoute:
       name: Will be inserted during deploy
       entryPoints:
         - http
         - https
       routes:
         - match: Will be inserted during deploy
           kind: Rule
           services:
             - name: Will be inserted during deploy
               port: 80
           middlewares:
             - name: hsts-header
       tls:
         options:
           name: tls-options
         secretName: ssl-cert
   
     volumeMounts:
       - name: datakeys
         mountPath: /mnt/keys
       - name: accesstoken
         mountPath: "/accesstoken"
   
     volumes:
       - name : datakeys
         persistentVolumeClaim:
           claimName: keys
       - name: accesstoken
         secret:
           secretName: accesstoken
   

Commit og Push dine endringer til gitea og neste deploy av din applikasjon vil være med ny deployment strategi