Versioner och publicering

Att bygga och att servera är två olika saker, och plattformen skiljer dem åt med två delar: versionerna (appens grenar, var och en med sin design och sina data) och publiceringen (vilken adress som serverar vilken version).

Regeln som sammanfattar allt: varje host serverar EN version av den här appen. Att publicera är inte att ”lägga ut” — det är att välja vilken version en adress serverar.

#En apps versioner

En version är en fullständig gren av applikationen: skärmarna, modellen, API:erna, skripten, arbetsflödena, rapporterna och datan. Två versioner delar ingenting — att röra den ena rör inte den andra.

Versionsmenyn ligger i appträdets rubrik, bredvid inställningsknappen. Det den visar är din arbetsversion:

Element	Vad det gör
Versionslistan	Att klicka på en rad byter din arbetsversion till den. Bocken markerar den aktuella.
⟲ (på varje rad)	Öppnar den versionens historik — vad som ändrades, när och av vem.
🗑 (på varje rad)	Tar bort versionen.
Ny version…	Skapar en gren.
Selektiv merge…	Hämtar in utvalda ändringar från en version till en annan.

I en app som aldrig haft versioner säger menyn ”Den här appen har ingen historik ännu.”.

#Skapa en version

1. Öppna versionsmenyn och klicka på Ny version….
2. Fyll i Namn (till exempel 1.1) och välj Utgår från — ursprungsversionen.
3. Klicka på Skapa version.

”Skapar en gren utifrån ursprungsversionen, med data kopierade. Den nya versionen serveras inte av någon host förrän en host kopplas till den.”

Två följder värda att komma ihåg:

• Datan kopieras, den delas inte. 1.1 föds med en kopia av det som main hade i det ögonblicket; därefter lever de skilda liv.
• Ingen ser den, förrän du publicerar en adress som pekar på den. Du kan arbeta i månader i en version utan att någon användare märker den.

Så snart versionen har skapats arbetar du i den (”Versionen ”1.1” har skapats — du arbetar nu i den.”).

#Ta bort en version

🗑 på en rad tar bort ”den här versionens design, databas och historik. De andra versionerna rörs inte”. Två skydd:

• versionen main går inte att ta bort;
• den version du arbetar i går heller inte att ta bort — ”byt till en annan innan du tar bort den”.

#Publicera

Publiceringen bor i Appens inställningar → Allmänt, i avsnittet Publicering.

Varje rad är en publicerad adress: hosten, versionen den serverar, och ✕ för att Avpublicera.

Så här publicerar du en ny adress:

1. Skriv hosten i fältet (exemplet lyder t.ex. kartor.foretaget.se) — bara namnet, utan https:// och utan sökvägar.
2. Välj versionen som den ska servera.
3. Klicka på Publicera.

När det är bekräftat visas ”Hosten har publicerats.” och den nya raden läggs till i listan.

#Innan det finns någon adress alls

”Inga publicerade hostar — appen svarar på /app/{slug} med arbetsversionen.” Det är den interna adressen som alltid finns, och det är så man provar en app innan den får ett eget namn.

Lägg märke till skillnaden: på /app/{slug} körs arbetsversionen hos den som tittar; på en publicerad host körs den version hosten serverar, för alla. Det är därför man i produktion alltid publicerar en host — så att det användarna ser inte beror på vilken gren någon råkar arbeta i.

#Avpublicera

✕ på raden (Avpublicera) tar bort adressen. Versionen rörs inte — den slutar bara serveras där.

För att byta version på en redan publicerad adress avpublicerar du och publicerar igen med den nya versionen. Det är operationen ”sätta 1.1 i produktion”, och den tar sekunder.

#Appen i drift

En publicerad adress serverar den byggda applikationen. Den som kommer dit ser inte plattformen: hon ser appens inloggningsskärm, med appens tema.

Därifrån beror det varje person kan göra på kontot hon loggar in med och på hennes roller — ämnet för sidan Appens användare. Skärmarna för inloggning, registrering och återställning går att designa, och har en egen sida: Publika skärmar och registrering.

#Ett sunt arbetsflöde

Ett vanligt sätt att organisera det här i ett team:

1. main är versionen i produktion. Den officiella hosten (crm.foretaget.se) serverar main.
2. För en stor ändring skapar man en version (1.1) utifrån main och arbetar där.
3. För att visa den för någon i förväg publicerar man en andra host (crm-test.foretaget.se) som serverar 1.1.
4. När den är klar börjar produktionshosten servera 1.1 — eller så hämtar man in det som är intressant till main med Selektiv merge….

#Vad som inte följer med appen

När du exporterar en app i ett paket lämnas hosten utanför — den tillhör den här installationen, och samma paket installerat någon annanstans får sina egna adresser. Utanför lämnas också körningshistoriken och API-nycklarna. Se Importera och exportera appar.

#Vanliga frågor

Jag bytte version och appen verkar tom. Varje version har sina data. 1.1 har bara det som fanns i ursprunget i det ögonblick den skapades, plus det som gjorts där sedan dess.

Jag publicerade hosten och webbläsaren hittar ingenting. DNS saknas: namnet måste peka på den här installationen. Tills det är gjort använder du /app/{slug} för att prova.

Kan jag ha två hostar som serverar samma version? Ja. En host serverar en version, men ingenting hindrar att flera pekar på samma — till exempel en kort adress och en fullständig.

Jag råkade ta bort en version. Det går inte att ångra: det tar bort dess design, dess data och dess historik. Det är skälet till att versioner i produktion alltid bör ha en host kopplad — en version som serveras av en host är en version som ingen tar bort av distraktion.