maven with jenkins maven documentation
Ten samouczek wyjaśni wszystko o Jenkins i integracji Maven z Jenkins. Dowiesz się również, jak tworzyć dokumentację projektu za pomocą Mavena:
Dowiemy się czym jest Jenkins, Maven Jenkins Integration, zalety Jenkinsa, jak skonfigurować Java i Maven w Jenkins, jak stworzyć zadanie Jenkinsa z różnymi parametrami, raporty wyników wykonania Jenkinsa z wtyczkami TestNG, jak przejść Maven polecenia w postaci celów w Jenkins, dokumentacji Maven dla projektów itp. szczegółowo.
=> Obejrzyj serię szkoleń Simple Maven tutaj.
jak odwrócić tablicę w java
Czego się nauczysz:
Co to jest Jenkins?
Jenkins to narzędzie do ciągłej integracji, które ma ogromne znaczenie w świecie testowania i rozwoju oprogramowania. Jest open source i niezależny od platformy. W naszej codziennej pracy mamy do czynienia z frameworkami automatyzacji składającymi się z kilkuset przypadków testowych.
Do tej pory widzieliśmy, że aby wykonać nasze skrypty z projektu Maven, musimy albo uruchamiać polecenia Mavena z wiersza poleceń, albo bezpośrednio otwierać Eclipse i uruchamiać skrypty.
Dlatego ręcznie uruchamiamy przypadki testowe do wykonania. Aby zautomatyzować ten proces, musimy zaplanować zadania, które uruchomią nasze przypadki testowe w określonym czasie, a także zadbają o kilka ważnych parametrów. Cały proces jest zautomatyzowany z pomocą Jenkinsa.
Tak więc w rzeczywistości, jeśli mamy około 800 przypadków testowych, które muszą zostać wykonane o trzeciej nad ranem, można to łatwo zrobić bez konieczności jakiejkolwiek ręcznej interwencji z pomocą zadań Jenkin.
Istnieją również scenariusze, w których zautomatyzowane przypadki testowe Smoke lub Sanity muszą być wykonywane po zaewidencjonowaniu kodu ze strony programistycznej w środowisku. Wszystko to jest obsługiwane automatycznie przez Jenkinsa.
Jenkins ma dziennik wszystkich modyfikacji wykonanych w repozytoriach, takich jak SVN lub Git. Jenkins można łatwo zainstalować w naszym systemie i skonfigurować. Ponadto można go skonfigurować na więcej niż jednej maszynie wirtualnej, jeśli kompilacje muszą być uruchamiane w sposób rozproszony. Ponadto zapewnia dostęp za pośrednictwem łączy do wszystkich najnowszych kompilacji.
Jenkins ma funkcje, takie jak integracja z TestNG za pomocą wtyczek, powiadomienia e-mail o stanie kompilacji, które sprawiają, że jest bardziej popularny w dzisiejszych czasach. Problemy i błędy są wykrywane i rozwiązywane bardzo wcześnie.
Większość zadań integracyjnych jest wykonywana automatycznie, co oszczędza zasoby i umożliwia bezproblemowe udostępnienie oprogramowania w dowolnym momencie.
W środowisku zwinnym współpracują ze sobą analitycy biznesowi, programiści i testerzy. W rezultacie może się zdarzyć, że analityk biznesowy (osoba nietechniczna) będzie musiał zobaczyć i monitorować wynik wykonania.
W takich przypadkach może nie potrzebować otwierać Eclipse lub konfigurować i uruchamiać poleceń Mavena, aby uruchomić skrypty. Potrafi wykonać przypadki testowe z pomocą Jenkinsa i uzyskać wyniki wykonania.
Jesteśmy na stronie głównej Jenkins z nazwą stanowiska jako Projekt . Jeśli firma chce zobaczyć wyniki wykonania, należy kliknąć nazwę zadania, a nastąpi przekierowanie na poniższą stronę.
Następnie Buduj teraz po lewej stronie ekranu należy kliknąć. Dlatego musimy tylko otworzyć adres URL Jenkinsa (https: // localhost: 8080 / jenkins).
Chociaż przypadki testowe są wyzwalane za pośrednictwem Jenkinsa, tylko określone środowisko dostarczane w Jenkins jest wykonywane. Jest to typowy scenariusz, w którym jeśli wykonujemy nasze przypadki testowe poza Jenkinsem, kończą się one niepowodzeniem z powodu wersji naszych narzędzi, języka lub plików jar, które nie są dostosowane do tego, co ma działać.
Na przykład, wersja Java lub nasza wersja Maven została zaktualizowana lub zdegradowana. Wszystkich tych można uniknąć, wykorzystując zadania Jenkina do wykonania.
W ten sposób Jenkins ma duży wkład w nasze ramy testowe, utrzymując scentralizowaną konfigurację we wszystkich lokalizacjach geograficznych.
Zalety Jenkinsa
Zalety Jenkinsa są wymienione poniżej:
- Jenkins to oprogramowanie typu open source, niezależne od platformy i przenośne.
- Można go łatwo zainstalować i skonfigurować. Można go z łatwością używać.
- Jenkins zautomatyzował elementy integracji, więc wiele problemów związanych z integracją nie występuje, co zwiększa wydajność i produktywność programistów.
- Jego dokumentacja jest dobrze opisana i ułatwia jej naukę.
- Jenkins został opracowany przez programistów z uwzględnieniem funkcji, których programiści faktycznie potrzebują w pracy.
- Posiada dużą liczbę wtyczek. Wszystkie te wtyczki sprawiają, że Jenkins jest bardziej wydajny i popularny wśród programistów.
- Jenkins wspomaga środowiska hostowane w chmurze.
- Ma dużą społeczność użytkowników, którzy są łatwo dostępni. Pracują regularnie na sprzężeniach zwrotnych i dotykają bazy.
- Jenkins zapewnia pomoc w automatyzacji testów w następujący sposób:
- Funkcja planowania wykonania testów: Specjaliści ds. Testów mogą zaplanować wykonanie przypadków testowych i wykorzystać swój czas na inne zadania.
- Spersonalizowany raport wyników testów: Jenkins podaje szczegółowe informacje na temat wzoru wyników. Graficzne reprezentacje i szczegóły wyników wykonania odzwierciedlają całkowitą liczbę przypadków testowych, czasy wykonania i inne ważne informacje.
- Działa poprawnie z ciągłymi procesami integracji: Jenkins skraca czas testowania.
Ścieżka Java i Maven ustawiona w Jenkins
Przede wszystkim musimy mieć zainstalowaną Javę i Mavena na naszych maszynach. Gdy znajdziemy się na stronie docelowej Jenkinsa, początkowo nie będzie żadnych ofert pracy.
Teraz kliknij Zarządzaj Jenkins link z lewej strony ekranu.
Następnie kliknij Globalne konfiguracje narzędzi . Tutaj musimy wykonać konfiguracje dla Java i Maven. Aby skonfigurować Java, kliknij plik Instalacje JDK przycisk.
Tutaj musimy albo dać Nazwa i JAVA_HOME ścieżka lub można to załatwić, sprawdzając Zainstaluj automatycznie pole wyboru.
Następnie musimy przejść do sekcji Maven i kliknąć Maven Installations przycisk.
Tutaj musimy albo dać Nazwa i MAVEN_HOME ścieżkę lub można to załatwić, sprawdzając plik Zainstaluj automatycznie pole wyboru.
Po wykonaniu tych operacji kliknij Zapisać na dole strony.
Utwórz pracę Jenkins
Następnie musimy wygenerować zadanie do uruchamiania skryptów naszego projektu Maven. Kliknij na Nowa pozycja link z lewej strony ekranu.
Wpisz Nazwa przedmiotu i wybierz plik Projekt freestyle następnie kliknij OK.
Nastąpi przejście do strony konfiguracji zadania. Tutaj musimy podać wszystkie informacje specyficzne dla naszego projektu. Najpierw musimy podać źródło naszego kodu projektu.
Zarządzanie kodem źródłowym Jenkins
w Zarządzanie kodami źródłowymi sekcji, zazwyczaj wybieramy z GitHub lub Obalenie i podaj odpowiednie linki. Jenkins automatycznie pobierze stamtąd kod.
Jeśli jednak nasz kod jest obecny w naszym systemie lokalnym, musimy kliknąć plik zaawansowane przycisk pod generał Sekcja , i następnie sprawdź Użyj niestandardowego obszaru roboczego .
Musimy umieścić nasz projekt Mavena wewnątrz .jenkins folder i podaj ścieżkę do pliku pom znajdującego się w projekcie Maven, zaczynając od $ {JENKINS_HOME}.
W ten sposób Jenkins uzyskuje kod źródłowy projektu.
Jenkins jest używany nie tylko przez testerów do wyzwalania wykonania testu, ale jest również szeroko używany przez programistów do ich pracy. Niektóre z tych opcji są dostępne w ramach Buduj środowisko Sekcja.
Następnie musimy przejść do sekcji Build i wybrać Przywołaj cel Mavena najwyższego poziomu opcje z menu rozwijanego.
Następnie Przywołaj cele Mavena najwyższego poziomu sekcja zostanie rozszerzona. Tutaj Wersja Maven zostaną wstępnie wypełnione z wersji Maven, którą zdefiniowaliśmy w Globalna konfiguracja narzędzi .
W obszarze Cele musimy podać polecenie Maven, aby uruchomić wykonanie. test mvn - regresja. W Jenkinsie możemy pominąć termin mvn, a reszta polecenia jest wystarczająca.
Kliknij Zapisać i udało nam się stworzyć pracę.
Podsumowanie tego, co omówiliśmy do tej pory:
- Lokalizacja naszego kodu (Git, Subversions lub z katalogu lokalnego).
- Polecenie Maven, aby wywołać wykonanie.
Nasza praca zostanie utworzona i będzie widoczna na stronie docelowej Jenkins:
Kliknij na Buduj teraz z lewej strony ekranu. Nastąpi Historia budowy sekcja po lewej stronie ekranu widoczna po zakończeniu kompilacji. Plik numer kompilacji będzie widoczny po # razem z znak czasu . Teraz przejdź do Wyjście konsoli .
Wyniki wykonania:
Raport integracji TestNG Jenkins dla wyników wykonania
Aby uzyskać szczegółowe informacje o wyniku wykonania testu, przejdź do projektu Maven w Eclipse, przejdź do pliku cel folder, a następnie do pewne-raporty teczka. Tam jest index.html plik wewnątrz raportów surefire. Uzyskaj lokalizację pliku i otwórz go w przeglądarce.
testng-results.xml Plik i wtyczka raportów TestNG jest wymagana dla wyników w Jenkins.
Kliknij Zarządzaj Jenkins link z lewej strony ekranu Jenkins. Następnie kliknij Zarządzaj wtyczkami połączyć.
jak wydrukować zawartość tablicy java
Zainstaluj Wtyczka TestNG Results .
Po zakończeniu zaktualizujemy zadanie, które utworzyliśmy z pliku Skonfiguruj link z lewej strony ekranu. Następnie przejdź do Działania po kompilacji sekcję i wybierz Opublikuj wyniki TestNG z listy rozwijanej.
testng-results.xml plik w naszym projekcie Maven zostanie automatycznie wypełniony w Wzorzec raportu TestNG XML pole domyślnie. Następnie kliknij Zapisz.
Planowanie pracy w Jenkins
Przejdź do Twórz wyzwalacze sekcja dotycząca planowania czasu kompilacji.
Jeśli wybierzemy Buduj okresowo , wtedy będziemy mieć Harmonogram sekcja widoczna. Tutaj musimy wspomnieć o pięciu parametrach, aby zaplanować zadanie, jak pokazano poniżej.
- MINUTY w godzinę
- GODZINY w jeden dzień
- DAYMONTH dzień w miesiącu
- MIESIĄC za rok
- DAYWEEK dzień tygodnia
Aby zaplanować skrypty na 8:00 rano, musimy określić, jak pokazano poniżej:
Teraz ponownie uruchomimy kompilację, aby zweryfikować wyniki TestNG. Przejdź do strony docelowej Jenkins i kliknij ofertę. Będziemy teraz mieć plik Wyniki TestNG link na naszym ekranie z ofertami pracy.
W przypadku, gdy wykonanie nie zakończyło się niepowodzeniem, plik Ostatni wynik testu link nie pokaże żadnych błędów. Kliknij łącze TestNG Results, aby uzyskać więcej informacji na temat wyników.
Możemy kliknąć budować # numer, aby uzyskać więcej informacji na temat wyników.
Aby sprawdzić nasz kod, powinniśmy kliknąć plik Przestrzeń robocza łącze po lewej stronie ekranu. W ten sposób Jenkins i Maven mogą współpracować.
Dokumentacja Maven dla projektu
Możemy stworzyć dokumentację do naszego projektu przy pomocy Mavena. Jak wspomniano wcześniej, Maven obejmuje trzy cykle życia, tj. Czysty, lokacyjny i domyślny.
Zadanie usunięcia wszelkich błędów i usunięcia artefaktów z poprzedniej kompilacji jest załatwione w czysty cykl. Podczas, gdy domyślna odpowiada za cały proces wdrażania teren cykl życia służy do tworzenia dokumentacji projektowej.
Za dobrą praktykę uważa się czyszczenie przed rozpoczęciem budowy, aby mieć aktualną dokumentację.
Przejdź do folderu projektu i uruchom następujące polecenie z wiersza polecenia.
mvn site Rozpocznie się proces budowy projektu. Po pomyślnym zakończeniu budowy dokumentacja projektowa zostanie wygenerowana, jak pokazano poniżej.
Po kliknięciu pliku index.html możemy mieć szczegółową dokumentację projektu składającą się głównie z informacji o kompilacji i projekcie, o projekcie, ciągłej integracji, zależnościach, liście mailingowej, licencjach i tak dalej.
Sekcja FAQ
Pytanie 1) Jak Jenkins współpracuje z Mavenem?
Odpowiedź: Jenkins dobrze współpracuje z Maven, przestrzegając pewnych warunków wstępnych. Musimy skonfigurować ścieżki Java i Maven w Jenkins. Następnie musimy utworzyć zadania Jenkins ze wszystkimi parametrami, w tym działaniami po kompilacji, planowaniem kompilacji i tak dalej.
Pytanie 2) Co to są Maven i Jenkins?
Odpowiedź: Maven to narzędzie do zarządzania i budowania projektów opracowane w języku Java. Jenkins to narzędzie do ciągłej integracji, które jest open source. Zarówno Maven, jak i Jenkins są obecnie szeroko stosowane w przemyśle.
P # 3) Jaki jest cel Maven w Jenkins?
Odpowiedź: Udostępniamy polecenia Maven w sekcji Cele w Jenkins. To kluczowy krok podczas tworzenia pracy w Jenkins.
Pytanie 4) Dlaczego używamy Maven?
Odpowiedź: Maven to narzędzie do zarządzania projektami i kompilacji, które jest sterowane przez plik pom.xml. Dzięki temu proces tworzenia jest prosty, łatwy i spójny.
P # 5) Czy Maven jest narzędziem CI?
Odpowiedź: Nie, Maven nie jest narzędziem ciągłej integracji. Jest to narzędzie do budowania, które ma więcej funkcji niż Ant. Jenkins to narzędzie do ciągłej integracji.
P # 6) Co to jest pom xml w Maven?
Odpowiedź: Project Object Model lub pom to plik xml, który stanowi rdzeń Maven. Zawiera listę zależności projektu, konfiguracji, profili i tak dalej.
P # 7) Czy możemy zintegrować TestNG i Jenkins z Maven?
Odpowiedź: Tak, możemy zintegrować TestNG i Jenkins z Maven. Wszystko to osiąga się za pomocą wtyczek.
co oznacza niezgodność klucza bezpieczeństwa
P # 8) Jakie są trzy wersje cyklu życia Mavena?
Odpowiedź: Trzy standardowe wersje cyklu Maven są wymienione poniżej.
- Domyślna
- Czysty
- Teren
Q # 9) Jak ustawić XML ustawień Jenkinsa?
Odpowiedź: W Jenkins przejdź do sekcji zadania tworzenia, a następnie kliknij Zaawansowane. Plik ustawień opcja będzie tam widoczna. Tam należy określić lokalizację pliku settings.xml.
P # 10) Jak ustawić zmienne środowiskowe w Jenkins?
Odpowiedź: Zmienne środowiskowe w Jenkins można ustawić z pliku Skonfiguruj ekran. w Budować wybierz sekcję Wstaw zmienne środowiskowe . Tam musimy podać zmienną środowiskową, taką jak wzorzec VARIABLE_NAME = VALUE.
Wniosek
Mamy nadzieję, że duża część Mavena, jak jego integracja z Jenkins, wtyczki TestNG dla Jenkinsa do wyświetlania wyników, tworzenie miejsc pracy w Jenkins, Javie i Maven skonfigurowane w Jenkins, globalne konfiguracje w Jenkins powinny być teraz łatwo zrozumiałe.
Ponadto mechanizmy harmonogramu kompilacji Jenkinsa, jego działania po kompilacji, sposób, w jaki Jenkins radzi sobie z kodem znajdującym się w Git lub jakimkolwiek innym repozytorium lub lokalnie, zostały szczegółowo zilustrowane tutaj. Ćwicz każdy krok jeden po drugim, a połączenie Maven Jenkinsa będzie jasne. Zbadaliśmy również dokumentację Maven dla projektów.
Jenkins, narzędzie ciągłej integracji, ma rzeczywiste zastosowanie dla programistów, testerów, analityków biznesowych itd. W zwinnym świecie. Każda organizacja od czasu do czasu stara się stosować i dostosowywać procesy ciągłej integracji.
=> Odwiedź tutaj, aby zobaczyć serię szkoleń Maven dla wszystkich.
rekomendowane lektury
- Co to jest Maven - samouczek Maven dla początkujących
- Wtyczki Gradle Vs Maven i Maven
- Jenkins CI Tutorial - Co to jest ciągła integracja Jenkinsa
- Jenkins Jobs: Konfigurowanie SCM, tworzenie zadań i odpytywanie SCM
- Wtyczki Jenkins: SCM, analizatory i instalacja wtyczek
- Integracja Mavena z TestNg przy użyciu wtyczki Maven Surefire
- Zabezpieczenia Jenkins: Włączanie bezpieczeństwa i macierzy bezpieczeństwa projektu
- Konfigurowanie Mavena za pomocą Eclipse Java IDE