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:
SSH-yhteys on kunnossa: Oma julkinen SSH-avaimesi on lisätty palvelimelle ja SSH-yhteys sivustolle toimii.
Paikallinen Git-arkisto: Sivuston koodi on kloonattu omalle työasemallesi (katso tarvittaessa ohje Sivuston kloonaaminen paikalliseen kehitysympäristöön ja Gitin käyttö).
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 buildtaigulp 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- taiscp-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 pushepäonnistuu virheeseenrefusing 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 pushantaa virheenerror: src refspec master does not match any: Paikallinen haarasi on todennäköisesti nimeltäänmaineikämaster. Julkaise muutokset komennollagit 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].
