Versjoner og publisering

Å bygge og å servere er to forskjellige ting, og plattformen skiller dem med to brikker: versjonene (grener av appen, hver med sitt design og sine data) og publiseringen (hvilken adresse som serverer hvilken versjon).

Regelen som oppsummerer alt: hver vert serverer ÉN versjon av denne appen. Å publisere er ikke «å legge ut» — det er å velge hvilken versjon en adresse serverer.

#Versjonene av en app

En versjon er en komplett gren av applikasjonen: skjermene, modellen, API-ene, skriptene, arbeidsflytene, rapportene og dataene. To versjoner deler ingenting — å røre den ene rører ikke den andre.

Versjonsmenyen ligger i toppteksten i treet til appen, ved siden av innstillingsknappen. Det den viser, er din arbeidsversjon:

Element	Hva det gjør
Listen over versjoner	Å klikke på en linje bytter din arbeidsversjon til den. Haken markerer den gjeldende.
⟲ (på hver linje)	Åpner historikken til den versjonen — hva som endret seg, når og av hvem.
🗑 (på hver linje)	Sletter versjonen.
Ny versjon…	Lager en gren.
Selektiv sammenslåing…	Henter utvalgte endringer fra en versjon inn i en annen.

I en app som aldri har hatt versjoner, sier menyen «Denne appen har ingen historikk ennå.».

#Lage en versjon

1. Åpne versjonsmenyen og klikk på Ny versjon….
2. Fyll inn Navn (for eksempel 1.1) og velg Fra — kildeversjonen.
3. Klikk på Opprett versjon.

«Lager en gren fra kildeversjonen, med dataene kopiert. Den nye versjonen serveres ikke av noen vert før en vert knyttes til den.»

To konsekvenser som er verdt å merke seg:

• Dataene kopieres, de deles ikke. 1.1 fødes med en kopi av det main hadde i det øyeblikket; fra da av lever de hver sine liv.
• Ingen ser den, før du publiserer en adresse som peker på den. Du kan jobbe i månedsvis i en versjon uten at noen bruker merker det.

Så snart versjonen er opprettet, jobber du i den («Versjonen «1.1» er opprettet — du jobber i den nå.»).

#Slette en versjon

🗑-en på en linje sletter «designet, databasen og historikken til denne versjonen. De andre versjonene røres ikke». To beskyttelser:

• versjonen main kan ikke slettes;
• versjonen du jobber i, heller ikke — «bytt til en annen før du sletter den».

#Publisere

Publiseringen bor under Appinnstillinger → Generelt, i seksjonen Publisering.

Hver linje er en publisert adresse: verten, versjonen den serverer, og ✕-en for å Avpublisere.

Slik publiserer du en ny adresse:

1. Skriv verten i feltet (eksempelet sier f.eks. kart.bedrift.no) — bare navnet, uten https:// eller stier.
2. Velg versjonen den skal servere.
3. Klikk på Publiser.

Når det er bekreftet, dukker «Verten er publisert.» opp, og den nye linjen slutter seg til listen.

#Før det finnes noen adresse

«Ingen publiserte verter — appen svarer på /app/{slug} med arbeidsversjonen.» Det er den interne adressen som alltid, og det er slik man prøver ut en app før man gir den eget navn.

Legg merke til forskjellen: på /app/{slug} kjører arbeidsversjonen til den som ser på; på en publisert vert kjører versjonen verten serverer, for alle. Det er derfor man i produksjon alltid publiserer en vert — for at det brukerne ser, ikke skal avhenge av hvilken gren noen jobber i.

#Avpublisere

✕-en på linjen (Avpubliser) fjerner adressen. Versjonen røres ikke — den slutter bare å bli servert der.

For å bytte versjon på en allerede publisert adresse, avpubliser og publiser på nytt med den nye versjonen. Det er operasjonen «sette 1.1 i produksjon», og den tar sekunder.

#Appen i drift

En publisert adresse serverer den bygde applikasjonen. Den som kommer dit, ser ikke plattformen: de ser inngangsskjermen til appen, med appens tema.

Derfra avhenger det hver person får gjort, av kontoen de logger inn med og rollene til den — stoff for siden Brukere av appen. Skjermene for innlogging, registrering og gjenoppretting kan designes, og har sin egen side: Offentlige skjermer og registrering.

#En sunn arbeidsflyt

En vanlig måte å organisere dette på i et team:

1. main er versjonen i produksjon. Den offisielle verten (crm.empresa.pt) serverer main.
2. For en stor endring lages en versjon (1.1) fra main, og man jobber der.
3. For å vise den til noen før tiden, publiseres en andre vert (crm-teste.empresa.pt) som serverer 1.1.
4. Når den er klar, går produksjonsverten over til å servere 1.1 — eller man henter det som teller inn i main med Selektiv sammenslåing….

#Hva som ikke reiser med appen

Når du eksporterer en app i en pakke, blir verten stående utenfor — den tilhører denne installasjonen, og den samme pakken installert et annet sted får sine egne adresser. Utenfor blir også kjøringshistorikken og API-nøklene. Se Importere og eksportere apper.

#Vanlige spørsmål

Jeg byttet versjon og appen virker tom. Hver versjon har sine data. 1.1 har bare det som fantes i kilden i det øyeblikket den ble opprettet, pluss det som er gjort der siden.

Jeg publiserte verten og nettleseren finner ingenting. DNS mangler: navnet må peke på denne installasjonen. Inntil det skjer, bruk /app/{slug} for å prøve.

Kan jeg ha to verter som serverer samme versjon? Ja. En vert serverer én versjon, men ingenting hindrer at flere peker på den samme — for eksempel en kort adresse og en fullstendig.

Jeg slettet en versjon ved et uhell. Det finnes ingen vei tilbake: det sletter designet, dataene og historikken til den. Det er grunnen til at versjoner i produksjon alltid bør ha en vert knyttet til seg — en versjon som serveres av en vert, er en versjon ingen sletter i distraksjon.