Articles

TFS Tutorial: TFS do automatyzacji budowania, testowania i wdrażania projektów.NET

za pomocą Microsoft TFS 2015 Update-3 dla. NET (Build, Test and Deploy): TFS Tutorial

TFS jest szerzej używany do tworzenia. NET przy użyciu Visual Studio. NET IDE. Dzięki TFS 2015 Update 3 można połączyć się z dowolnym serwerem Git repo Team Foundation, używając klucza SSH.

Team Foundation Server (TFS) jest produktem ALM firmy Microsoft, który zapewnia możliwości kompleksowego rozwoju i testowania z wykorzystaniem zarządzania elementami pracy, planowania projektu (Waterfall lub Scrum), kontroli wersji, budowania/uwalniania (wdrażania) i możliwości testowania.

UWAGA: Ten samouczek TFS ma wiele obrazów, więc pozwól mu się poprawnie załadować.

przeczytaj również => TFS dla projektów JAVA z Eclipse w DevOps

używając Microsoft TFS 2015 Update 3 dla .NET (Build, Test and Deploy)

wprowadzenie

TFS jest dostosowany do Microsoft Visual Studio i Eclipse na wszystkich platformach, jednak może być również używany jako back-end do kilku IDE (zintegrowanych środowisk programistycznych).

przyjrzymy się teraz, w jaki sposób Team Foundation Server (TFS) będzie używany do budowania, testowania i wdrażania aplikacji internetowych.NET, co tradycyjnie stanowi siłę narzędzia.

warunek:

  • Microsoft TFS 2015 Update 3
  • Microsoft Visual Studio.NET 2015 (30-dniowa wersja próbna)
  • SonarQube 6.4 lub nowszy
  • włączony serwer sieci Web IIS. Ponieważ używam Okna 7, możesz sprawdzić ten samouczek, Jak włączyć usługi IIS 7. Jak zainstalować Internetowe usługi informacyjne (IIS 7) w systemie Windows 7 Ultimate
  • istnieje kilka filmów na YouTube o tym, jak włączyć usługi IIS w systemie Windows 2008 / 2012 / 2016.

zazwyczaj do wykonania czynności wymienionych w samouczku potrzebny jest serwer kompilacji, na którym będą wykonywane Kompilacje oraz maszyny lub środowiska wdrożeniowe, w których aplikacje będą wdrażane w usługach IIS, z zainstalowanymi i uruchomionymi agentami. Zapoznaj się z moim wcześniejszym tutorialem, aby dowiedzieć się, jak zainstalować agentów.

skonfiguruj aplikację C#

zakładając, że elementy pracy zadania są tworzone w TFS i są przypisane do programisty do pracy na tym samym. Zawsze zauważyłem, że identyfikowalność jest bardzo ważna z punktu widzenia śledzenia każdej pracy w całym cyklu życia oprogramowania.

przed dodaniem aplikacji.NET do repozytorium kontroli źródłowej TFS upewnij się, czy istnieje kolekcja i projekt zespołu.

zbiór jest tworzony przez administratora TFS. Składa się z grupy projektów zespołowych w dowolnej organizacji usługowej, w której realizowane są projekty dla wielu klientów. Możesz tworzyć indywidualne kolekcje dla każdego projektu klienta w TFS.

Po utworzeniu kolekcji możesz utworzyć w niej wiele projektów zespołowych. Jeden projekt zespołu składa się ze wszystkich elementów roboczych, kodu źródłowego, artefaktów testowych, wskaźników raportów itp., Projekt zespołu można utworzyć przy użyciu różnych wbudowanych szablonów procesów, takich jak Scrum, Agile, CMMI itp.

  • więcej na temat tworzenia kolekcji można znaleźć @ Manage team project collections in Team Foundation Server
  • tutaj będę używał domyślnej kolekcji, która jest tworzona po zainstalowaniu TFS
  • aby utworzyć projekt zespołu w kolekcji, wykonaj kroki pokazane poniżej.

1 Konfiguracja aplikacji C#

