Jenkinsfile Checkout SCM

Zarządzanie kodem źródłowym lub SCM odnosi się do systemu kontroli wersji (VCS), który służy do zarządzania kodem źródłowym projektu. Jenkins obsługuje wiele systemów SCM, w tym git, subwersja, rtęć i wiele innych.

Podczas konfiguracji projektu możemy określić repozytorium SCM, w którym przechowywane jest kod źródłowy projektu. Jenkins następnie okresowo sprawdza repozytorium zmian. Jeśli wykryje nowe zatwierdzenia lub aktualizacje, automatycznie uruchamia kompilację projektu.

W Jenkinsfile możemy zdefiniować krok SCM kasy, aby pobrać kod źródłowy dla rurociągu z określonego repozytorium SCM. Ten krok jest zwykle pierwszym krokiem w Jenkinsfile, zapewniając, że kod źródłowy jest dostępny dla reszty rurociągu.

Wtyczka Jenkins SCM Step

Wtyczka Jenkins SCM Step umożliwia rurociągom Jenkins na użycie standardowych wtyczek Jenkins SCM do sprawdzenia kodu źródłowego ze źródła SCM. Zapewnia to rozszerzalne opcje kasy, określające różne źródła SCM, określone gałęzie i inne.

Aby użyć tej wtyczki, musisz ją zainstalować na kontrolerze Jenkins. Otwórz deskę rozdzielczą Jenkins i wybierz „Zarządzaj Jenkins” z lewego menu. Przejdź do strony Zarządzaj wtyczkami -> Dostępne wtyczki i wyszukaj „SCM krok”.

Korzystanie z etapu Jenkins SCM

Po zainstalowaniu wtyczki SCM możemy użyć wtyczki SCM, jak pokazano w następującym przykładzie rurociągu:

rurociąg
agent etykieta „my-agent”
Etapy
etap („build”)
kroki
SCM kasy
SH MAK

W poprzednim przykładzie używamy kroku SCM kasy, aby sprawdzić źródło i uruchomić kompilację za pomocą polecenia Make.

Możesz określić różne źródła SCM, takie jak AWS Code Pipeline, Bazaar SCM, Bitkeeper, Mercuria, Open Shift Images, system plików i nie tylko.

Poniższy obraz pokazuje zaakceptowane źródła SCM dla kroku kasy:

Źródło: Dokumentacja Jenkins SCM.

Poniższy przykład pokazuje, w jaki sposób można określić źródło SCM i inne opcje, takie jak poświadczenia:

SCM z kasą: [$ klasa: „Mercurialscm”, źródło: „ssh: // [email protected]/User/Repo ', Clean: True, CredentialSid: „1234-5678-ABCD”], sondaż: false

W poprzednim przykładzie blok SCM kasy określa SCM, z którego krok kasy otrzymuje kod źródłowy.

Definiujemy również konfigurację dla docelowego SCM, w tym adres URL i poświadczenia dla serwera.

W takim przypadku [$ class: „mercurialscm”] jest definiowany przy użyciu scm rtęciowego do łączenia się z repozytorium.

Następnie używamy opcji źródłowej, aby określić adres URL repozytorium, który jest repozytorium rtęci, które jest hostowane na Bitbucket.

Definiujemy również czystą opcję, która mówi Jenkinsowi, aby wykonał „czystą” kasę. To pozwala Jenkins odrzucić wszelkie lokalne zmiany i sprawdzić świeżą kopię repozytorium.

Opcja FredentialSid określa zestaw identyfikatorów poświadczeń do uwierzytelnienia za pomocą docelowego repozytorium.

Wreszcie ankieta opcji jest ustawiona na false. Zapobiega to sondowaniu repozytorium zmian. Dlatego Jenkins nie uruchamia automatycznie kompilacji, jeśli wykryto nowe zatwierdzenia lub aktualizacje w repozytorium. Musimy ręcznie uruchomić kompilację lub użyć innych środków (takich jak hold internetowy), aby uruchomić kompilację.

Wniosek

Zbadaliśmy podstawy korzystania z SCM Checkout Etp w Jenkins, aby sprawdzić kod źródłowy z danego repozytorium.