{"id":2032,"date":"2018-04-11T16:58:19","date_gmt":"2018-04-11T14:58:19","guid":{"rendered":"http:\/\/miroslaw.borodziuk.eu\/?p=2032"},"modified":"2018-05-18T09:33:41","modified_gmt":"2018-05-18T07:33:41","slug":"a","status":"publish","type":"post","link":"http:\/\/miro.borodziuk.eu\/index.php\/2018\/04\/11\/a\/","title":{"rendered":"CI\/CD projekt\u00f3w PHP na Jenkinsie \u2013 Automatyzacja"},"content":{"rendered":"

Mimo, \u017ce PHP jest j\u0119zykiem interpretowanym a kod PHP nie wymaga kompilacji, to developerzy przeprowadzaj\u0105 np. generacj\u0119 lub transformacj\u0119 kodu autoloadera. Doskona\u0142ym narz\u0119dziem s\u0142u\u017c\u0105cym do zautomatyzowania procesu budowy oprogramowania jest Apache Ant<\/em><\/a>. To co r\u00f3\u017cni Ant<\/em> i np.\u00a0 znany z Linuksa Make<\/em> jest to, \u017ce Ant<\/em> u\u017cywa plik\u00f3w w formacie XML<\/a> do opisu procesu budowy i jego zale\u017cno\u015bci, podczas gdy Make<\/em> ma w\u0142asny format Makefile<\/em>. Projekt Ant<\/em> jest w zwi\u0105zku z tym przeno\u015bny, Make<\/em> nie. Domy\u015blnie plik XML\u00a0 w Ant<\/em> nazywa si\u0119 build.xml.<\/code><\/p>\n

<\/p>\n

Rozwa\u017cmy nast\u0119puj\u0105cy projekt umieszczony w katalogu \/root<\/code>:<\/p>\n

.\r\n\u251c\u2500\u2500 build\r\n\u2502   \u251c\u2500\u2500 phpcs.xml\r\n\u2502   \u251c\u2500\u2500 phpmd.xml\r\n\u2502   \u251c\u2500\u2500 src_autoload.php.in\r\n\u2502   \u2514\u2500\u2500 tests_autoload.php.in\r\n\u251c\u2500\u2500 build.xml\r\n\u251c\u2500\u2500 phpunit.xml.dist\r\n\u251c\u2500\u2500 src\r\n\u2502   \u2514\u2500\u2500 autoload.php\r\n\u2514\u2500\u2500 tests\r\n\u2514\u2500\u2500 autoload.php<\/pre>\n
Katalog build zawiera pliki konfiguracyjne XML dla PHP_CodeSniffer (phpcs.xml), PHPMD (phpmd.xml). PHP_CodeSniffer i PHPMD to narz\u0119dzia do statycznej analizy kodu PHP, kt\u00f3rym przyjrzymy si\u0119 bli\u017cej w kolejnym artykule o Jenkinsie i PHP, dotycz\u0105cym tzw. Continous Inspection (ci\u0105g\u0142ej inspekcji). Plik phpunit.xml (lub phpunit.xml.dist) to plik konfiguracyjny projektu PHPUnit. Pliki src\/autoload.php, tests\/autoload.php zawieraj\u0105 kod autoloadera dla aplikacji i zestaw test\u00f3w.<\/p>\n
Plik Ant<\/em> bulid.xml definiuje tzw. targety czyli cele (zestawy zada\u0144), kt\u00f3re maj\u0105 zosta\u0107 wykonane. Podczas uruchamiania Ant<\/em> istnieje mo\u017cliwo\u015b\u0107 wybrania, kt\u00f3re targety maj\u0105 zosta\u0107 uruchomione. Je\u017celi nie jest podany \u017caden target to wykonywany jest domy\u015blny projekt. Ka\u017cdy target mo\u017ce zale\u017ce\u0107 od innego targetu, Ant<\/em> rozpoznaje zale\u017cno\u015bci. Zadanie to kod (np. skrypt), kt\u00f3ry ma by\u0107 wykonany.<\/p>\n
 <\/p>\n
Poni\u017cszy tekst pochodzi z tej strony<\/a> i jest nieco przeze mnie zmodyfikowany. Umieszczam tutaj ten tekst gdy\u017c stanowi on bardzo dobre wprowadzenie do Apache Ant<\/em>.<\/p>\n
Wst\u0119p<\/span><\/p>\n
Apache Ant<\/em> jest narz\u0119dziem wspomagaj\u0105cym i automatyzuj\u0105cym proces kompilacji. Umo\u017cliwia definiowanie skrypt\u00f3w za pomoc\u0105 j\u0119zyka XML, kt\u00f3re to skrypty wykonuj\u0105 zadania. Cytuj\u0105c dokumentacj\u0119:<\/p>\n
Apache Ant is a Java-based build tool. In theory, it is kind of like make, without make’s wrinkles.<\/p><\/blockquote>\n
Mo\u017cna zatem za\u0142o\u017cy\u0107, \u017ce Ant<\/em> powinien by\u0107 pierwszym narz\u0119dziem jakie b\u0119dzie nam s\u0142u\u017cy\u0107 w trakcie kompilowania naszych program\u00f3w.
\nStrona domowa projektu: http:\/\/ant.apache.org<\/a><\/p>\n
 <\/p>\n
Struktura projektu<\/span><\/p>\n
Ant jest narz\u0119dziem wymagaj\u0105cym stosunkowo prostej struktury projektu. Po \u015bci\u0105gni\u0119ciu go ze strony nale\u017cy skonfigurowa\u0107 zmienn\u0105 ANT_HOME<\/code> tak by wskazywa\u0142a na katalog w kt\u00f3rym zainstalowano anta<\/em>, oraz do zmiennej PATH<\/code> doda\u0107 \u015bcie\u017ck\u0119 $ANT_HOME\/bin<\/code> (w windowsie: %ANT_HOME%\/bin). Nast\u0119pnie sprawdzamy czy wszystko jest prawid\u0142owo skonfigurowane:<\/p>\n
$ ant\r\nBuildfile: build.xml does not exist!\r\nBuild failed<\/pre>\n
Jak wida\u0107 by utworzy\u0107 projekt wystarczy w katalogu umie\u015bci\u0107 plik build.xml<\/code>. Jest to plik XML w kt\u00f3rym definiujemy w\u0142a\u015bciwo\u015bci projektu. Najprostsza jego wersja wygl\u0105da tak:<\/p>\n
<?xml version=\"1.0\" encoding=\"iso-8859-2\"?>\r\n<project name=\"Project name\" basedir=\".\" default=\"clean\">\r\n<!-- -->\r\n<\/project><\/pre>\n
Gdzie:<\/p>\n
name<\/code> – nazwa projektu, kt\u00f3ra nie jest obowi\u0105zkowa.
\nbasedir<\/code> – \u015bcie\u017cka bazowa od kt\u00f3rej s\u0105 liczone wszystkie \u015bcie\u017cki wzgl\u0119dne. Te\u017c nieobowi\u0105zkowe, ale domy\u015blnie jest to \u015bcie\u017cka do folderu z plikiem build.xml<\/code>.
\ndefault<\/code> – domy\u015blne zadanie, kt\u00f3re b\u0119dzie wykonane je\u017celi nie podamy zada\u0144 do wykonania. Od wersji 1.6 biblioteki, ka\u017cdy projekt posiada domy\u015blnie skonfigurowane wszystkie zadania dostarczone razem z bibliotek\u0105.<\/p>\n
Jak zatem \u0142atwo zauwa\u017cy\u0107, ant<\/em> pozwala na bardzo swobodn\u0105 konfiguracj\u0119 projektu. Niestety w starszych wersjach biblioteki brak konfiguracji domy\u015blniej wymusza\u0142 tworzenie du\u017cej ilo\u015bci “domy\u015blnego” kodu. Obecnie nie jest to konieczne, ale cz\u0119sto trzeba si\u0119 napisa\u0107 by odpowiednio skonfigurowa\u0107 projekt. Do prawid\u0142owego dzia\u0142ania wystarczy JDK w wersji 1.2, ale producenci rekomenduj\u0105 u\u017cycie JDK w wersji 1.5.<\/p>\n
 <\/p>\n
Cele i zadania<\/span><\/p>\n
Projekt w Ant<\/em> jest podzielony na cele (target), kt\u00f3re zawieraj\u0105 zadania (task). Cele definiujemy sami, a zadania s\u0105 dostarczone wraz z bibliotek\u0105, ale mo\u017cna i samemu stworzy\u0107 zadanie poprzez rozszerzenie klasy Task.<\/p>\n
 <\/p>\n
Target – cel<\/span><\/p>\n
Cel jest logicznym krokiem w procesie kompilacji. Sk\u0142ada si\u0119 z zada\u0144 i opisuje jaki\u015b etap projektu. Przyk\u0142adem celu mo\u017ce by\u0107 kompilacja, umieszczenie na serwerze, wykonanie test\u00f3w czy te\u017c synchronizacja z SVN. W naszym projekcie przygotujemy wszystko od podstaw wykorzystuj\u0105c cele i zadania. Stw\u00f3rzmy wi\u0119c katalog z plikiem build.xml<\/code> i dodajmy pierwsze zadanie:<\/p>\n
<?xml version=\"1.0\" encoding=\"iso-8859-2\"?>\r\n<project name=\"Project name\" basedir=\".\" default=\"create\">\r\n<description>Tutorial ANT na http;\/\/4programmers.net\/java\/Ant<\/description>\r\n\r\n<!-- =================================\r\ntarget: create\r\n================================= -->\r\n<target name=\"create\" depends=\"\" description=\"Tworzy struktur\u0119 projektu\">\r\n\r\n<\/target>\r\n<\/project><\/pre>\n
Cel posiada obowi\u0105zkow\u0105 nazw\u0119 i opcjonalny opis. Mo\u017ce te\u017c zale\u017ce\u0107 od innych cel\u00f3w np. tworzenie archiwum jar zazwyczaj musi by\u0107 wykonane po skompilowaniu kodu. Zale\u017cno\u015bci definiujemy za pomoc\u0105 atrybutu depends<\/code> w kt\u00f3rym poddajemy nazwy zale\u017cnych celi rozdzielone przecinkiem.
\nDodajmy do naszego celu kilka zada\u0144, kt\u00f3re b\u0119d\u0105 nam tworzy\u0107 struktur\u0119 projektu.<\/p>\n
 <\/p>\n
Task – zadanie<\/span><\/p>\n
Zadanie jest pojedyncz\u0105 operacj\u0105 wykonywan\u0105 by osi\u0105gn\u0105\u0107 cel. Mo\u017ce by\u0107 to na przyk\u0142ad stworzenie katalogu, wywo\u0142anie kompilatora lub wypisanie czego\u015b w konsoli. Ilo\u015b\u0107 zada\u0144 w ancie<\/em> jest ogromna. Biblioteka posiada oko\u0142o 70 wbudowanych zada\u0144, a istnieje jeszcze mo\u017cliwo\u015b\u0107 \u015bci\u0105gni\u0119cia dodatkowy bibliotek jak i stworzenia w\u0142asnego rozwi\u0105zania.
\nKa\u017cde zadanie posiada unikaln\u0105 list\u0119 parametr\u00f3w, kt\u00f3re s\u0105 przekazywane jako atrybuty lub tagi XML. Spos\u00f3b konfiguracji jest wi\u0119c do\u015b\u0107 swobodny. Z jednej strony zapewnia to du\u017c\u0105 elastyczno\u015b\u0107, ale z drugiej wymaga cz\u0119stego zagl\u0105dania do dokumentacji w celu sprawdzenia jak skonfigurowa\u0107 taki czy inny cel. Poni\u017cej nasz plik build.xml<\/code> wzbogacony o definicj\u0119 zada\u0144, po wykonaniu kt\u00f3rych zostanie stworzona struktura projektu:<\/p>\n
<?xml version=\"1.0\" encoding=\"iso-8859-2\"?>\r\n<project name=\"Project name\" basedir=\".\" default=\"create\">\r\n<description>Tutorial ANT na http;\/\/4programmers.net\/java\/Ant<\/description>\r\n\r\n<!-- =================================\r\ntarget: create\r\n================================= -->\r\n  <target name=\"create\" depends=\"\" description=\"Tworzy struktur\u0119 projektu\">\r\n    <echo>Tworz\u0119 katalog ze \u017arod\u0142ami<\/echo>\r\n    <mkdir dir=\".\/src\/pl\/koziolekweb\/programmers\/ant\"\/>\r\n    <echo>Tworz\u0119 katalog z testami<\/echo>\r\n    <mkdir dir=\".\/test\/pl\/koziolekweb\/programmers\/ant\"\/>\r\n    <echo>Tworz\u0119 katalog ze skompilowanymi klasami<\/echo>\r\n    <mkdir dir=\".\/bin\/classes\/\"\/>\r\n    <echo>Tworz\u0119 katalog ze skompilowanymi testami<\/echo>\r\n    <mkdir dir=\".\/bin-test\"\/>\r\n  <\/target>\r\n<\/project><\/pre>\n
 <\/p>\n
Przyk\u0142adowe zadania wbudowane<\/span><\/p>\n
W powy\u017cszym przyk\u0142adzie wykorzystali\u015bmy dwa zadania wbudowane. Pierwsze z nich echo pozwala na wypisanie komunikatu na ekranie. Drugie mkdir tworzy katalogi je\u017celi nie istniej\u0105. Zadania wbudowane w wi\u0119kszo\u015bci odpowiadaj\u0105 potrzebom projekt\u00f3w. Do najpopularniejszych nale\u017c\u0105 javac uruchamiaj\u0105ce kompilator, jar tworz\u0105ce archiwum i javadoc s\u0142u\u017c\u0105ce do generowania dokumentacji. Innymi przydatnymi zadaniami s\u0105 copy s\u0142u\u017c\u0105ce do kopiowania plik\u00f3w, delete usuwaj\u0105ce pliki i zip pozwalaj\u0105ce na pakowanie plik\u00f3w.<\/p>\n
 <\/p>\n
Parametryzowanie zada\u0144<\/span><\/p>\n
Nasze zadania zazwyczaj b\u0119d\u0105 wsp\u00f3\u0142dzieli\u0107 niekt\u00f3re informacje. S\u0105 to przede wszystkim dane o \u015bcie\u017ckach z kodem \u017ar\u00f3d\u0142owym, nazwach plik\u00f3w jar\/war\/ear, \u015bcie\u017ckach do bibliotek. Warto trzyma\u0107 je w jednym miejscu i mie\u0107 mo\u017cliwo\u015b\u0107 szybkiej ich edycji. Ant<\/em> udost\u0119pnia dwie metody pozwalaj\u0105ce na osi\u0105gni\u0119cie tego celu. Pierwsz\u0105 z nich jest mo\u017cliwo\u015b\u0107 definiowania zmiennych bezpo\u015brednio w pliku build.xml<\/code>, a drug\u0105 u\u017cycie pliku build.properties<\/code>. W obu przypadkach odwo\u0142anie do warto\u015bci zmienne nast\u0119puje za pomoc\u0105 ${nazwa_zmiennej}<\/code><\/p>\n
 <\/p>\n
Zmienne w pliku build.xml<\/span><\/p>\n
Zmienne mo\u017cemy definiowa\u0107 w pliku build.xml<\/code> za pomoc\u0105 specjalnego elementu <property\/><\/code>. Na przyk\u0142adzie naszego pliku konfiguracyjnego b\u0119dzie to wygl\u0105da\u0107 nast\u0119puj\u0105co:<\/p>\n
<?xml version=\"1.0\" encoding=\"iso-8859-2\"?>\r\n<project name=\"Project name\" basedir=\".\" default=\"create\">\r\n<description>Tutorial ANT na http;\/\/4programmers.net\/java\/Ant<\/description>\r\n\r\n<property name=\"src\" value=\".\/src\"\/>\r\n<property name=\"src.test\" value=\".\/test\"\/>\r\n<property name=\"target\" value=\".\/bin\/classes\/\"\/>\r\n<property name=\"target.test\" value=\".\/bin-test\"\/>\r\n<property name=\"main.package\" value=\"pl.koziolekweb.programmers.ant\"\/>\r\n<property name=\"main.package.dir\" value=\"pl\/koziolekweb\/programmers\/ant\"\/>\r\n\r\n<!-- =================================\r\ntarget: create\r\n================================= -->\r\n<target name=\"create\" description=\"Tworzy struktur\u0119 projektu\">\r\n<echo>Tworz\u0119 katalog ze \u017arod\u0142ami<\/echo>\r\n<mkdir dir=\"${src}\/${main.package.dir}\"\/>\r\n<echo>Tworz\u0119 katalog z testami<\/echo>\r\n<mkdir dir=\"${src.test}\/${main.package.dir}\"\/>\r\n<echo>Tworz\u0119 katalog ze skompilowanymi klasami<\/echo>\r\n<mkdir dir=\"${target}\"\/>\r\n<echo>Tworz\u0119 katalog ze skompilowanymi testami<\/echo>\r\n<mkdir dir=\"${target.test}\"\/>\r\n<\/target>\r\n<\/project><\/pre>\n
Metoda ta jest dobra ale jedynie wtedy gdy warto\u015bci zmiennych s\u0105 takie same dla wszystkich os\u00f3b pracuj\u0105cych przy projekcie. Je\u017celi zmienna wymaga r\u00f3\u017cnych warto\u015bci w zale\u017cno\u015bci od np. \u015brodowiska lub osoby, kt\u00f3ra uruchamia proces to nie wskazane jest zmienianie jej za ka\u017cdym razem. Jest to szczeg\u00f3lnie uci\u0105\u017cliwe w przypadku pracy z systemami kontroli wersji. Z jednej strony nie nale\u017cy wysy\u0142a\u0107 do repozytorium pliku z wiadomo\u015bciami przydatnymi tylko nam, ale z drugiej strony nale\u017cy posiada\u0107 zawsze aktualny plik build.xml<\/code>. W takim przypadku nale\u017cy u\u017cy\u0107 pliku build.properties<\/code> zamiast bezpo\u015brednich wpis\u00f3w w build.xml<\/code>.<\/p>\n
 <\/p>\n
U\u017cycie pliku build.properties<\/span><\/p>\n
Plik ten jest typowym plikiem .properties<\/code> ze wszystkimi jego zaletami i wadami (kodowanie US-ASCII, patrz Properties – pliki tekstowe). Przenie\u015bmy cz\u0119\u015b\u0107 naszych zmiennych do tego pliku:<\/p>\n
target=.\/bin\/classes\/\r\ntarget.test=.\/bin-test\/<\/pre>\n
Jak wida\u0107 nie ma r\u00f3\u017cnicy pomi\u0119dzy tymi metodami definiowania zmiennych. Plik build.properties<\/code> mo\u017ce by\u0107 ju\u017c wyj\u0119ty z pod kontroli wersji i nie ma potrzeby za\u015bmiecania repozytorium r\u00f3\u017cnymi wersjami konfiguracji. wystarczy tylko podlinkowa\u0107 nasz plik w pliku build.xml<\/code> i gotowe.<\/p>\n
<?xml version=\"1.0\" encoding=\"iso-8859-2\"?>\r\n<project name=\"Project name\" basedir=\".\" default=\"create\">\r\n<description>Tutorial ANT na http;\/\/4programmers.net\/java\/Ant<\/description>\r\n\r\n<property file=\"build.properties\" \/>\r\n<property name=\"src\" value=\".\/src\" \/>\r\n<property name=\"src.test\" value=\".\/test\" \/>\r\n<property name=\"main.package\" value=\"pl.koziolekweb.programmers.ant\" \/>\r\n<property name=\"main.package.dir\" value=\"pl\/koziolekweb\/programmers\/ant\" \/>\r\n\r\n<!-- =================================\r\ntarget: create\r\n================================= -->\r\n<target name=\"create\" depends=\"configure\" description=\"Tworzy struktur\u0119 projektu\">\r\n<echo>Tworz\u0119 katalog ze \u017arod\u0142ami<\/echo>\r\n<mkdir dir=\"${src}\/${main.package.dir}\" \/>\r\n<echo>Tworz\u0119 katalog z testami<\/echo>\r\n<mkdir dir=\"${src.test}\/${main.package.dir}\" \/>\r\n<echo>Tworz\u0119 katalog ze skompilowanymi klasami<\/echo>\r\n<mkdir dir=\"${target}\" \/>\r\n<echo>Tworz\u0119 katalog ze skompilowanymi testami<\/echo>\r\n<mkdir dir=\"${target.test}\" \/>\r\n<\/target>\r\n<\/project><\/pre>\n
 <\/p>\n
Przyk\u0142ady<\/code><\/p>\n
Om\u00f3wi\u0119 teraz przyk\u0142adowy plik build.xml<\/code>, kt\u00f3ry zawiera kompletny zestaw najpopularniejszych zada\u0144. Zadania zosta\u0142y tak przygotowane, \u017ce pokrywaj\u0105 najpopularniejsze wymagania dotycz\u0105ce sposobu dostarczenia kodu. Dla ograniczenia liczby plik\u00f3w wszystkie zmienne zosta\u0142y umieszczone w pliku build.xml<\/code>.<\/p>\n
<?xml version=\"1.0\" encoding=\"iso-8859-2\"?>\r\n<project name=\"Project name\" basedir=\".\" default=\"all\">\r\n<description>Tutorial ANT na http;\/\/4programmers.net\/java\/Ant<\/description>\r\n\r\n<property file=\"build.properties\" \/>\r\n<property name=\"target\" value=\".\/bin\/\" \/>\r\n<property name=\"target.classes\" value=\".\/bin\/classes\/\" \/>\r\n<property name=\"target.test\" value=\".\/bin-test\/\" \/>\r\n<property name=\"target.jar\" value=\".\/bin\/jar\" \/>\r\n<property name=\"lib\" value=\".\/lib\" \/>\r\n<property name=\"lib.junit\" value=\"${lib}\/junit4.jar\" \/>\r\n<property name=\"reports.tests\" value=\".\/bin-test\/raport\/\" \/>\r\n<property name=\"src\" value=\".\/src\" \/>\r\n<property name=\"src.test\" value=\".\/test\" \/>\r\n<property name=\"main.package\" value=\"pl.koziolekweb.programmers.ant\" \/>\r\n<property name=\"main.package.dir\" value=\"pl\/koziolekweb\/programmers\/ant\" \/>\r\n\r\n<target name=\"clean\" description=\"Usuwa katalogi ze skompilowanym kodem\">\r\n<delete includeemptydirs=\"true\" failonerror=\"no\">\r\n<fileset dir=\"${target.classes}\" includes=\"**\/*\" \/>\r\n<\/delete>\r\n<delete includeemptydirs=\"true\" failonerror=\"no\">\r\n<fileset dir=\"${target}\" includes=\"**\/*\" \/>\r\n<\/delete>\r\n<delete includeemptydirs=\"true\" failonerror=\"no\">\r\n<fileset dir=\"${target.test}\" includes=\"**\/*\" \/>\r\n<\/delete>\r\n<\/target>\r\n\r\n<target name=\"create\" depends=\"clean\" description=\"Tworzy struktur\u0119 projektu\">\r\n<mkdir dir=\"${src}\/${main.package.dir}\" \/>\r\n<mkdir dir=\"${src.test}\/${main.package.dir}\" \/>\r\n<mkdir dir=\"${target.classes}\" \/>\r\n<mkdir dir=\"${target.test}\" \/>\r\n<mkdir dir=\"${target.jar}\" \/>\r\n<mkdir dir=\"${lib}\" \/>\r\n<mkdir dir=\"${reports.tests}\" \/>\r\n<\/target>\r\n\r\n<target name=\"compile\" depends=\"create\" description=\"kompiluje kod\">\r\n<javac srcdir=\"${src}\" destdir=\"${target.classes}\" \/>\r\n<\/target>\r\n\r\n<target name=\"test-compile\" description=\"kompiluje kod\" depends=\"compile\">\r\n<javac srcdir=\"${src.test}\" destdir=\"${target.test}\" classpath=\"${lib.junit};${target.classes}\" \/>\r\n<\/target>\r\n\r\n<target name=\"run-test\" depends=\"test-compile\" description=\"Uruchamia testy jednostkowe\">\r\n<junit>\r\n<classpath>\r\n<pathelement location=\"${lib}\" \/>\r\n<pathelement location=\"${lib.junit}\" \/>\r\n<pathelement path=\"${target.classes}\" \/>\r\n<pathelement path=\"${target.test}\" \/>\r\n<\/classpath>\r\n<batchtest fork=\"yes\" todir=\"${reports.tests}\">\r\n<fileset dir=\"${src.test}\">\r\n<include name=\"**\/*Test.java\" \/>\r\n<\/fileset>\r\n<\/batchtest>\r\n<formatter type=\"xml\" \/>\r\n<\/junit>\r\n<\/target>\r\n\r\n<target name=\"package\" depends=\"compile\" description=\"tworzy plik jar\">\r\n<jar destfile=\"${target.jar}\/app.jar\">\r\n<fileset dir=\"${target.classes}\" \/>\r\n<\/jar>\r\n<\/target>\r\n\r\n<target name=\"test-package\" depends=\"test-compile\" description=\"tworzy plik jar z testami\">\r\n<jar destfile=\"${target.jar}\/app-test.jar\">\r\n<fileset dir=\"${target.test}\" \/>\r\n<\/jar>\r\n<\/target>\r\n\r\n<target name=\"src-package\" description=\"tworzy plik jar ze \u017ar\u00f3d\u0142ami i \u017ar\u00f3d\u0142ami test\u00f3w\">\r\n<jar destfile=\"${target.jar}\/app-src.jar\">\r\n<fileset dir=\"${src}\" \/>\r\n<\/jar>\r\n<jar destfile=\"${target.jar}\/app-src-test.jar\">\r\n<fileset dir=\"${src.test}\" \/>\r\n<\/jar>\r\n<\/target>\r\n\r\n<target name=\"javadoc\">\r\n<javadoc packagenames=\"pl.koziolekweb.programmers.ant*\" sourcepath=\"${src}\" defaultexcludes=\"yes\" destdir=\"${target}\/docs\/api\" author=\"true\" version=\"true\" use=\"true\" windowtitle=\"App API\" classpath=\"${target.jar}\/app.jar\" \/>\r\n<javadoc packagenames=\"pl.koziolekweb.programmers.ant*\" sourcepath=\"${src.test}\" defaultexcludes=\"yes\" destdir=\"${target}\/docs\/test-api\" author=\"true\" version=\"true\" use=\"true\" windowtitle=\"App tests API\" classpath=\"${lib.junit};${target.test}\"\/>\r\n<zip destfile=\"${target}\/docs\/api.zip\" basedir=\"${target}\/docs\/api\/\" \/>\r\n<zip destfile=\"${target}\/docs\/test-api.zip\" basedir=\"${target}\/docs\/test-api\/\" \/>\r\n<\/target>\r\n\r\n<target name=\"all\" depends=\"package,test-package,src-package\"><\/target>\r\n<\/project>\r\n\r\n<\/pre>\n
 <\/p>\n
Usuwanie starych plik\u00f3w<\/span><\/p>\n
Pierwszym celem jest clean<\/em>. Usuwa on wszystkie stare skompilowane pliki, pliki jar<\/em> i stare testy. Zadanie delete<\/em> przyjmuje w tym przypadku list\u0119 plik\u00f3w do usuni\u0119cia z podanego katalogu, ale bez tego katalogu. W trakcie okre\u015blania zbioru plik\u00f3w, fileset<\/code>, istnieje mo\u017cliwo\u015b\u0107 stworzenia listy wy\u0142\u0105cze\u0144 przez zdefiniowanie atrybuty albo elementu excludes<\/code><\/p>\n
 <\/p>\n
Tworzenie katalog\u00f3w<\/span><\/p>\n
Ten cel zosta\u0142 ju\u017c om\u00f3wiony wcze\u015bniej.<\/p>\n
 <\/p>\n
Kompilacja \u017ar\u00f3de\u0142 i test\u00f3w<\/span><\/p>\n
Te dwa cele reprezentowane przez compile i test-compile s\u0105 najwa\u017cniejszymi elementami projektu. Okre\u015blaj\u0105, kt\u00f3re katalogi zawieraj\u0105 pliki \u017ar\u00f3d\u0142owe i pozwalaj\u0105 na ich kompilacj\u0119. W przypadku compile proces jest bardzo prosty za pomoc\u0105 atrybutu srcdir okre\u015blono katalog \u017ar\u00f3d\u0142owy, a za pomoc\u0105 destdir docelowy. Kompilacja test\u00f3w jest troch\u0119 bardziej skomplikowana poniewa\u017c wymaga okre\u015blenia poza katalogiem \u017ar\u00f3d\u0142owym i docelowym te\u017c \u015bcie\u017cki z zale\u017cno\u015bciami. Mo\u017cna wykona\u0107 to zadanie na kilka sposob\u00f3w. Najprostszym jest u\u017cycie atrybutu classpath i r\u0119czne dodanie wszystkich potrzebnych element\u00f3w. Cel test-compile jest uzale\u017cnione od compile poniewa\u017c do uruchomienia test\u00f3w potrzebne s\u0105 skompilowane klasy aplikacji.<\/p>\n
 <\/p>\n
Uruchomienie test\u00f3w<\/span><\/p>\n
Ten cel jest troch\u0119 bardziej skomplikowany. Po pierwsze classpath jest okre\u015blony za pomoc\u0105 listy element\u00f3w pathelement. Pozwala to na budowanie d\u0142ugich \u015bcie\u017cek i na d\u0142u\u017csz\u0105, nomen omen, met\u0119 jest znacznie bardziej wygodne. Po drugie u\u017cyty zosta\u0142 element batchtest zamiast test. Pozwala on na konfiguracj\u0119 test\u00f3w na podstawie \u015bcie\u017cki, a test przyjmuje jako atrybut class pojedyncze klasy testowe.<\/p>\n
 <\/p>\n
Tworzenie pakiet\u00f3w<\/span><\/p>\n
Cele package,test-package i src-package maj\u0105 za zadanie utworzenie plik\u00f3w jar zawieraj\u0105cych odpowiednio aplikacj\u0119, testy, kod \u017ar\u00f3d\u0142owy aplikacji i kod \u017ar\u00f3d\u0142owy test\u00f3w.
\nTworzenie dokumentacji<\/p>\n
Cele javadoc tworzy dokumentacj\u0119 kodu \u017ar\u00f3d\u0142owego i test\u00f3w. Nast\u0119pnie pakuje j\u0105 do plik\u00f3w zip. Przy tworzeniu dokumentacji te\u017c nale\u017cy zdefiniowa\u0107 classpath w przeciwnym wypadku javadoc zwroci b\u0142\u0119dy podobne do tych jakie zwraca kompilator gdy nie odnajdzie zalezno\u015bci.
\nWszystko naraz<\/p>\n
Ostatni cel jest domy\u015blny. Uruchamia wszystkie poprzednie dbaj\u0105 o to by zale\u017cno\u015bci by\u0142y uruchamiane tylko raz.<\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Mimo, \u017ce PHP jest j\u0119zykiem interpretowanym a kod PHP nie wymaga kompilacji, to developerzy przeprowadzaj\u0105 np. generacj\u0119 lub transformacj\u0119 kodu autoloadera. Doskona\u0142ym narz\u0119dziem s\u0142u\u017c\u0105cym do zautomatyzowania procesu budowy oprogramowania jest Apache Ant. To co r\u00f3\u017cni Ant i np.\u00a0 znany z Linuksa Make jest to, \u017ce Ant u\u017cywa plik\u00f3w w formacie XML do opisu procesu budowy … <\/p>\n
Continue reading “CI\/CD projekt\u00f3w PHP na Jenkinsie \u2013 Automatyzacja”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":2002,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[54],"tags":[],"_links":{"self":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts\/2032"}],"collection":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/comments?post=2032"}],"version-history":[{"count":20,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts\/2032\/revisions"}],"predecessor-version":[{"id":2114,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts\/2032\/revisions\/2114"}],"wp:featuredmedia":[{"embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/media\/2002"}],"wp:attachment":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/media?parent=2032"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/categories?post=2032"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/tags?post=2032"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}