Sivuston julkaisu gitistä

Sivuston julkaisu gitistä

Voit julkaista sivustosi suoraan GitHubista tai GitLabista. Kun haaraan tulee uusi versio, se julkaistaan automaattisesti, ja edelliseen versioon voi palata yhdellä napilla. SFTP toimii edelleen rinnalla.

Git-julkaisu on käytössä uuden alustan sivustoilla. Näet sen oma-tilissä kohdassa Webhotellit, kun avaat sivuston ja sen alta osion Julkaisu gitistä. Jos osiossa lukee, ettei git-julkaisu kuulu paketin sisältöön, ota yhteyttä tukeen.

1. Ota git-julkaisu käyttöön

1. Avaa oma-tilissä Webhotellit, valitse sivusto ja avaa Julkaisu gitistä.
2. Kirjoita repositorion osoite SSH-muodossa, esimerkiksi git@github.com:yritys/sivusto.git, ja haara, yleensä main.
3. Valitse sivuston tyyppi. Staattinen tai suoraan julkinen sivusto julkaisee repositorion sellaisenaan. Sovellus (esimerkiksi Laravel tai Symfony) julkaisee sovelluksen ja näyttää internetiin vain julkisen hakemiston, yleensä public.
4. Lisää tarvittaessa build-komento ja pysyvät polut (katso alla).
5. Paina Ota git-julkaisu käyttöön.
6. Näkymään tulee webhookin salaisuus. Tallenna se heti, sillä se näytetään vain tämän kerran. Jos se katoaa, voit luoda uuden kohdasta Lisää toimintoja.

2. Lisää deploy-avain repositorioon

Oma-tili näyttää sivustolle luodun julkisen avaimen. Avaimen avulla palvelin voi lukea repositoriota, mutta ei kirjoittaa siihen.

1. Kopioi avain oma-tilistä.
2. Avaa GitHubissa repositorio ja valitse Settings, Deploy keys ja Add deploy key.
3. Liitä avain ja anna sille nimi. Jätä kohta Allow write access valitsematta.

3. Lisää webhook automaattista julkaisua varten

Avaa GitHubissa repositorion Settings, Webhooks ja Add webhook, ja täytä lomake näin:

1. Payload URL: liitä webhookin osoite oma-tilistä.
2. Content type: valitse valikosta application/json. Oletuksena valittuna on eri vaihtoehto, joten tämä pitää vaihtaa.
3. Secret: liitä webhookin salaisuus, jonka tallensit käyttöönoton yhteydessä.
4. Which events: valitse Just the push event.
5. Paina Add webhook. GitHub lähettää testiviestin, ja sen viereen tulee vihreä merkki, kun kaikki on oikein.

4. Tee ensimmäinen julkaisu

Paina oma-tilissä Julkaise nyt. Julkaisun tila ja loki näkyvät julkaisuhistoriassa. Tämän jälkeen jokainen push haaraan julkaistaan automaattisesti.

Build-komento

Build-komento ajetaan ennen julkaisua, esimerkiksi npm ci && npm run build. Se saa kestää enintään 15 minuuttia. Composer ei ole valmiiksi asennettuna, joten käytä komentoa php composer.phar install tai tallenna vendor-hakemisto repositorioon.

Pysyvät polut

Jokainen julkaisu korvaa sivuston tiedostot uudella versiolla. Pysyviksi merkityt polut säilyvät julkaisusta toiseen, joten merkitse niihin esimerkiksi storage, .env ja käyttäjien lataamat tiedostot, kuten uploads.

Palautus edelliseen versioon

Julkaisuhistoriassa on jokaisen onnistuneen julkaisun kohdalla nappi Palauta tähän versioon. Palautus on välitön. Säilytettävien versioiden määrän voit valita asetuksista.

Hyvä tietää

• Epäonnistunut julkaisu ei muuta sivustoa, vaan edellinen versio pysyy näkyvissä. Syy näkyy julkaisun lokissa.
• Git-alimoduuleja ja LFS-tiedostoja ei julkaista.
• Git-julkaisun asetuksia voivat muuttaa pääkäyttäjä ja tekninen yhteyshenkilö.