Kaikilla Seravon uusilla WordPress-sivustoilla on Git-versionhallinta valmiiksi alustettuna hakemistossa /data/wordpress/. Gitin käyttö pitää koodimuutokset järjestyksessä, mahdollistaa turvallisen paikallisen kehityksen ja tarjoaa selkeän muutoshistorian koko kehitystiimille.
Vaihe 1: Kloonaa sivuston koodi omalle koneellesi
Voit kloonata tuotantosivuston Git-arkiston suoraan omalle työasemallesi SSH-yhteyden yli. Tarvitset kloonaamiseen sivustosi SSH-käyttäjätunnuksen, palvelinosoitteen sekä yksilöllisen SSH-portin (löydät tiedot Seravo Pluginista tai komennolla srv system metadata).
Aja omalla työasemallasi seuraavat komennot:
git clone ssh://<ssh-kayttaja>@<sivusto>.seravo.com:<ssh-portti>/data/wordpress ~/Projects/<sivusto> --origin production
cd ~/Projects/<sivusto>
Uusi Seravo-sivusto pohjautuu valmiiksi Seravon WordPress-projektipohjaan, joten paikallinen Docker-ympäristö toimii kloonauksen jälkeen suoraan ilman erillisiä määrityksiä.
Vaihtoehtoinen tapa: Oman projektipohjan vieminen tyhjälle sivustolle
Varoitus: Älä tee tätä, jos sivustolla on jo sisältöä tai koodia tuotannossa. git push --force ylikirjoittaa palvelimen Git-historian ja tiedostot.
Jos aloitat kehityksen omasta valmiista WordPress-projektipohjastasi tyhjälle Seravo-sivustolle, voit lisätä tuotantopalvelimen etäarkistoksi (remote) ja puskea koodin palvelimelle:
git clone https://github.com/<organisaatio>/<projekti>.git ~/Projects/<sivusto>
cd ~/Projects/<sivusto>
git remote add production ssh://<ssh-kayttaja>@<sivusto>.seravo.com:<ssh-portti>/data/wordpress
git push --force production master
Useiden etäarkistojen (remotes) käyttö
Voit yhdistää paikalliseen projektiisi useita Git-etäarkistoja (esimerkiksi GitHubin tai GitLabin tiimikehitystä varten ja production-osoitteen julkaisua varten):
git remote add origin [email protected]:organisaatio/esimerkkisivusto.git
git remote add upstream https://github.com/Seravo/wordpress.git
Tarkista määritetyt etäarkistot komennolla git remote -v.
Vaihe 2: Käynnistä paikallinen ympäristö ja nouda sisältö
Kun projekti on kloonattu omalle koneellesi, käynnistä paikallinen Docker-kehitysympäristö projektihakemistossa:
seravo-docker up
Avaa yhteys paikallisen kehityskontin sisälle:
seravo-docker ssh
Jos kehität olemassa olevaa sivustoa, nouda tuotantoympäristön tietokanta, lisäosat ja teemat paikalliseen konttiin Seravon valmiilla komennoilla:
# Nouda tuotantotietokanta ja päivitä osoitteet automaattisesti .local-muotoon
wp-pull-production-db
# Nouda tuotannon lisäosat
wp-pull-production-plugins
# Nouda tuotannon teemat
wp-pull-production-themes
Vastaavat komennot löytyvät myös staging- eli varjoympäristölle muodossa wp-pull-staging-db, wp-pull-staging-plugins ja wp-pull-staging-themes.
Kun tiedot on noudettu, avaa sivusto selaimessa osoitteessa http://wordpress.local/ (tai projektin config.yml-tiedostossa määritellyssä .local-osoitteessa).
Vaihe 3: Vie muutokset tuotantoon ja sammuta ympäristö
Kun olet tehnyt ja testannut muutokset paikallisesti, tallenna ne Git-versionhallintaan ja vie tuotantoon omalta työasemaltasi:
git add .
git commit -m "Kuvaava viesti tehdyistä muutoksista"
git push production master
Huomaa, että uudemmissa projekteissa päähaaran nimi voi olla main haaran master sijaan.
Palvelimen päässä .git/hooks/post-receive-skripti suorittaa automaattisesti tarvittavat rakennusvaiheet (kuten Composer- ja Gulp-ajot), jos ne on määritetty projektissa.
Kun lopetat työskentelyn, sammuta paikallinen Docker-ympäristö omalla työasemallasi komennolla:
seravo-docker down
Huom: Älä poista palvelimen /data/wordpress/.git-hakemistoa. Sen säilyttäminen varmistaa, että kaikki sivustolle tehdyt muutokset pysyvät tallessa versionhallinnan lokissa ja julkaisut git push -komennolla toimivat jatkossakin.
Yleisimmät virhetilanteet
git push productionepäonnistuu virheeseenrefusing to update checked out branch: Oletuksena Git estää muutosten puskemisen hakemistoon, jossa sama haara on valmiiksi käytössä (non-bare repository). Jos loit Git-arkiston palvelimelle käsin, ota automaattinen työhakemiston päivitys käyttöön palvelimella SSH-yhteyden kautta:cd /data/wordpress && git config receive.denyCurrentBranch updateInstead
Composer- tai käännöskomennot eivät ajaudu automaattisesti
git push-komennon jälkeen: Jos olet alustanut Git-arkiston itse eikä se pohjaudu Seravon mallipohjaan, kopioi Seravon valmispost-receive-skripti käyttöön palvelimella:cp /data/wordpress/scripts/git-hooks/post-receive /data/wordpress/.git/hooks/post-receive
wp-pull-production-dbei saa yhteyttä tuotantopalvelimeen: Varmista, että paikallisen projektinconfig.yml-tiedostossa on määritetty oikeaname(SSH-käyttäjätunnus),production.domainsekäproduction.ssh_port, ja että SSH-avaimesi on lisätty palvelimelle.Paikalliset mediakirjaston kuvat eivät näy kehitysympäristössä:
wp-pull-production-dbsiirtää vain tietokannan, eiwp-content/uploads-hakemiston mediatiedostoja. Voit kopioida yksittäisiä tiedostojarsync-komennolla tai ohjata puuttuvat kuvat latautumaan suoraan tuotannosta paikallisennginx-säännön avulla.
Katso myös
Git-pohjainen työnkulku yhdistettynä paikalliseen Docker-ympäristöön tekee muutosten kehittämisestä ja julkaisemisesta nopeaa ja turvallista. Mikäli tarvitset apua sivuston kloonaamisessa, SSH-yhteyksissä tai Git-asetuksissa, asiakaspalvelumme auttaa osoitteessa [email protected].
