Polkupyöräwiki:Tekniikka
Polkupyöräwiki
Polkupyöräwiki > Tietoa Polkupyöräwikistä > Tekniikka
Tällä sivulla kerrotaan Polkupyöräwikissä käytetystä tekniikasta sekä tietoa siitä, kuinka Polkupyöräwikin tekniseen kehitykseen voi halutessaan osallistua. Vaikka wikin sisällön kehittäminen onkin tärkeintä, ei teknisestä avusta ole koskaan haittaa.
Sisällysluettelo |
[muokkaa] Wikin ohjelmisto ja tekniikat
Polkupyöräwiki pohjautuu PHP-kielellä rakennettuun MediaWiki-ohjelmistoon. Vaikka MediaWiki onkin suurilta osin hyvin valmis paketti yhteisölliseen kirjoittamiseen, vaatii Polkupyöräwikin ylläpitäminen kuitenkin muutoksia wikin ohjelmistoon. Polkupyöräwikiä varten on täytynyt mm. tehdä asetusmuutoksia, asentaa tarvittavia lisäosia sekä viilata wikin ulkoasua. Kehitys on jatkuvaa ja wikin ohjelmistoa muutetaan aina tarpeen tullen. Kehityksessä on hyötyä hallita seuraavat tekniikat: PHP, XHTML, CSS, JavaScript ja SQL.
[muokkaa] Palvelin ja palvelinkulut
Polkupyöräwikin tuotantoversiota ajetaan Sigmaticin jaetussa webhotelissa. Käytössä oleva palvelu on Sigmaticin Advanced-webhotelli, jossa on 2 Gt palvelintilaa ja liikennesuositus 20 Gt / kk. Hinta on 102 € / vuosi, mutta Sigmatic sponsoroi tämän PolkupyöräWikille. Domain-osoitteen (polkupyoraily.net) ylläpidosta vastaa niin ikään Sigmatic. Verkkotunnuksen hinta PolkupyöräWikille on 15 € / vuosi, joka pyritään rahoittamaan sivuilla olevilla mainoksilla.
[muokkaa] Tuotanto- ja kehitysversiot
Polkupyöräwiki jakautuu käytännössä kahteen eri versioon: tuotanto ja kehitys. Tuotantoversiolla tarkoitetaan sitä versiota wikistä, joka on käytössä osoitteessa http://www.polkupyoraily.net/. Kehitysversiolla taas tarkoitetaan tuoreinta versiota SVN-versionhallinnassa. Tuotanto- ja kehitysversiot poikkeavat hieman toisistaan. Niiden lähdekoodit voivat poiketa toisistaan, jos kehitysversiota ei ole päivitetty tuotantoon. Lisäksi kehitysversiossa ei ole tallennettuna kaikkia wikiin ladattuja kuvia ja siinä käytetään erillistä testitietokantaa (kaikkien sivujen ja kuvien olemassaolo kehitysversiossa ei ole tarpeen).
[muokkaa] Varmuuskopiointi
Wikin muuttuneet tiedostot varmuuskopioidaan automaattisesti joka päivä keskiyöllä (mm. kuvat ja muut käyttäjien tallentamat tiedostot). Lisäksi joka kuun alussa otetaan automaattisesti täydellinen varmuuskopio wikin kaikista tiedostoista. Muuttuneiden tiedostojen varmuuskopioita säilytetään Sigmaticin palvelimella viimeiseen täydelliseen varmuuskopioon asti. Täydellisistä varmuuskopioista palvelimella säilytetään viimeisin. Muuttuneiden tiedostojen varmuuskopiot lähetetään joka päivä toiselle eri palveluntarjoajan FTP-palvelimelle (Wippies G-Lite), jossa näitä varmuuskopioita säilytetään kuluvan ja edellisen kuukauden ajalta. Täydelliset varmuuskopiot lähetetään joka kuun alussa niin ikään Wippieksen FTP-palvelimelle, jossa säilytetään viimeisen ja sitä edellinen täydellinen varmuuskopio.
Tietokanta varmuuskopioidaan myös automaattisesti joka päivä keskiyöllä. Tietokannan varmuuskopioita säilytetään 7 viimeisen päivän osalta Sigmaticin palvelimella (eri palvelin kuin itse tietokantapalvelin). Tämän lisäksi tietokanta varmuuskopioidaan joka maanantai Wippieksen FTP-palvelimelle, jossa viikoittaisia varmuuskopiota säilytetään kuluvan ja edellisen kuukauden ajalta.
Niin tiedostojen kuin tietokannan varmuuskopiot ovat vahvasti salattuja siirron ja säilytyksen ajan. Tiedostot ja tietokanta voidaan siis aina palauttaa mihin tahansa tilaan edellisestä päivästä aina vähintään kuukauden takaiseen tilaan. Palvelimen hajoaminen ja tiedostojen sekä tietokannan täydellinen tuhoutuminen palvelimilta eivät myöskään hävitä kokonaan arvokasta tietoa. Automaattisten varmuuskopioiden lisäksi varmuuskopioita otetaan epäsäännöllisesti manuaalisesti, jolloin varmuuskopiot tallennetaan USB-kovalevylle.
[muokkaa] Wikin lähdekoodit ja kehitys
Polkupyöräwikin kehitysversion lähdekoodit löytyvät SVN-versionhallinnasta, jota ylläpidetään Assembla-palvelussa. Lähdekoodeja voi selata joko selaimen avulla tai käyttämällä SVN-asiakasohjelmaa, jolloin SVN-palvelimen osoite on http://svn.assembla.com/svn/ppwiki. Versionhallinnasta ladatut lähdekoodit vievät yhteensä hieman yli 120 Mt. Lähdekoodien lukemiseen tarvitaan kummassakin tapauksessa käyttäjätunnus Assemblaan (rekisteröityminen on ilmaista). Kuka tahansa Assemblaan rekisteröitynyt voi lukea wikin lähdekoodeja.
Muutoksia lähdekoodiin (commitointi) voi tehdä vain kehityksestä vastaavan ylläpidon hyväksymät käyttäjät. Muutokset lähdekoodiin tapahtuvat aina lähettämällä muutokset edellä mainittuun SVN-palvelimeen. Tuoreimmat lähdekoodiin tehdyt muutokset ovat nähtävillä Trac-työkalun kautta, jonka käyttö vaatii niin ikään käyttäjätunnuksen Assemblaan. Versionhallintaan tallennetut muutokset eivät välittömästi päivity tuotantoon vaan ylläpito testaa ensin muutokset ja käy suorittamassa päivityksen tuotantoon manuaalisesti.
Jos siis haluat osallistua wikin tekniseen kehitykseen, rekisteröidy ensin Assemblaan ja ota yhteyttä ylläpitoon saadaksesi oikeudet tehdä muutoksia koodiin. Koska lähdekoodit ovat julkisesti kaikkien nähtävillä, ÄLÄ koskaan lisää versionhallintaan arkaluontoista tietoa kuten tärkeitä salasanoja.
[muokkaa] Kehityksessä tarvittavat ohjelmistot
Polkupyöräwikiä voi kehittää ja kokeilla paikallisesti omalla koneellaan, kunhan vaadittavat ohjelmistot on asennettu ja tarvittavat asetukset muutettu. Apuja kehitysversion käyttöönottoon voi tarvittaessa kysellä tämän sivun keskustelusivulla.
Kehitysversion ohjelmistovaatimukset:
- Apache-palvelin
- PHP5-tulkki
- MySQL-tietokanta
- SVN-asiakasohjelma
- Tekstieditori
Helpointa on asentaa seuraavat ohjelmistot:
- Eclipse (kehitysympäristö, lue asennusohjeet)
- Windowsille WAMP (Apache+MySQL+PHP) ja Linuxille XAMPP (Apache+MySQL+PHP+Perl).
Kehitysympäristönä voi käyttää mitä tahansa haluamaansa kehitysympäristöä (kuten NetBeans), mutta Eclipsen käyttö on suositeltavaa. Eclipseen kannattaa perusasennuksen lisäksi asentaa Subclipse-lisäosa SVN-asiakasohjelmaa varten sekä vaadittavat lisäosat PHP-kielen tukea varten.
Sponsoroidut linkit:
