Wdrażanie i konfigurowanie agentów kompilacji

Aby użyć programu Team Foundation Build, zespół musi mieć przynajmniej jednego agenta kompilacji do wykonywania pracy obciążającej procesor w procesie kompilacji.

Każdy agent kompilacji jest dedykowany jednemu kontrolerowi kompilacji i przez niego kontrolowany.Agenty kompilacji mogą być hostowane na tym samym serwerze kompilacji, który hostuje kontrolera kompilacji, ale nie jest to wymagane, a w niektórych przypadkach potrzeby zespołu mogą zostać spełnione przez pojedynczy serwer kompilacji hostujący kontroler kompilacji, który kontroluje agentów kompilacji na wielu serwerach kompilacji.

Agent kompilacji wykonuje kroki procesu kompilacji zawarte w działaniu AgentScope.Następujące kroki obejmują zwykle pobieranie plików z kontroli wersji, inicjowanie obsługi administracyjnej obszaru roboczego, kompilowanie kodu, wykonywanie testów i scalanie plików do kontroli wersji.

Upewnij się, serwer kompilacji, który obsługuje agentów kompilacji ma wystarczające możliwości przechowywania i przetwarzania i dopasowania rozmiaru i złożoności kodu i testów w kolekcji projektów zespołowych.Zazwyczaj należy obsługiwać nie więcej niż jednego agenta kompilacji na każdy rdzeń procesora na serwerze kompilacji.Można również zwiększyć wydajność, rezerwując jeden fizyczny dysk twardy na potrzeby katalogu roboczego każdego agenta kompilacji.

Porada
Jeśli kolekcja projektów zespołowych jest hostowana w usłudze Visual Studio Online, a potrzeby zespołu mogą zostać spełnione przez pojedynczego agenta standardowej kompilacji, można użyć hostowanego kontrolera kompilacji zamiast wdrażać własnego agenta kompilacji.

Wymagane są uprawnienia

Musisz być członkiem grupy Administrators Windows na serwerze kompilacji oraz członkiem grupy Administratorzy kompilacji kolekcji projektu w kolekcji Twojego projektu zespołowego.Zobacz Uprawnienia serwera programu Team Foundation Server.

Co chcesz zrobić?

• Utwórz lub modyfikuj agenta kompilacji

• Zainstaluj programu Visual Studio i inne oprogramowanie, aby umożliwić kompilację i inne możliwości

• Określ katalog roboczy

• Włącz agenta kompilacji, aby uruchomić testy

• Przypisuj znaczniki, aby przedstawiać zadania lub funkcje agentów kompilacji

• Wdróż agenta kompilacji, który może kompilować i testować aplikacje Windows Store

• Usuń agenta kompilacji

Utwórz lub modyfikuj agenta kompilacji

Aby utworzyć lub zmodyfikować agenta kompilacji z serwera kompilacji

1. Zaloguj się do serwera kompilacji, którą chcesz skonfigurować.

2. W systemie Windows uruchom Start, a następnie Konsola administracyjna programu Team Foundation Server.

   Pojawi się okno dialogowe Konsola administracyjna programu Team Foundation.

3. W okienku drzewa konsoli administracyjnej programu Team Foundation, rozwiń nazwę serwera, a następnie wybierz węzeł Konfiguracja kompilacji.

   Informacja o serwerze kompilacji pojawia się w okienku zawartości.

   Jeśli pojawi się komunikat Skonfiguruj zainstalowane funkcje, zobacz Wdrażanie serwera kompilacji.

4. Na stronie Konfiguracja kompilacji:

   • Aby utworzyć nowego agenta kompilacji, wybierz opcję Nowy agent.

   • Aby zmodyfikować istniejącego agenta kompilacji

     

     wybierz Właściwości.

   Zostanie wyświetlone okno dialogowe Właściwości agenta kompilacji.

Aby zmodyfikować agenta kompilacji z Visual Studio

1. W programie Visual Studio, w Eksploratorze zespołu:

   1. Jeśli nie jesteś podłączony do projektu zespołowego w zbiorze projektów zespołowych. to połącz się z projektem zespołowym.

   2. Wybierz Start, a następnie Kompilacje

2. Na stronie Kompilacje wybierz Akcje, następnie wybierz Zarządzaj kontrolerami kompilacji.

   Zostanie wyświetlone okno dialogowe Zarządzanie kontrolerami kompilacji.

   

3. Wybierz agenta kompilacji, który chcesz zmodyfikować, a następnie wybierz Właściwości.

   Zostanie wyświetlone okno dialogowe Właściwości agenta kompilacji.

