Siirry pääsisältöön

Julkaisu Git-versionhallinnan avulla

Opi julkaisemaan WordPress-sivuston koodimuutokset Seravon tuotantoympäristöön Git-versionhallinnalla. Katso ohjeet git remote -määrityksiin, git push -julkaisuun sekä post-receive-hookin käyttöön.

Git-versionhallinta on turvallinen ja nopea tapa viedä koodimuutokset (kuten teemat, omat lisäosat ja Composer-riippuvuudet) paikallisesta kehitysympäristöstä Seravon tuotanto- tai staging-palvelimelle.

Esivaatimukset

Ennen muutosten julkaisemista varmista seuraavat asiat:

Vaihe 1: Tarkista tai lisää git remote -osoite

Siirry työasemallasi projektihakemistoon ja tarkista määritetyt Git-remotet komennolla:

git remote -v

Jos olet kloonannut projektin suoraan Seravon palvelimelta, production-niminen git remote on jo valmiina:

production  ssh://<ssh-kayttaja>@<sivusto>.seravo.com:<ssh-portti>/data/wordpress (fetch)
production ssh://<ssh-kayttaja>@<sivusto>.seravo.com:<ssh-portti>/data/wordpress (push)

Jos production puuttuu (esimerkiksi jos kloonasit projektin GitHubista tai GitLabista), lisää se komennolla:

git remote add production ssh://<ssh-kayttaja>@<sivusto>.seravo.com:<ssh-portti>/data/wordpress

Vastaavasti voit lisätä varjoympäristön oman SSH-portin avulla komennolla git remote add staging ssh://<ssh-kayttaja>@<sivusto>.seravo.com:<staging-ssh-portti>/data/wordpress.

Vaihe 2: Julkaise muutokset (git push)

Tallenna paikallisesti tekemäsi muutokset Git-versionhallintaan ja puske ne tuotantopalvelimelle:

git add .
git commit -m "Kuvaava viesti tehdyistä muutoksista"
git push production master

Jos paikallisen projektisi päähaara on nimeltään main eikä palvelimella ole erillistä main-haaraa, voit puskea paikallisen main-haaran suoraan palvelimen master-haaraan seuraavasti:

git push production main:master

Julkaisun jälkeisten toimien automatisointi (post-receive-hook)

Oletuksena git push siirtää palvelimelle vain muuttuneet tiedostot. Jotta sivusto toimii heti oikein julkaisun jälkeen, palvelimen päässä kannattaa ajaa automaattisesti tarvittavat rakennus- ja välimuistikomennot:

  • Composer-riippuvuudet: Asennetaan composer.json-tiedostossa määritellyt paketit (composer install --no-dev).

  • Koodin kääntäminen (Build): Rakennetaan teeman CSS- ja JavaScript-tiedostot (esim. npm run build tai gulp build), jos käännettyjä tiedostoja ei tallenneta suoraan Gitiin.

  • Välimuistien tyhjennys: Tyhjennetään WordPressin objektivälimuisti ja Nginxin sivuvälimuisti, jotta muutokset näkyvät kävijöille välittömästi.

Seravon WordPress-projektipohjassa on valmis malliskripti polussa /data/wordpress/scripts/git-hooks/post-receive. Voit myös luoda tai muokata tiedostoa /data/wordpress/.git/hooks/post-receive suoraan palvelimella:

#!/bin/bash
set -e

echo "Suoritetaan julkaisun jälkeiset tehtävät..."

# Asenna Composer-riippuvuudet (jos composer.json on käytössä)
if [ -f "/data/wordpress/composer.json" ]; then
cd /data/wordpress && composer install --no-dev --optimize-autoloader
fi

# Käännä teeman resurssit tarvittaessa (muokkaa polku vastaamaan omaa teemaasi)
if [ -f "/data/wordpress/htdocs/wp-content/themes/oma-teema/package.json" ]; then
cd /data/wordpress/htdocs/wp-content/themes/oma-teema && npm run build
fi

# Tyhjennä WordPressin objektivälimuisti ja nginx-sivuvälimuisti
wp cache flush --path=/data/wordpress/htdocs
wp-purge-cache

Anna skriptille suoritusoikeudet palvelimella SSH-yhteyden kautta, jotta Git ajaa sen jokaisen git push -komennon päätteeksi:

chmod +x /data/wordpress/.git/hooks/post-receive

Lue lisää mahdollisuuksista artikkelista Git-hookien käyttäminen.

Tietokanta ja mediatiedostot (uploads)

Git-versionhallinta on tarkoitettu vain sivuston lähdekoodille (teemat, omat lisäosat ja konfiguraatiotiedostot). Git-julkaisu ei siirrä tietokantaa eikä wp-content/uploads-hakemiston mediatiedostoja.

  • Älä lisää mediatiedostoja tai tietokantavedoksia Gitiin: Suuret binääritiedostot kasvattavat Git-arkiston kokoa nopeasti ja hidastavat kloonausta sekä julkaisuja.

  • Siirrä sisältö erillisillä työkaluilla: Jos haluat siirtää mediatiedostoja, käytä rsync- tai scp-komentoa SSH-yhteyden yli.

  • Varo ylikirjoittamasta tuotantotietokantaa: Älä koskaan tuo paikallista kehitystietokantaa suoraan tuotantoon, jos tuotantosivustolle on tullut uusia tilauksia, lomakeviestejä tai artikkeleita. Tee sisällölliset tai asetuksiin liittyvät tietokantamuutokset tuotannossa hallitusti joko hallintapaneelin kautta tai WP-CLI-komennoilla.

Yleisimmät virhetilanteet

  • git push epäonnistuu virheeseen refusing to update checked out branch: Oletuksena Git estää muutosten puskemisen hakemistoon, jossa sama haara on käytössä (non-bare repository). Ota automaattinen työhakemiston päivitys käyttöön palvelimella SSH-yhteyden kautta:

    cd /data/wordpress && git config receive.denyCurrentBranch updateInstead
  • post-receive-skripti ei suoritu julkaisun yhteydessä: Varmista, että tiedostolla on suoritusoikeudet (chmod +x /data/wordpress/.git/hooks/post-receive) ja että tiedosto on tallennettu Unix-rivinvaihdoilla (LF).

  • git push antaa virheen error: src refspec master does not match any: Paikallinen haarasi on todennäköisesti nimeltään main eikä master. Julkaise muutokset komennolla git push production main:master.

  • Yhteys palvelimelle epäonnistuu (Permission denied (publickey)): Varmista, että julkinen SSH-avaimesi on lisätty palvelimen ~/.ssh/authorized_keys-tiedostoon ja että SSH-käyttäjätunnus sekä portti vastaavat sivustosi tietoja.

Katso myös

Git-julkaisu yhdistettynä automatisoituihin post-receive-toimintoihin tekee päivitysten viemisestä tuotantoon toistettavaa ja turvallista. Mikäli tarvitset apua Git-remote-osoitteiden, hook-skriptien tai SSH-yhteyksien määrittämisessä, asiakaspalvelumme auttaa osoitteessa [email protected].

Vastasiko tämä kysymykseesi?