Jos olet rakentanut sovelluksen ja koodi sijaitsee GitHub-repossa, sen vieminen käyttäjien saataville ei pitäisi viedä kokonaista iltapäivää. Harbor yhdistyy suoraan GitHubiin ja hoitaa julkaisuputken - buildin, ajon, SSL:n ja verkkotunnuksen - ilman että sinun tarvitsee kirjoittaa infrastruktuurikoodia tai konfiguroida palvelinta.
Tässä käydään läpi tarkalleen, miten viet repositoriosta julkaistuun tuotantosivustoon.
Vaihe 1: Yhdistä GitHub-tilisi
Siirry Harborin hallintapaneelissa Websites-osioon ja valitse "Add from GitHub". Sinut ohjataan GitHubin OAuth-prosessiin, jossa annat Harborille käyttöoikeuden. Voit sallia pääsyn kaikkiin repoihin tai vain tiettyihin - Harbor pyytää vain ne minimioikeudet, joita tarvitaan koodin lukemiseen ja push-tapahtumien vastaanottamiseen.
Kun yhteys on muodostettu, repositoriosi näkyvät Harborin käyttöliittymässä. Sekä julkiset että yksityiset repot toimivat.
Vaihe 2: Valitse repositorio ja haara
Valitse repositorio, jonka haluat julkaista. Harbor kysyy, mitä haaraa seurataan - yleensä tuotannossa se on main tai master. Jokainen kyseiseen haaraan tehty push käynnistää automaattisesti uuden julkaisun.
Voit käynnistää julkaisun myös manuaalisesti hallintapaneelista milloin tahansa. Tämä on kätevää esimerkiksi silloin, kun haluat julkaista uudelleen ilman koodimuutosta ympäristömuuttujan päivityksen jälkeen.
Vaihe 3: Anna Harborin tunnistaa kehys
Harbor analysoi repositoriosi ja tunnistaa kehyksen tai runtime-ympäristön automaattisesti. Se tunnistaa muun muassa Next.js:n, staattisen Reactin, Vuen, Viten, tavallisen Node.js:n sekä staattiset HTML- ja CSS-sivustot. Useimmissa projekteissa sinun ei tarvitse määrittää build-komentoa tai output-hakemistoa itse - Harbor päättelee ne package.jsonista ja projektin rakenteesta.
Jos projektillasi on epätavallisia vaatimuksia, voit ohittaa automaattisesti tunnistetut asetukset. Build-komento, start-komento ja output-hakemisto ovat kaikki muokattavissa sovelluskohtaisesti.
Vaihe 4: Lisää ympäristömuuttujat
Ennen ensimmäistä julkaisua lisää sovelluksesi tarvitsemat ympäristömuuttujat, kuten API-avaimet, tietokantayhteydet ja feature flagit. Harbor tallentaa ympäristömuuttujat salattuina. Ne lisätään sovellukseesi build- ja ajovaiheessa, eikä niitä koskaan näy repossasi tai build-lokeissa.
Voit lisätä, päivittää ja poistaa muuttujia milloin tahansa. Muuttujien muutokset eivät julkaise sovellustasi automaattisesti uudelleen, joten päivityksen jälkeen sinun tulee käynnistää uusi julkaisu.
Vaihe 5: Julkaise
Klikkaa julkaise. Harbor kloonaa repositoriosi, ajaa build-komennon ja käynnistää sovelluksesi. Voit seurata build-lokia reaaliajassa hallintapaneelissa. Jos jotain menee pieleen, virheilmoitus näkyy heti samassa näkymässä.
Ensimmäinen onnistunut julkaisu kestää tavallisesti 1-3 minuuttia riippuen projektisi riippuvuuksien asennuksesta ja build-ajasta.
Vaihe 6: Yhdistä verkkotunnus
Julkaisun jälkeen sovelluksellasi on Harborin luoma URL, jota voit käyttää heti. Oman verkkotunnuksen yhdistaminen onnistuu näin:
- Jos rekisteröit verkkotunnuksen Harborin kautta, voit yhdistää sen suoraan sovelluksen asetuksista yhdellä klikkauksella.
- Jos verkkotunnus on rekisteröity muualla, lisää Harbor-sovellukseen osoittava CNAME- tai A-tietue. Harbor tunnistaa propagoinnin ja luo SSL-varmenteen automaattisesti Let's Encryptin kautta.
SSL on automaattinen ja uusiutuu ilman toimenpiteitä puoleltasi.
Julkaisut jatkossa
Kun käyttöönotto on tehty, julkaisuprosessisi on käytännössä vain push GitHubiin. Jokainen seurattuun haaraan tehty push käynnistää buildin ja julkaisun. Jos build epäonnistuu, aiempi julkaisu jatkaa toimintaansa - Harbor ei vie sivustoasi alas rikkinäisen buildin vuoksi.
Build- ja ajonaikaiset lokit löytyvät hallintapaneelista jokaiselle julkaisulle. Voit myös käynnistää ajossa olevan sovelluksen uudelleen ilman täyttä uudelleenjulkaisua, mikä on hyödyllistä, jos sovellus ajautuu virhetilaan ilman koodimuutosta.
EU-infrastruktuuri oletuksena
Kaikki edellä kuvattu toimii Hetzner Cloudin EU-infrastruktuurissa. EU-datasijainnin saamiseksi ei tarvita erillisiä asetuksia - se on oletus, ei lisäpalvelu. Sovelluksesi, sen data ja build-artifaktit pysyvät Euroopassa.
Tiimeille, joilla on GDPR-velvoitteita, tai asiakkaille, jotka edellyttävät EU-datasijaintia, Harbor poistaa tarpeen säätää alueasetuksia tai maksaa kalliimmasta premium-tasosta compliantin infrastruktuurin saamiseksi.