Nazwa wyświetlana, Opis: Wpisz nazwę i opis, aby pomóc członkom zespołu łatwo identyfikować agenta kompilacji.

Kontroler: Wybierz kontroler kompilacji który ma kontrolować agenta kompilacji.Kontroler kompilacji może działać na tym samym serwerze kompilacji, na którym działa agent kompilacji, lub na innym.

Zobacz sekcje poniżej, aby uzyskać dodatkowe informacje na temat sposobu konfigurowania agenta kompilacji.

Zainstaluj programu Visual Studio i inne oprogramowanie, aby umożliwić kompilację i inne możliwości

Na agencie kompilacji należy zainstalować wersję programu Visual Studio, której Twój zespół używa na swoich komputerach deweloperskich.Zobacz Instalacja programu Visual Studio.Należy również zainstalować każde inne oprogramowanie i składniki, które są zainstalowane na Twoich komputerach deweloperskich i które są wymagane do kompilowania aplikacji.

Określ katalog roboczy

Można określić katalog roboczy, z którego korzysta agent kompilacji do odczytu lub zapisu do plików.Na przykład pliki źródłowe są kopiowane do podkatalogów w tym folderze, a pliki binarne są tworzone i przechowywane w innych podkatalogach w tym folderze.

Porada
Można zwiększyć wydajność przez dedykowanie pojedynczego fizycznego dysku twardego do katalogu roboczego każdego elementu tworzącego.

Używanie tokenów katalogu roboczego

Chociaż można określić ścieżkę literału dla właściwości Katalog roboczy (na przykład c:\temp\build\), prostszym i bardziej wytrzymałym podejściem jest użycie tokenów do określenia ścieżki.Można używać dwóch rodzajów tokenów:

• Zmienne środowiskowe
  Zmienne środowiskowe zawierają informacje o środowisku systemu i użytkowniku, który jest zalogowany.Najbardziej typowa zmienna, jakiej można użyć, to SYSTEMDRIVE, ale w niektórych sytuacjach można również użyć takich zmiennych, jak USERNAME czy HOMEPATH.

  Porada
  Aby wyświetlić listę zmiennych środowiskowych na serwerze kompilacji, otwórz wiersz polecenia i wpisz set.

• Zmienne programu Team Foundation Build
  Można użyć następujących zmiennych w roboczym katalogu agenta kompilacji:

  • $(BuildAgentId): Automatycznie wygenerowana liczba całkowita, która jednoznacznie identyfikuje agenta kompilacji wewnątrz kolekcji projektu zespołowego.

  • $(BuildAgentName): Nazwa wyświetlana agenta kompilacji.

  • $(BuildDefinitionId): Automatycznie wygenerowana liczba całkowita, która jednoznacznie identyfikuje definicję kompilacji wewnątrz kolekcji projektu zespołowego.

  • $(BuildDefinitionPath): Nazwa projektu zespołowego i nazwa definicji kompilacji, oddzielone ukośnikiem.

Przykład katalogu roboczego

Na przykład masz agenta kompilacji o nazwie BuildBot3.Zdefiniowałeś dwie kompilacje, które nazywane są NightlyBuild i WeeklyBuild w projekcie zespołu, który nazywa się CoolApp.W oknie Katalog roboczy określasz następującą wartość: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath).W rezultacie agent kompilacji BuildBot3 tworzy i wykorzystuje następujące dwa katalogi robocze:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Upewnij się, że ścieżka do katalogu roboczego nie jest za długa

Określony katalog roboczy nie może powodować, że agent kompilacji wygeneruje jakiekolwiek ścieżki fizyczne zawierające więcej niż 259 znaków.W przeciwnym razie kompilacje mogą się nie udać i zarejestrują ten błąd: TF10128: The pathPhysicalPath contains more than the allowed 259 characters. Type or select a shorter path.

Aby rozwiązać ten problem, należy określić katalog roboczy zapewniający krótszą ścieżkę fizyczną.Na przykład można określić $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), co spowodowałoby katalog roboczy taki jak: c:\bld\3\2\.

Podkatalogi utworzone w katalogu roboczym

Agent kompilacji tworzy elementy i działa w poniższych podkatalogach tej ścieżki.