2 Utwórz projekt zespołu

3 Konfiguracja aplikacji C#-wybierz szablon

4 skonfiguruj aplikację C#-określ kontrolę źródła

5setup A C# application - team project setting

6 Setup A C# application - team project creation

7 skonfiguruj aplikację c#-utworzono nowy projekt zespołu.1

Uruchom interfejs internetowy TFS używając adresu URLhttp://<ServerName>:port/tfs I zobaczysz utworzony projekt.

8. Projekty i zespoły

kliknij na projekt, a przejdziesz do pulpitu zespołu

(Uwaga: kliknij dowolny obraz, aby powiększyć)

12. Mój projekt TFS.1

teraz mamy kolekcję i projekt zespołu. Let ’ s launch Visual Studio.NET i utwórz nową aplikację webową C# i udostępnij projekt do repozytorium kontroli źródłowej TFS. Jest to pierwszy krok w kierunku ustanowienia praktyki ciągłej integracji (CI).

1) Uruchom Visual Studio.NET i ustaw TFS jako domyślne repozytorium kontroli źródła. Przejdź do Narzędzia=> opcje=> Kontrola źródła. Następnie kliknij OK.

Uruchom Visual Studio.NET

2) Przejdź do View => Team Explorer i połącz się z serwerem TFS za pomocą ikony16połącz się z serwerem TFS

17view - Team Explorer

3) Utwórz C# ASP.NET Web project

19CREATE A C# ASP.NET Projekt strony internetowej

21 Utwórz C# ASP.NET projekt Web

4) ponieważ tworzymy aplikację webową, Wybierz szablon Web Forms

23 Wybierz szablon Web Forms

kliknij OK, aby utworzyć projekt.

5) stworzony projekt można obejrzeć w Solution Explorer. . NET używa pojęcia .plik sln lub rozwiązanie zawierające wszystkie projekty. Po otwarciu rozwiązania wszystkie powiązane projekty zostaną również otwarte. Musimy dodać rozwiązanie do repozytorium kontroli źródłowej TFS

25 stworzony projekt można obejrzeć w Solution Explorer

6) zmodyfikuj domyślny plik.aspx jak pokazano, zapisz go, a następnie dodaj całe rozwiązanie do repozytorium kontroli źródłowej TFS

27file Default.aspx

wybierz Widok projektu, aby zobaczyć całą stronę

29 widok projektu

7) Dodaj rozwiązanie do kontroli źródła TFS. Kliknij prawym przyciskiem myszy rozwiązanie i wybierz”Dodaj rozwiązanie do kontroli źródła”

31dodaj rozwiązanie do kontroli źródła

8) Wybierz wcześniej utworzony projekt zespołu, a następnie kliknij OK

33 Wybierz projekt zespołu

9) rozwiązanie nie jest jeszcze sprawdzane w TFS. W Team Explorer kliknij na source control explorer i możesz zobaczyć rozwiązanie dodane do sprawdzenia.

35source control explorer

10) zmiany Check-in. Przejdź do Team Explorer = > oczekujące zmiany

wprowadź komentarz i przeciągnij i upuść element pracy zadania, aby zapewnić identyfikowalność. Kliknij przycisk Check-in.

37 Check-in

39 oczekujące zmiany

41drag-upuść element roboczy zadania, aby zapewnić identyfikowalność

11) aby przetestować stronę działającą lokalnie, kliknij na ikonę Firefoksa w Visual Studio.NET. pamiętaj, że nie jest jeszcze wdrożony w usługach IIS w żadnym konkretnym środowisku.

43 Kliknij ikonę Firefoksa w Visual Studio.NET

strona internetowa

Tworzenie definicji kompilacji z analizą kodu

definicja kompilacji składa się z serii zadań, które są wykonywane podczas automatycznego procesu kompilacji. Przykładami zadań mogą być uruchamianie Visual Studio Build, MS Build, wykonywanie skryptów PowerShell lub Shell itp.

