Siirry pääsisältöön

Johdanto lokaaliin kehitykseen

Tutustu Seravon Docker-pohjaiseen paikalliseen kehitysympäristöön. Katso valmiit kehitystyökalut, paikalliset osoitteet ja oletuskirjautumistiedot sekä ohjeet alkuun pääsemiseksi.

Lokaali kehitys mahdollistaa WordPress-sivuston koodin, teemojen ja lisäosien kehittämisen ja testaamisen turvallisesti omalla tietokoneellasi ilman, että muutokset vaikuttavat tuotantosivustoon.

Suosittelemme paikalliseen kehitykseen Seravon valmista Docker-pohjaista kehitysympäristöä, joka jäljittelee Seravon tuotantopalvelimia. Tuotantoa vastaava ympäristö varmistaa yhteensopivuuden ja nopeuttaa julkaisua, sillä paikallisesti testattu koodi toimii sellaisenaan myös tuotannossa.

Miten kehitysympäristö toimii?

Seravon paikallinen ympäristö rakentuu kevyen Docker-kontin ympärille, joka luo eristetyn ja tuotantoa vastaavan palvelinympäristön suoraan omalle työasemallesi. Toisin kuin raskas virtuaalikone, Docker-kontti käynnistyy nopeasti ja kuluttaa vain vähän järjestelmäresursseja.

WordPressin ja PHP/nginx/MariaDB-palvelinohjelmistojen lisäksi kontti sisältää valmiina samat Seravon omat ylläpitokomennot (wp-pull-production-*, wp-watch, wp-test) sekä vianmääritys- ja profilointityökalut kuin tuotantoympäristökin.

Koska kaikki Seravon projektit noudattavat yhtenäistä hakemistorakennetta (Seravo/wordpress-projektipohja), voit noutaa kopion olemassa olevasta tuotantosivustostasi paikalliselle koneellesi muutamalla komennolla.

Näin pääset alkuun

Voit ottaa paikallisen kehitysympäristön käyttöön seuraavassa järjestyksessä:

  1. Asenna Docker ja projektipohja: Seuraa artikkelia Lokaali kehitys Dockerin avulla asentaaksesi Dockerin ja käynnistääksesi ensimmäisen kehityskontin.

  2. Tarkista ympäristön asetukset: Tutustu ohjeeseen Lokaalin ympäristön asetukset, jos haluat mukauttaa projektin verkkotunnusta (config.yml), PHP-versiota tai muita asetuksia.

  3. Nouda sisältö tuotannosta: Jos kehität olemassa olevaa sivustoa, tuo tietokanta, lisäosat ja teemat tuotannosta ohjeen Sivuston noutaminen kehitysympäristöön mukaisesti.

  4. Hyödynnä kehitystyökaluja: Ota käyttöön kontin sisäiset työkalut, kuten WP-CLI, selaimen automaattisesti päivittävä wp-watch sekä Xdebug-profilointi.

Paikalliset osoitteet ja oletuskirjautumistiedot

Uudessa, tyhjässä kehitysympäristössä käytetään oletuksena wordpress.local-verkkotunnusta ja alla olevia tunnuksia. Jos olet määrittänyt projektille oman paikallisen osoitteen (esim. esimerkki.local), korvaa wordpress.local omalla paikallisella osoitteellasi.

Palvelu / Työkalu

Osoite (URL)

Oletustunnukset

Käyttötarkoitus

WordPress ja hallintapaneeli

http://wordpress.local (hallinta: /wp-admin)

Käyttäjä: vagrant, salasana: vagrant

Paikallinen WordPress-asennus ja hallintapaneeli.

Adminer

http://adminer.wordpress.local tai http://wordpress.local/.seravo/adminer

Käyttäjä: vagrant, salasana: vagrant

Selainpohjainen työkalu MariaDB-tietokannan hallintaan.

Mailcatcher

http://mailcatcher.wordpress.local tai http://wordpress.local/.seravo/mailcatcher

Ei kirjautumista

Kaappaa lähetetyt sähköpostit testausta varten.

Webgrind

http://webgrind.wordpress.local tai http://wordpress.local/.seravo/webgrind

Ei kirjautumista

Xdebug-suorituskykyprofiilien tarkastelu.

Browsersync-konsoli

http://browsersync.wordpress.local

Ei kirjautumista

Live-päivitysten hallinta, kun wp-watch on käynnissä.

MariaDB-tietokanta

localhost (kontin sisällä)

vagrant / vagrant tai root / root

Tietokantayhteydet komentoriviltä (wp db cli).

Huomio tuotantokopiosta: Kun noudat tuotantosivuston tietokannan lokaaliin ympäristöön (wp-pull-production-db), paikallinen tietokanta ylikirjoitetaan. Tämän jälkeen oletustunnus vagrant ei ole enää käytössä, vaan hallintapaneeliin kirjaudutaan tuotantosivuston omilla käyttäjätunnuksilla (tai luomalla uusi paikallinen pääkäyttäjä WP-CLI:llä).

Yleisimmät virhetilanteet

  • Osoite [http://wordpress.local](http://wordpress.local) ei avaudu selaimessa: Varmista ensin, että Docker-kontti on käynnissä (docker ps). Tarkista myös, että paikallinen nimipalvelu (dnsmasq) tai työasemasi hosts-tiedosto ohjaa .local-päätteiset osoitteet paikalliseen osoitteeseen 127.0.0.1.

  • Sisäänkirjautuminen vagrant-tunnuksella epäonnistuu tietokannan tuonnin jälkeen: Tuotantotietokannan tuonti korvaa paikalliset käyttäjätilit. Luo uusi paikallinen ylläpitäjä kontin sisällä komennolla wp user create kehittaja [email protected] --role=administrator --user_pass=salasana.

  • Docker-kontti ei käynnisty porttivarauksen vuoksi (port is already allocated): Työasemallasi on käynnissä toinen paikallinen palvelin (kuten paikallinen nginx, Apache tai toisen projektin Docker-kontti), joka varaa portit 80 tai 443. Pysäytä muut paikalliset palvelimet ennen kontin käynnistämistä.

  • Sivusto ohjaa paikallisen osoitteen tuotantosivustolle: Tarkista, että projektin config.yml-tiedostossa paikallinen osoite on määritetty oikein ja aja tarvittaessa osoitteiden korvaus paikallisessa ympäristössä komennolla wp search-replace 'https://tuotanto-osoite.fi' 'http://wordpress.local'.

Katso myös

Tuotantoympäristöä vastaava paikallinen kehityskontti tekee muutosten testaamisesta nopeaa ja turvallista ennen tuotantoon vientiä. Mikäli tarvitset apua paikallisen kehitysympäristön käyttöönotossa tai sivuston noutamisessa konttiin, asiakaspalvelumme auttaa osoitteessa [email protected].

Vastasiko tämä kysymykseesi?