Sist endret: 2. okt. 2024

Modul 3

Bygg og publiser applikasjon til testmiljø

Denne modulen krever at du er medlem av en organisasjon som har et etablert testmiljø for Altinn Apps. Dersom dette ikke er tilfellet kan du gå videre til neste modul.

Hvis du har en personlig applikasjon som du vil flytte til en organisasjon, så kan du spørre en administrator eller service desk.

Når du har tilgang til en organisasjon som har etablert testmiljø så kan du flytte applikasjonen til organisasjonen slik:

  1. Flytt repository for applikasjonen i Gitea til organisasjonen via “Instillinger” på Gitea-siden
  2. Oppdater id og org-feltene i App/config/applicationmetadata.json-filen til å peke på organisasjonen

I denne modulen skal du bygge og publisere applikasjonen til Altinns testmiljø (TT02) og verifisere at alt fungerer som forventet også der.

Temaer som dekkes i denne modulen:

  • Sette egendefinerte krav for ressursbruk
  • Bygge applikasjon
  • Publisering (deployment) av applikasjon

Oppgaver

Alle applikasjoner kommer med et standardoppsett for ressursbruk og skalering i applikasjonsclusteret. Du kan overstyre følgende innstillinger for å tilpasse applikasjonens behov:

  • Antall replikas (instanser av applikasjonen som kjører samtidig)
  • Regler for når applikasjonen skal skalere antall instanser basert på CPU eller minnebruk
  • Hvor mye ressurser som skal dedikeres til applikasjonens instanser i clusteret

Ved å overstyre disse innstillingene kan man spare kostnader og sørge for at de har en optimal ytelse med alle nødvendige ressurser tilgjengelig.

Oppgaver

For denne testapplikasjonen ønsker vi at du skal skalere ned ressursbruken til det minimale med følgende innstillinger:

  1. Skalering: replicaCount: 1
  2. Ressursbruk: Sett requests til cpu: 50m og memory: 128Mi
Alle endringer knyttet til skalering og ressursbruk gjøres i filen App/deployment/values.yaml

Nyttig dokumentasjon

Når man refererer til å bygge en applikasjon i Altinn Studio, betyr dette å opprette en versjon av applikasjonens nåværende tilstand som kan publiseres til ett eller flere miljø.

Oppgaver

  1. Opprett et nytt bygg for applikasjonen med versjonsnr 0.0.1 og legg til en beskrivende kommentar om hva versjonen inneholder.

Nyttig dokumentasjon

Ved å publisere en applikasjon til testmiljø vil man kunne teste alle integrasjoner. I tillegg benyttes TT02 ofte til å verifisere at en applikasjon oppfører seg som forventet før man produksjonssetter den.

For å kunne publisere en applikasjon til TT02 må organisasjonen som eier den ha et app-cluster i testmiljøet. I tillegg må utvikleren som skal gjennomføre publiseringen inneha rollen Deploy-TT02.

Oppgaver

  1. Publiser applikasjonen din til TT02.

Nyttig dokumentasjon

Forståelsessjekk

Nei, det er kun mulig å ha én versjon av applikasjonen ute i et miljø av gangen. Publiserer man en annen versjon, vil eksisterende versjon av applikasjonen overskrives.

Da vil alle operasjoner i forbindelse med publisering kjøres om igjen. Ressurstekster og annen metadata lagres i Altinn Plattform, og publiserings-pipeline for å rulle ut applikasjonen i clusteret vil og kjøre.

Det vil dog ikke bli spunnet opp nye poder i forbindelse med dette da det ikke er noen reelle endringer på tjenesten som kjører i miljøet.

Ja, tjenesten vil være tilgjengelig umiddelbart etter publisering. Dersom status er grønn i Altinn Studio skal du kunne nå applikasjonen.
Det er foreløpig ikke mulig for en tjenesteeier å selv fjerne en applikasjon fra et miljø når den først er publisert. Det jobbes med å få på plass denne funksjonaliteten. Ønsker du å fjerne en publisert applikasjon må du inntil videre kontakte support.

På siden for publisering finner du direktelenken til applikasjonen din. Den er på formatet <org>.apps.tt02.altinn.no/<org>/<app>.

Med mindre du er logget inn med en bruker fra før av vil denne lenken ta deg til innloggingssiden til Altinn. Logg inn med en testbruker fra organisasjonen din eller benytt deg av Tenors testdata.

Er du intern i Digdir kan du bruke “TestID” innloggings-metoden og generere en tilfeldig bruker, eller hente innloggings-detaljer for testbruker i det interne Altinn 3 test-datasettet.

Oppgaver

  1. Logg inn med en testbruker.
  2. Test de ulike sporvalgene og skjemasidene for å bekrefte at de oppfører seg som forventet.

Nyttig dokumentasjon

Oppsummering

I denne modulen har du bygget og publisert applikasjonen din til testmiljøet TT02, logget inn i Altinn med en testbruker og testet applikasjonen din.

Løsningsforslag

Kildekode Modul 3

Følgende endringer er gjort i koden:

App/deployment/values.yaml
deployment:
  
  replicaCount: 1
  
  requests:
      cpu: 50m
      memory: 128Mi

...