1) aby utworzyć definicję kompilacji, Zaloguj się do interfejsu internetowego TFS i przejdź do zakładki Kompilacje. Kliknij na+, aby utworzyć definicję kompilacji. Zacznij od pustej definicji, a następnie kliknij Dalej.

47 strona działająca lokalnie

Wybierz projekt zespołu i kliknij Utwórz

49 Utwórz kompilację

kliknij Edytuj, która znajduje się obok pustej definicji

51kliknij na Edytuj

Zapisz definicję kompilacji jako coś w rodzaju 'main build’

53zapisz definicję kompilacji

ponieważ SonarQube będzie używany do analizy kodu, dlatego dodaj 2 kroki sonaru 'SonarQube scanner for MSBuild – begin analysis’ i 'SonarQube scanner for MSBuild – End Zadania analityczne.

Dodaj krok rozpocznij analizę przed dowolnym ms Build lub Visual Studio Build. Ten krok pobiera szczegóły z serwera Sonarqube, aby skonfigurować analizę.

Dodaj Etap analizy końcowej później.

55add End Analysis step

dodane kroki będą wyglądać następująco z MS Build step pomiędzy.

Zacznij definiować szczegóły serwera Sonarqube. Zdefiniuj punkt końcowy, w którym dodano Serwer Sonarqube i szczegóły uwierzytelniania. Kliknij „Zarządzaj”, aby dodać szczegóły serwera Sonarqube.

kliknij na 'New Service Endpoint => Generic’

57 New Service Endpoint-Generic

59 Generic

teraz wróć do głównego ekranu definicji kompilacji i wybierz punkt końcowy, który właśnie powstał.

ukończona konfiguracja do rozpoczęcia analizy wygląda tak, jak pokazano poniżej

61 wybierz punkt końcowy

Wybierz rozwiązanie. W Advanced = > dodatkowe Ustawienia Wprowadź następujące i zapisz definicję kompilacji

/d:sonar.scm.enabled=true / d: sonar.scm.provider=tfvc / d: sonar.tfvc.nazwa użytkownika = niranjan / d: sonar.tfvc.hasło.secured=<hasło>

63zapisz definicję kompilacji

SonarQube – Analiza końcowa. Zakończ analizę, a następnie prześlij wyniki do projektu SonarQube.

65sonarqube – Analiza końcowa

Dodaj krok do publikowania artefaktów na serwerze. Artefakty będą przechowywane w folderze upuszczania na serwerze i będą używane podczas wdrażania.

67 Publikuj artefakty na serwerze

2) zainstaluj agenta na maszynie budowania i wdrażania. Możesz zapoznać się z moim poprzednim samouczkiem, aby dowiedzieć się, jak zainstalować agenta. Teraz zakładając, że agent jest zainstalowany, upewnij się, czy agent jest uruchomiony, czy nie.

69 zainstaluj agenta na maszynie budowania i wdrażania

3) Upewnij się, że wtyczka SonarQube SCM TFVC została pobrana stąd. i skopiowane do katalogu SonarQube installation\extensions\plugins. Ta wtyczka zapewnia pobranie kodu źródłowego z repozytorium kontroli źródłowej TFS i udostępnienie go SonarQube do analizy kodu.

71 pobrano wtyczkę SonarQube SCM TFVC

4) Po pobraniu i skopiowaniu wtyczki uruchom serwer sonar

73 uruchom serwer sonar

5) Zainicjuj kompilację, aby sprawdzić, czy kroki działają poprawnie. Otwórz definicję kompilacji i kliknij „Kolejkuj kompilację”

75queue Build

build Successful. Wszystkie kroki przebiegały dobrze.

77build zakończony sukcesem. Wszystkie kroki przebiegały dobrze.

kliknij na numer kompilacji, w tym przypadku jest to Build 217 i przejdź do karty artefakty, aby spojrzeć na folder drop utworzony na poziomie serwera.

79 Build 217-karta artefakty

