CruiseControl.NET a gyakorlatban: Telepítés

Előző bejegyzésemben méltattam egy kicsit a CC.NET -et, de ideje, hogy a gyakorlati hasznát is megmutassam.

Kezdjük tehát a telepítéssel!

A telepítő csomagot a SourceForge oldalról lehet letölteni, az aktuális verzió 1.8.3.0.

http://sourceforge.net/projects/ccnet/files/

A forráskóda is letölthető innen:

https://github.com/ccnet/CruiseControl.NET

A letöltést követően a telepítő készletet elindítva elolvashatjuk a bevezető szöveget, majd el kell fogadnunk a CC.NET licencét.

Ha elfogadtuk, három komponenst tudunk telepíteni (mind a hármat érdemes!):

1. CrusieControl.NET szerver alkalmazás: Ez a konkrét működést végző program
2. Web Dashboard: Böngészőn keresztül is lehetőség van a build folyamatok menedzselésére, ehhez ad segítséget ez az alkalmazás
3. Minták: Néhány minta a használathoz

A következő lapon két beállítást konfigurálhatunk:

1. Telepítse a CC.NET szervert szervizként?  Ha igen, akkor a Windows szerviz alkalmazásai között meg fog jelenni, és felhasználói beavatkozás nélkül fog futni. Javasolt a beállítása!
2. Hozzon létre virtuális könyvtárat az IIS -en belül a DashBoard -nak? Ha telepítve van IIS, akkor javasolt! Én Apache Web szervert használok, így nekem erre nem volt szükségem!

A következő lapon kiválaszthatjuk a telepítési könyvtárat, majd a program csoportot. Ha mindent jól csináltunk, akkor fél perc múlva már egy majdnem működő CC.NET lesz a gépünkön.

De mégsem!

Ugyanis ahhoz, hogy működjön, még szükséges a CC.NET konfigurációs állományainak szerkesztése!

A konfigurációs fájlt a következő könyvtárak egyikében találjuk meg:

„C:\Program Files (x86)\CruiseControl.NET\server\” 

vagy

„C:\Program Files\CruiseControl.NET\server\” 

A helyes működéshez három fájlt kell szerkesztenünk:

• ccnet.config: Ez a build folyamatokért felelős állomány!
• ccnet.exe.config: Ezzel tudjuk a parancssori CC.NET paramétereit beállítani.
• ccservice.exe.config: Ezzel tudjuk a szerviz alkalmazásként futó CC.NET paramétereit beállítani.

Én a ccnet.exe.config beállításaival kezdtem. Ahhoz, hogy a teljes build folyamatot tesztelni tudjuk, érdemes először a parancssorból futtatni, és figyelni az üzeneteket. Ha már minden rendben van, és az elvárt működés szerint megy a build, át lehet váltani a szerviz alkalmazásra! 🙂

A beállítások főbb szekciói:

1. Séma fájlok és helyük
2. Naplózási beállítások
3. Szerver működésének beállításai
4. Általános beállítások
5. Remoting beállítások

A séma fájlokat akkor érdemes módosítani, hogyha egyedi, céges riportokat szeretnénk kapni a build folyamatokról. Én személy szerint megelégedtem az általuk készített verzióval! 🙂

A naplózási beállítások már érdekesebbek, de mivel mi szeretnénk mindent látni, ezért a szintet (log4net/level/name=”TRACE”) nem bántottam. Ha kevesebbet szeretnénk látni, akkor a DEBUG vagy az INFO -t érdemes bekapcsolni.

A szerver működését befolyásoló beállításoknál alapesetben nincs semmi, ezt majd a ccnet.config -ban fogjuk bővíteni!

Az általános beállításoknál (appSetting) érdemes a naplózó fájlok helyét beállítani (ServerLogfilePath),  illetve a beépülő modulok útvonalát (PluginLocation).

A Remoting beállításnál tudjuk azt a portot és protokollt beállítani, amivel a későbbiek során a DashBoard és a CCNET Tray alkalmazás kommunikálni fog egymással. Ezt a <channel> node ref és  port attribútumaival tehetjük meg.

alapesetben TCP kommunikációval és a 21234 -es porton keresztül küldi az üzeneteket. Érdemes ezt a beállítást úgy hagyni, ahogy van, mert a legtöbb kiegészítő program ezen a porton keresztül próbál kommunikálni vele.

Ha ezeket a beállításokat végig vittük, ki is próbálhatjuk a működést a ccnet.exe elindításával.