Veebilehe avaldamine gitist (GitHub ja GitLab)

Veebilehe avaldamine gitist

Saad avaldada oma veebilehe otse GitHubist või GitLabist. Kui harusse tuleb uus versioon, avaldatakse see automaatselt ja eelmise versiooni juurde saab naasta ühe nupuvajutusega. SFTP töötab endiselt kõrvuti.

Gitist avaldamine on kasutusel uue platvormi veebilehtedel. Leiad selle minu kontol jaotisest Veebimajutus (Web hosting), kui avad veebilehe ja selle all jaotise Avaldamine gitist (Deploy from git). Kui jaotises on kirjas, et gitist avaldamine ei kuulu paketti, võta ühendust klienditoega.

1. Lülita gitist avaldamine sisse

1. Ava minu kontol Veebimajutus (Web hosting), vali veebileht ja ava Avaldamine gitist (Deploy from git).
2. Sisesta repositooriumi aadress SSH-kujul, näiteks git@github.com:yritys/sivusto.git, ja haru, tavaliselt main.
3. Vali veebilehe tüüp. Staatiline või otse avalik veebileht (Static or directly public site) avaldab repositooriumi sellisena, nagu see on. Rakendus (Application) (näiteks Laravel või Symfony) avaldab rakenduse ja näitab internetile ainult avalikku kataloogi, tavaliselt public.
4. Lisa vajadusel build-käsk ja püsivad teed (vaata allpool).
5. Vajuta Lülita gitist avaldamine sisse (Turn on git deploy).
6. Vaatesse ilmub webhooki saladus. Salvesta see kohe, sest seda näidatakse ainult selle ühe korra. Kui see kaob, saad luua uue menüüst Rohkem toiminguid (More actions).

2. Lisa deploy-võti repositooriumisse

Minu konto näitab veebilehe jaoks loodud avalikku võtit. Võtme abil saab server repositooriumi lugeda, kuid mitte sinna kirjutada.

1. Kopeeri võti minu kontolt.
2. Ava GitHubis repositoorium ja vali Settings, Deploy keys ja Add deploy key.
3. Kleebi võti ja anna sellele nimi. Jäta valik Allow write access märkimata.

3. Lisa webhook automaatse avaldamise jaoks

Ava GitHubis repositooriumi Settings, Webhooks ja Add webhook ning täida vorm nii:

1. Payload URL: kleebi webhooki aadress minu kontolt.
2. Content type: vali menüüst application/json. Vaikimisi on valitud teine variant, seega tuleb see muuta.
3. Secret: kleebi webhooki saladus, mille salvestasid kasutuselevõtu ajal.
4. Which events: vali Just the push event.
5. Vajuta Add webhook. GitHub saadab testsõnumi ja selle kõrvale ilmub roheline märk, kui kõik on korras.

4. Tee esimene avaldamine

Vajuta minu kontol Avalda kohe (Deploy now). Avaldamise olek ja logi on näha avaldamise ajaloos. Pärast seda avaldatakse iga push harusse automaatselt.

Build-käsk

Build-käsk käivitatakse enne avaldamist, näiteks npm ci && npm run build. See võib kesta kuni 15 minutit. Composer ei ole eelnevalt paigaldatud, seega kasuta käsku php composer.phar install või salvesta kataloog vendor repositooriumisse.

Püsivad teed

Iga avaldamine asendab veebilehe failid uue versiooniga. Püsivaks märgitud teed säilivad ühest avaldamisest teise, seega märgi nendeks näiteks storage, .env ja kasutajate üles laaditud failid, nagu uploads.

Eelmise versiooni taastamine

Avaldamise ajaloos on iga õnnestunud avaldamise juures nupp Taasta see versioon (Roll back to this version). Taastamine on kohene. Säilitatavate versioonide arvu saad valida seadetes.

Hea teada

• Ebaõnnestunud avaldamine ei muuda veebilehte, vaid eelmine versioon jääb nähtavaks. Põhjus on näha avaldamise logis.
• Giti alammooduleid ja LFS-faile ei avaldata.
• Gitist avaldamise seadeid saavad muuta peakasutaja ja tehniline kontaktisik.