Uwaga: w następnej sekcji proces wydania pokazuje, jak każda ze zmian może być odzwierciedlona w całym procesie wdrażania. W tym celu upewnij się, że Artefakty projektu są kopiowane przez krok kopiowania w definicji kompilacji po kroku kompilacji lub ręcznie skopiuj katalog artefaktu projektu do C:\Inetpub \ katalog wwwroot. Trzeba to zrobić tylko raz.

81www katalog root

Tworzenie Wydania do wdrożenia

w poprzedniej sekcji zobaczyliśmy o Build, a następnie analizę kodu przy użyciu SonarQube. Utworzymy teraz Wydanie umożliwiające wdrożenie artefaktów z folderu „upuść” w usługach IIS.

wraz z utworzeniem zwolnienia Cała ciągła integracja i ciągłe dostarczanie są zautomatyzowane bez żadnej ręcznej interwencji.

przejdź do Release hub i utwórz definicję Release.

83 Release hub i utwórz definicję Release

zacznij od pustej definicji i kliknij OK.

85 pusta definicja

Zapisz definicję Wydania i zmień nazwę domyślnego środowiska na QA. W oparciu o projekty, dodatkowe środowiska, takie jak Staging Pre-Prod itp. można również dodać, a wdrożenie zostanie zautomatyzowane w całych środowiskach jeden po drugim.

87 Zapisz definicję Wydania

Połącz definicję kompilacji z definicją Wydania, aby wdrożenie było zautomatyzowane. Kliknij „Link do definicji kompilacji”. Wybierz definicję kompilacji utworzoną wcześniej.

89 Link do definicji kompilacji

kliknij na Link

Włącz warunek wdrożenia, aby zainicjować wdrożenie natychmiast po utworzeniu wersji

91 Włącz warunek wdrożenia

93 rozpocznij wdrażanie deployment

włącz także WYZWALACZ deployment po pomyślnym zakończeniu kompilacji. W definicji Wydania przejdź do zakładki wyzwalacz i włącz „wdrażanie ciągłe”, wybierz definicję kompilacji.

później Zapisz definicję Wydania.

95 włącz WYZWALACZ wdrożenia

powrót w zakładce środowiska definicji wydania Dodaj zadania do wdrożenia artefaktów na serwerze IIS.

Dodaj zadanie kopiowania plików z folderu „upuść” utworzonego podczas procesu kompilacji do IIS wwwrootdirectory.

97dodaj zadanie skopiowania plików z folderu 'drop'

99 IIS wwwrootdirectory

folder źródłowy – Przeglądaj i wybierz projekt Webapplication1 w folderze drop

101wybierz webapplication1

folder docelowy powinien być katalogiem inetpub\wwwroot – C:\Inetpub \ wwwroot\WebApplication1

Wykonywanie Wydania dla wdrożenia

w centrum wydania Utwórz wydanie, aby rozpocząć wdrażanie

103 Utwórz wydanie, aby rozpocząć wdrażanie

wybierz ostatnią stabilną kompilację i kliknij Utwórz, aby rozpocząć wdrażanie.

105ostatnia stabilna Budowa

wdrożenie powiodło się w środowisku QA

107ployment powiodło się w środowisku QA

Uruchom inetmgr, który jest menedżerem usług IIS, gdzie możesz zarządzać wszystkimi witrynami / aplikacjami zainstalowanymi w usługach IIS. Przejdź do wdrożonej aplikacji internetowej.

109browse to the web application deployed

111stosowana aplikacja internetowa

aby zakończyć po rozpoczęciu kompilacji, wdrożenie zostanie również zakończone we wszystkich zdefiniowanych środowiskach, ponieważ wydanie jest powiązane z definicją kompilacji.

podsumowanie

w tym samouczku TFS widzieliśmy, jak Platforma Microsoft ALM może być używana do automatyzacji kompilacji, testowania i wdrażania aplikacji.NET. TFS odgrywa tu dużą rolę.

dlatego w dzisiejszym świecie automatyzacja jest kluczem do pomyślnego i szybszego dostarczania.

Ostatnia aktualizacja: 18 lutego 2021 r