Versiot ja julkaisu

Rakentaminen ja tarjoilu ovat kaksi eri asiaa, ja alusta erottaa ne kahdella palasella: versiot (sovelluksen haarat, kullakin oma suunnitelmansa ja oma datansa) ja julkaisu (mikä osoite tarjoilee mitä versiota).

Sääntö, joka tiivistää kaiken: jokainen host tarjoilee YHTÄ tämän sovelluksen versiota. Julkaisu ei ole ”verkkoon panemista” — se on sen valitsemista, mitä versiota osoite tarjoilee.

#Sovelluksen versiot

Versio on sovelluksen kokonainen haara: näytöt, malli, API:t, skriptit, työnkulut, raportit ja data. Kaksi versiota ei jaa mitään — yhden muokkaaminen ei kosketa toista.

Versioiden valikko on sovelluksen puun otsikkorivillä, asetuspainikkeen vieressä. Se, mitä valikko näyttää, on sinun työversiosi:

Elementti	Mitä se tekee
Versiolista	Rivin napsauttaminen vaihtaa työversiosi siihen. Valintamerkki osoittaa nykyisen.
⟲ (kullakin rivillä)	Avaa sen version historian — mikä muuttui, milloin ja kenen toimesta.
🗑 (kullakin rivillä)	Poistaa version.
Uusi versio…	Luo haaran.
Valikoiva merge…	Tuo valittuja muutoksia versiosta toiseen.

Sovelluksessa, jolla ei ole koskaan ollut versioita, valikko sanoo ”Tällä sovelluksella ei ole vielä historiaa.”.

#Version luominen

1. Avaa versioiden valikko ja napsauta Uusi versio….
2. Täytä Nimi (esimerkiksi 1.1) ja valitse Lähteenä — lähdeversio.
3. Napsauta Luo versio.

”Luo haaran lähdeversiosta ja kopioi sen datan. Uutta versiota ei tarjoile mikään host, ennen kuin siihen liitetään yksi.”

Kaksi seurausta, jotka kannattaa pitää mielessä:

• Data kopioidaan, ei jaeta. 1.1 syntyy kopiolla siitä, mitä main-versiolla sillä hetkellä oli; siitä eteenpäin ne elävät erillään.
• Kukaan ei näe sitä, ennen kuin julkaiset osoitteen joka osoittaa siihen. Voit työskennellä versiossa kuukausia ilman että yksikään käyttäjä huomaa sitä.

Heti kun versio on luotu, työskentelet siinä (”Versio ”1.1” luotu — työskentelet nyt siinä.”).

#Version poistaminen

Rivin 🗑 poistaa ”tämän version suunnitelman, tietokannan ja historian. Muihin versioihin ei kosketa”. Kaksi suojaa:

• main-versiota ei poisteta;
• versiota, jossa työskentelet, ei myöskään — ”vaihda toiseen ennen poistoa”.

#Julkaiseminen

Julkaisu asuu kohdassa Sovelluksen asetukset → Yleistä, osiossa Julkaisu.

Jokainen rivi on julkaistu osoite: host, versio jota se tarjoilee, ja ✕, jolla Poista julkaisu tehdään.

Uuden osoitteen julkaiseminen:

1. Kirjoita host kenttään (esimerkki sanoo esim. kartat.yritys.fi) — vain nimi, ilman https://-alkua ja polkuja.
2. Valitse versio, jota se alkaa tarjoilla.
3. Napsauta Julkaise.

Vahvistuksen jälkeen näkyy ”Host julkaistu.” ja uusi rivi liittyy listaan.

#Ennen kuin osoitetta on olemassa

”Ei julkaistuja hosteja — sovellus vastaa osoitteessa /app/{slug} työversiolla.” Se on tuttu sisäinen osoite, ja niin sovellusta kokeillaan ennen kuin sille annetaan oma nimi.

Huomaa ero: osoitteessa /app/{slug} ajaa katsojan oma työversio; julkaistussa hostissa ajaa versio, jota host tarjoilee, kaikille. Siksi tuotannossa julkaistaan aina host — jotta se, mitä käyttäjät näkevät, ei riipu siitä, missä haarassa joku sattuu työskentelemään.

#Julkaisun poistaminen

Rivin ✕ (Poista julkaisu) ottaa osoitteen pois. Versioon ei kosketa — sitä vain lakataan tarjoilemasta siellä.

Vaihtaaksesi versiota jo julkaistussa osoitteessa poista julkaisu ja julkaise uudelleen uudella versiolla. Se on ”1.1 tuotantoon” -operaatio, ja se vie sekunteja.

#Sovellus käynnissä

Julkaistu osoite tarjoilee rakennettua sovellusta. Sinne saapuva ei näe alustaa: hän näkee sovelluksen sisäänkäyntinäytön, sen teemalla.

Siitä eteenpäin se, mitä kukin voi tehdä, riippuu tilistä jolla hän kirjautuu ja sen rooleista — sivun Sovelluksen käyttäjät aihe. Sisäänkirjautumis-, rekisteröitymis- ja palautusnäytöt ovat suunniteltavissa, ja niillä on oma sivunsa: Julkiset näytöt ja rekisteröityminen.

#Terve työnkulku

Tavallinen tapa järjestää tämä tiimissä:

1. main on tuotannossa oleva versio. Virallinen host (crm.empresa.pt) tarjoilee main-versiota.
2. Isoa muutosta varten luodaan versio (1.1) main-versiosta ja työskennellään siellä.
3. Sen näyttämiseksi jollekulle ennen aikojaan julkaistaan toinen host (crm-teste.empresa.pt) tarjoilemaan 1.1:tä.
4. Kun se on valmis, tuotantohost alkaa tarjoilla 1.1:tä — tai kiinnostava tuodaan main-versioon Valikoivalla mergellä….

#Mikä ei matkusta sovelluksen mukana

Kun viet sovelluksen paketiksi, host jää ulkopuolelle — se kuuluu tälle asennukselle, ja sama paketti toisaalle asennettuna saa omat osoitteensa. Ulkopuolelle jäävät myös suoritushistoria ja API-avaimet. Katso Sovellusten tuonti ja vienti.

#Usein kysyttyä

Vaihdoin versiota ja sovellus näyttää tyhjältä. Jokaisella versiolla on oma datansa. 1.1:llä on vain se, mitä lähteessä oli sen luontihetkellä, plus se mitä siellä on sen jälkeen tehty.

Julkaisin hostin eikä selain löydä mitään. DNS puuttuu: nimen on osoitettava tähän asennukseen. Sillä välin käytä osoitetta /app/{slug} kokeilemiseen.

Voiko kaksi hostia tarjoilla samaa versiota? Kyllä. Yksi host tarjoilee yhtä versiota, mutta mikään ei estä useaa osoittamasta samaan — esimerkiksi lyhyt osoite ja täydellinen osoite.

Poistin version vahingossa. Sitä ei voi perua: se poistaa version suunnitelman, datan ja historian. Siksi tuotantoversioilla on aina host liitettynä — versio, jota host tarjoilee, on versio, jota kukaan ei poista vahingossa.