Version seuranta Subversionilla (SVN) aloittelijoille
Oletko koskaan halunnut työskennellä projektissa, jonka avulla voit seurata muutoksiasi ja palauttaa ne? How-To Geek selittää How-To käyttää suosittua version seurantajärjestelmää Subversion (a.k.a SVN).
Kuva selkeästi epäselvä
Prelog
Tämän oppaan tarkoituksena on antaa sinulle mahdollisuus käyttää subversion-asiakasta yleensä, ja jos sinulla on sellainen, * DD-WRT-reitittimessä. Tämä opas ei ole mitenkään lopullinen opas Subversionille ja paljon tietoa löytyy Subversionin punaisesta kirjasta. Tämän oppaan tarkoituksena on antaa sinulle vain lyhyt vastaus kysymyksiin.
Yleiskatsaus
Voisi olla useita syitä, miksi haluat ”checkout” uusimman version ohjelmistoprojektista, joka käyttää versiointijärjestelmää. Näin voit hyödyntää uusimpia vielä julkaisemattomia muutoksia, auttaa testauksessa ja jopa kehityksessä. Tässä oppaassa käymme läpi joitakin perustietoja SVN-terminologiasta, näytämme, miten SVN-asiakas asennetaan Linuxiin, Windowsiin ja jos sinulla on yksi OPKG: n käytössä oleva DD-WRT-reititin. Olemme myös sisällyttäneet esimerkin projektista, jonka voit noutaa ja käyttää mainittuun reitittimeen.
Mikä on Subversion?
Subversion ei ole mitenkään ainoa olemassa oleva versionhallintajärjestelmä, ja vaihtoehtoja ovat Git (jonka Linus Torvalds on luonut Linux-ytimen perustaja), Mercurial ja PerForce muutamia. Sen mukaan se on yksi vapaista, se on kypsä ja sitä käytetään laajasti maailmanlaajuisesti.
Subversionista “Punainen kirja”:
Subversion on vapaa / avoin lähde versionhallintajärjestelmä (VCS). Toisin sanoen Subversion hallitsee tiedostoja ja hakemistoja sekä niihin tehtyjä muutoksia ajan mittaan. Näin voit palauttaa aiemmat tietosi versiot tai tutkia tietojen muuttumisen historiaa. Tässä suhteessa monet ajattelevat versionhallintajärjestelmää eräänlaisena "aikakoneena".
Huomaa: Tämä kirja on lopullinen tiedonkeruu subversionista ja sinun kannattaa viitata siihen kaikissa Subversioniin liittyvissä aiheissa.
Mikä on versiointi?
Versio on prosessi, jossa projektin tila ajankohtana tallennetaan. Tällaista menettelyä käytetään usein ohjelmistokehityksen hallintaan, jotta työ voi edelleen parantaa projektia tai lisätä ominaisuuksia, mutta pystyy seuraamaan sitä, mikä on muuttunut viimeisestä "tallennuspisteestä". Tämäntyyppinen menettely voi olla hyödyllinen yksittäiselle henkilölle, mutta vielä useammalle ihmisryhmälle, joka työskentelee saman projektin parissa. Tämä johtuu siitä, että työskennellessäsi projektina ryhmänä on yleensä vastuunjako ja eri ihmiset muuttavat hankkeen eri näkökohtia. Ilman versiointimekanismia olisi erittäin vaikeaa pitää kaikki synkronoituna uusimpien kaikkien tekemien muutosten yhteydessä.
Terminologia
Varasto
Arkisto on paikka, jossa kaikki eri paikkojen tiedot tallennetaan. Subversion-maailmassa asiakkaan näkökulmasta se on palvelin, joka pitää projektin tietokannan. Tämä tietokanta sisältää kaikki tiedostot, jotka ovat osa projektia kaikkien niiden aiempien versioiden kanssa.
tarkistus
Kun arkisto on luotu, sille annetaan nolla (0). Tätä määrää lisätään yhdellä (1) joka kerta, kun tehdään sitoumus. Muutosnumero on arkistoon maailmanlaajuinen. Toisin sanoen, yksittäisessä tiedostossa ei ole yksittäistä tarkistusnumeroa arkistossa, vaikka mikään ei muuttunut kyseisessä tiedostossa kyseiselle tietylle tapahtumalle.
Työkopio
Työkopio on tietyn version paikallinen kopio (tai ”kassalle”). Yleensä tämä versio, joka on kirjautunut ulos, on "uusin" (kutsutaan myös "pääksi"), mutta edellistä voidaan pyytää. Käyttäjä voi tehdä paikallisen kopion, mitä hän haluaa, tietäen, että pahimmillaan he voisivat vain tarkistaa koodin uudelleen. Lisäksi tämä kopio on "yksityinen". Tämä johtuu siitä, että ennen kuin päivität tai annat kopion, et näe muiden ihmisten muutoksia eikä näe omasi.
Päivittäminen ja konfliktien ratkaiseminen
Paikallista työkopiota voidaan päivittää. Toisin sanoen, jos "tarkistat" tietyn version, ja työskennellessäsi arkiston versio on päivitetty, voit päivittää työsi kopion viimeistään. Itse asiassa palvelin estää sinua tekemästä muutoksia ennen kuin päivität uusimpaan versioon vastaamaan arkistoa. Tämä tehdään niin, että pakotetaan sinua ratkaisemaan konflikteja paikallisesti ennen kuin edes ajattelet tehdä muutoksia arkistoon.
sulautuvan
Yhdistäminen tarkoittaa prosessia, jossa muutettu koodi sekoitetaan yhteen versioon. Se voi myös johtaa konfliktien ratkaisemiseen.
sitoutuu
Sitoutuminen on prosessi, jossa paikalliseen kopioon tekemäsi muutokset yhdistetään takaisin arkistoon. Tämä on prosessin kaikkein vaarallisin osa, sillä juuri tekemäsi muutokset saattavat vaikuttaa muihin henkilöihin, jotka käyttävät samaa arkistoa. Siksi tämä tehdään yleensä jonkin verran harkinnan jälkeen, ryhmän yksimielisyydellä ja sen jälkeen, kun olet ratkaissut kaikki sulautuvat konfliktit.
Työnkulku
Tärkein työnkulku käyttäjän näkökulmasta subversionin käyttämisessä on:
1. Tarkista nykyinen koodi (yleensä “pää”).
2. Tee muutoksia, lisää tiedostoja ja kehitä koodi yleensä.
3. Päivitä uusimpaan versioon varmistaaksesi, että paikallinen kopio on synkronoitu arkiston päivitysten kanssa.
4. Yhdistä ja ratkaise paikallisesti konflikteja tarvittaessa.
5. Kytke sulautetut muutokset arkistoon.
6. Siirry vaiheeseen 2.
Saat halkeamia
Asenna asiakas
Jotta voisit käyttää subversionia, sinun on asennettava asiakas koneellesi.
Linuxissa
Sinun tarvitsee vain asentaa paketti. Ubuntu / Mintissa tämä tapahtuu seuraavilla tavoilla:
sudo aptitude install subversion
DD-WRT: ssä
Jos olet noudattanut ”Lisäohjelmiston asentaminen kotireitittimeen (DD-WRT)”, voit asentaa svn-asiakkaan yksinkertaisesti antamalla:
opkg-päivitys; opkg asentaa subversion-client
Windowsissa
Vaikka syviä geek-käyttäjiä voi alkaa unohtaa, että GUI on jopa ajoittain olemassa, ei kaikilla ole. Jos haluat käyttää Windows-asiakasta yhdistämään SVN-arkistoon, suosituin on "Kilpikonna". Jos haluat käyttää sitä, lataa ohjelma ja asenna se tavalliseen “seuraava, seuraava, viimeistely” -muotoon.
Luo ”arkisto”
Vaikka emme mene paljon yksityiskohtiin siitä, miten subversion-palvelin voidaan määrittää tässä oppaassa, Google-vaihtoehto ei ole huono alku aloittelijalle. Google-arkiston luominen:
- Siirry Google Code -sivuston web-sivustoon ja luo uusi projekti.
- Täytä seuraavalla sivulla vaaditut kentät ja valitse "versionhallintajärjestelmän" tyyppi, joka on subversion.
Huomautus: Saatat haluta tarkistaa, mitä eroa Google tarjoaa, ennen kuin valitset projektin. - Valitse Luo projekti.
Kun projekti on luotu, sinun pitäisi pystyä löytämään ohjeet siitä, miten pääset käsiksi ”Lähde” -välilehdellä.
Mukava asia Google-koodista on se, että se mahdollistaa nimettömän lukukelpoisen version projektille. Jos et halua käsitellä oman hankkeen luomiseen liittyvää vaivaa, voit kirjautua nimettömästi tämän kirjailijan arkistoon.
Yksi muistiinpano hotfortech-projektista: Tämä projekti on tarkoitettu kääreiksi ominaisuuksille, jotka on lisätty DD-WRT: ään How-To Geek -ohjelmaan (jota käytän henkilökohtaisesti) sekä joitakin henkilökohtaisia tweaksia. Vaikka tämä projekti on suunnattu toimimaan yhdessä Howtogeekissä julkaistujen artikkeleiden kanssa, se on edelleen yksityinen projekti. Tämä tarkoittaa sitä, että se sopii erinomaisesti Buffalo-reitittimeen (AR71xx-arkkitehtuuri), henkilökohtaisiin uhkiini ja on altis satunnaiselle borkage.
Linux / DD-WRT
Luo hakemisto, joka toimii esimerkiksi DD-WRT: ssä, joka voisi olla:
mkdir -p / jffs / svn; cd / jffs / svn
Täysi komento Linuxissa koostuu itse SVN-komennosta, ”checkout” -direktiivistä, arkiston osoitteesta ja hakemistosta myös kassalle. Luo tyhjä hakemisto ja suorita alla oleva komento:
svn checkout http://hotfortech-dd-wrt.googlecode.com/svn/trunk/ hotfortech-dd-wrt-only-only
Huomaa, että edellä olevassa esimerkissä vain luku -versio tarkistetaan. Jos päätit luoda oman arkistosi, sinun on käytettävä httpS-linkkiä.
Windowsissa
Koska kilpikonna on kuoren laajennus, sinun on käytettävä Windowsin tiedostojen etsintäyhteysvalikkoa (napsauta hiiren kakkospainiketta). Itse asiassa, jos yrität käyttää sitä aloitusvalikosta, saat:
- Luo tyhjä hakemisto.
- Napsauta sitä hiiren kakkospainikkeella avataksesi kontekstivalikon.
- Valitse ”SVN Checkout”:
- Kopioi ja liitä projektin linkki (jos sellainen on) URL-osoitteeseen:
- Hankkeen koosta riippuen tämä voi kestää jonkin aikaa, mutta kun "Checkout" on suoritettu, sinun pitäisi nähdä jotain seuraavista:
- Voit aloittaa kehittämisen.
”Päivitä” ja ”Yhdistä” työsi kopio
Jos käytät koodia kollegojesi kanssa tai olet itse päivittänyt koodia useista paikoista (eli kannettavasta tietokoneesta, työpöydästä tai jopa reitittimestä), sinun on päivitettävä työkopiosi ennen viimeisten muutosten tekemistä.
Linux / DD-WRT
Tämä komento näissä POSIX-järjestelmissä on yksinkertaisesti:
svn ylös
Windowsissa
- Napsauta hiiren kakkospainikkeella työhakemistossa ja valitse ”SVN-päivitys”:
- Jos kohtaat ristiriitoja, yritä noudattaa näytön ohjeita ja käytä arviointiasi sen suhteen, mitä heidän kanssaan on tehtävä.
”Kohdista” muutokset
Näin on, sinun pitäisi olla konfliktivapaa ja valmis päivittämään arkisto muutoksillasi.
Tässä on huomautettava, että on yleinen käytäntö lisätä "log" -viesti sitoumukseen, jotta se voi helposti muistaa, miksi muutokset tehtiin. Itse asiassa Googlen arkisto tekee siitä pakollisen ennakkoedellytyksen.
Linux / DD-WRT
Tämä on esimerkki sitoumuksesta, jonka olen tehnyt hotfortech-hankkeeseen, joka on nostanut sen versioon 19:
svn saistības -m “päivitetty vastaamaan uutta ant-ads-paketin linkkiä”
Windowsissa
- Napsauta hiiren kakkospainikkeella työhakemistoa ja valitse ”SVN Commit”:
- Sinun pitäisi olla tervetullut ikkunasta, jonka avulla voit merkitä lokiviestin:
- Anna OK: lle ja kysy salasanaa, anna Googlelle luotu salasana.
- Jos sitoumus onnistui, sinun pitäisi nähdä jotain seuraavaa:
- Se on se, sinun pitäisi pystyä sitoutumaan kuin BOSS.
Loppuhuomautukset
Tämän pitäisi riittää, jotta pääset alkuun. Sinun kannattaa lukea SVN-viitekirja, jotta saat syvemmän ja paremmin käsityksen kaikista SVN: n käyttötavoista, vaihtoehdoista ja varoituksista. Lisäksi muistutamme teitä (jälleen), että subversion ei ole ainoa versiohallintajärjestelmä, ja GIT (jonka Linus Torvalds loi Linux-ytimen perustaja) näyttää saavan suosion viime vuosina.
Jos valitset "run-config.sh": n suorittamisen reitittimesi hotfortech-projektista, huomaat, että se asennetaan nykyisin sinulle: mainospaketti, Opkg geek-init -skripti sekä asioita, kuten täysi GNU "ls", "vähemmän", "BASH" ja paljon muuta.
/jffs/svn/hotfortech-dd-wrt/running-conf.sh
Enemmän ominaisuuksia on odotettavissa ja niitä lisätään tulevaisuudessa.
Järjestelmänvalvojat koodittavat tiensä ulos koodauksesta.
