Siirry pääsisältöön

Sivuston kloonaaminen paikalliseen kehitysympäristöön ja Gitin käyttö

Opi kloonaamaan Seravo-sivustosi paikalliseen Docker-kehitysympäristöön Gitillä, noutamaan tuotantotietokanta ja lisäosat sekä viemään koodimuutokset hallitusti tuotantoon.

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 production epäonnistuu virheeseen refusing 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 valmis post-receive-skripti käyttöön palvelimella:

    cp /data/wordpress/scripts/git-hooks/post-receive /data/wordpress/.git/hooks/post-receive
  • wp-pull-production-db ei saa yhteyttä tuotantopalvelimeen: Varmista, että paikallisen projektin config.yml-tiedostossa on määritetty oikea name (SSH-käyttäjätunnus), production.domain sekä production.ssh_port, ja että SSH-avaimesi on lisätty palvelimelle.

  • Paikalliset mediakirjaston kuvat eivät näy kehitysympäristössä: wp-pull-production-db siirtää vain tietokannan, ei wp-content/uploads-hakemiston mediatiedostoja. Voit kopioida yksittäisiä tiedostoja rsync-komennolla tai ohjata puuttuvat kuvat latautumaan suoraan tuotannosta paikallisen nginx-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].

Vastasiko tämä kysymykseesi?