Podkatalog	Używane do przechowywania plików...
Sources	Odczyt przez agenta kompilacji, tak jak pliki źródłowe.Określ pliki, które pobiera w ustawieniach Obszaru roboczego dla każdej definicji kompilacji.Zobacz Praca z obszarami roboczymi kompilacji.
Binaries	Opracowane przez agenta kompilacji, takie jak pliki skompilowanej aplikacji.
TestResults	Produkowane przez jakiekolwiek testy uruchomione w agencie kompilacji.

Włącz agenta kompilacji, aby uruchomić testy

Można definiować proces konstruowania, w którym przeprowadza się jeden lub większą liczbę automatycznych testów.

Ważne
Różnego rodzaju testy i badania operacje wymagają zainstalowania na twoim agencie kompilacji tej samej wersji programu Visual Studio, której twój zespół używa na swoich komputerach dev.Zobacz Instalacja programu Visual Studio.

Agent kompilacji może uruchomić:

• Pokrycie kodu

• Kodowane testy interfejsu użytkownika (wymaga serwera kompilacji uruchomionego w trybie interaktywnym.Zobacz Uruchom serwer kompilacji w trybie interaktywnym i Weryfikowanie kodu przy użyciu automatyzacji interfejsu użytkownika.)

• Generowanie danych Test bazy danych

• Testy jednostkowe bazy danych

• Ogólne testy

• Testy obciążenia

• Testy jednostkowe

• Uporządkowane testy

• Analiza wpływu na testy

• Testy sieci Web

Przypisuj znaczniki, aby przedstawiać zadania lub funkcje agentów kompilacji

W miarę jak rośnie skala systemu kompilacji, konieczne może się okazać zdefiniowanie specjalistycznych agentów kompilacji.Zawsze, gdy agent kompilacji ma funkcje specjalne lub jest przeznaczony określonego użycia, należy przypisać jeden lub więcej znaczników do tego agenta.W ten sposób, gdy członek zespołu tworzy definicję kompilacji, która wymaga pewnego rodzaju agenta kompilacji, mogą określić znacznik w ich definicji kompilacji.

Można przypisać tagi z okna dialogowego właściwości Agenta kompilacji opisanego powyżej.Możesz wtedy zastosować znaczniki do definicji kompilacji.

Poniższa tabela zawiera przykłady nazw znaczników i funkcji agenta kompilacji, które mogą one reprezentować.

Można zastosować następujący znacznik...	Aby zidentyfikować agenta kompilacji, który może...
x86	Kompiluj aplikację 32-bitową
x64	Kompiluj aplikację 64-bitową
bvt	Uruchom testy BVT, które są uruchamiane przez nocną kompilację BVT.
Sklep Windows	Kompiluj i testuj aplikację Windows Store.
IIS	Kompiluj aplikację sieci Web ASP.NET a następnie umieść i hostuj ją na komputerze, na którym uruchomiony jest agent kompilacji.
interaktywny	Wykonaj zadań wymagające agenta na serwerze kompilacji, działającego w trybie interakcyjnym.

Można zastosować więcej niż jeden tag do agenta kompilacji.Na przykład można utworzyć agenta kompilacji z tagami x86 i Wydanie, aby wskazać agenta, który jest skonfigurowany do kompilowania konfiguracji wydania 32-bitowej aplikacji.

Po uruchomieniu wielu agentów kompilacji na tym samym serwerze kompilacji oni prawdopodobnie będą mieć takie same możliwości.Dlatego prawdopodobnie zechcesz zastosować te same znaczniki do wszystkich agentów kompilacji na tym serwerze kompilacji.

Usuń agenta kompilacji

1. W programie Visual Studio otwórz okno dialogowe Zarządzaj kontrolerami kompilacji, jak wyjaśniono wcześniej w Twórz i modyfikuj agenta kompilacji.

2. Wybierz agenta kompilacji, który chcesz usunąć, a następnie wybierz Usuń.

Porada
Możesz również użyć konsoli administracyjnej Team Foundation, aby usunąć agenta kompilacji podczas zalogowania na serwerze kompilacji.

Kolejne kroki

• Możliwość skalowania systemu Team Foundation Build
  Wraz z powiększaniem się zespołu i kodu bazy, możesz stopniowo rozwijać system kompilacji względnie łatwo.

• Zarządzaj systemem kompilacji
  Czasami będziesz potrzebował monitorowania i zarządzania systemem kompilacji.

• Używanie systemu kompilacji do kompilowania, testowania i wdrażania aplikacji
  Po zapewnieniu systemu kompilacji zespół jest gotowy do tworzenia prostego procesu kompilacji (na przykład kompilacji ciągłej integracji) i korzystania z automatycznego kompilowania i testowania aplikacji.