Wdrażanie i konfigurowanie kontrolera kompilacji

Aby używać programu Team Foundation Build, zespół musi mieć co najmniej jeden kontroler kompilacji umożliwiający wykonywanie lekkich zadań oraz rozdzielanie prac kompilacyjnych intensywnie obciążających procesor między agentów kompilacji istniejących w puli.

Każdy kontroler kompilacji jest dedykowany kolekcji jednego zespołu projektu.Kontroler kompilacji wykonuje niektóre lżejsze zadania, takie jak określanie nazwy kompilacji, tworzenie etykiet w mechanizmie kontroli wersji, rejestrowanie notatek i informowanie o stanie kompilacji.Za pomocą działania AgentScope kontroler deleguje zadania intensywnie wykorzystujące procesor, takie jak kompilacja kodu czy wykonywanie testów, do agentów kompilacji w swojej puli agentów.Agenty kompilacji mogą się znajdować na tym samym lub innym serwerze kompilacji.

Ponieważ kontroler kompilacji zazwyczaj nie angażuje mocno procesora, często można go umieścić na tym samym komputerze co serwer Team Foundation Server, jak pokazano powyżej, lub na fizycznej lub wirtualnej maszynie o małej mocy.

Jednak w pewnych sytuacjach kontroler kompilacji może wymagać znacznej ilości pamięci, dlatego należy zadbać o odpowiednie zasoby pod tym względem.Ewentualnie, w zależności od potrzeb i zasobów zespołu, kontroler kompilacji można hostować na komputerze innym niż komputer z programem Team Foundation Server.

Wymagane uprawnienia

Musisz być członkiem grupy Administratorzy systemu Windows na serwerze kompilacji oraz członkiem grupy Administratorzy kompilacji kolekcji projektów w kolekcji projektu zespołowego.Zobacz sekcję Uprawnienia serwera programu Team Foundation Server.

Co chcesz zrobić?

• Utworzyć lub zmodyfikować kontrolera kompilacji

• Umożliwić procesom kompilacji używanie dodatkowych plików binarnych

• Określić maksymalną liczbę kompilacji wykonywanych współbieżnie

• Usunąć kontroler kompilacji

• Używać kontrolera kompilacji w kolekcji projektów zespołowych hostowanej w programie Visual Studio Online

Utworzyć lub zmodyfikować kontrolera kompilacji

Aby utworzyć lub zmodyfikować kontroler kompilacji z serwera kompilacji

1. Zaloguj się na serwerze kompilacji.

2. W systemie Windows z menu Start uruchom program Konsola administracyjna programu Team Foundation.

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

   [!UWAGA]

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

4. Na stronie Konfiguracja kompilacji:

   • Jeśli kontrolera nie ma na liście, wybierz opcję Nowy kontroler.

   • Jeśli kontroler jest już na liście:

     

     Kliknij przycisk Właściwości.

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

Aby zmodyfikować kontroler kompilacji z programu Visual Studio

1. W programie Visual Studio w oknie Team Explorer:

   1. Jeśli nie masz jeszcze połączenia z projektem zespołowym w kolekcji projektów zespołowych, utwórz połączenie z projektem zespołowym.

   2. Kliknij przycisk Strona główna i wybierz opcję Kompilacje.

2. Na stronie Kompilacje wybierz kolejno opcje Akcje i Zarządzaj kontrolerami kompilacji.

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

   

3. Zaznacz kontroler kompilacji, który chcesz zmodyfikować, i kliknij przycisk Właściwości.

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

W polach Nazwa wyświetlana i Opis: wpisz nazwę i opis, które pomogą członkom zespołu łatwo identyfikować odpowiedni kontroler kompilacji podczas konfigurowania procesów kompilacji.

W rozdziałach poniżej szczegółowo opisano konfigurowanie kontrolera testów.

Umożliwić procesom kompilacji używanie dodatkowych plików binarnych

Procesom kompilacji można pozwolić na używanie plików binarnych przekazanych do serwera programu Team Foundation Server. Oto przykładowe rodzaje takich plików:

• Zestawy zawierające niestandardowe działania przepływu pracy.Zobacz sekcję Używanie i opracowywanie czynności niestandardowego procesu kompilacji.

• Środowiska wykonywania testów jednostkowych pochodzące od innych producentów.Zobacz Uruchamianie testów w procesie kompilacji.

• Niestandardowe zadania MSBuild.

Aby umożliwić procesom kompilacji wykorzystywanie tego typu kodu, przekaż pliki do folderu określonego w polu Ścieżka kontroli wersji do zestawów niestandardowych (lub do jego któregokolwiek folderu podrzędnego).Po wprowadzeniu lub zmodyfikowaniu wartości w tym polu serwer kompilacji zostanie automatycznie ponownie uruchomiony, aby załadować zestawy.

Porada
Jeśli w wynikach kompilacji znajduje się komunikat o błędzie TF215097, być może proces kompilacji zawiera niestandardowe działanie, którego nie ma w tym folderze ani jego żadnym folderze podrzędnym.

Określić maksymalną liczbę kompilacji wykonywanych współbieżnie

Najczęściej należy pozostawić wartość Domyślna liczba włączonych agentów.Jednak czasami trzeba samodzielnie ustalić głębokość kolejki kompilacji.Na przykład:

• Widzisz, że zbyt wiele kompilacji wykazuje stan Uruchomiony, chociaż wiele z nich jest zawieszonych, ponieważ oczekują na przypisaniem im agentów kompilacji.Ta sytuacja może zdezorientować zespół.Aby uniknąć tego problemu, zaznacz opcję Określ liczbę maksymalną i wprowadź wartość, która jest mniejsza od liczby agentów kompilacji w puli kontrolera kompilacji.

• Projektujesz niestandardowy szablon kompilacji, aby umożliwić kompilacjom korzystanie równocześnie z kilku agentów kompilacji należących do puli 12 agentów na kontrolerze kompilacji.Kompilacje przetwarzane przez ten kontroler kompilacji bazują na niestandardowym szablonie kompilacji, który deleguje jednocześnie do trzech agentów kompilacji.Aby dane z kolejki kompilacji były bardziej użyteczne, możesz na kontrolerze kompilacji w ustawieniu Maksymalna liczba kompilacji uruchomionych współbieżnie zaznaczyć opcję Określ liczbę maksymalną i wpisać wartość 4.

Usunąć kontroler kompilacji

1. W programie Visual Studio otwórz okno dialogowe Zarządzaj kontrolerami kompilacji w sposób opisany wyżej w rozdziale Modyfikowanie kontrolera kompilacji z programu Visual Studio.

2. Zaznacz, a następnie usuń, każdego agenta kompilacji należącego do kontrolera kompilacji. W tym celu kliknij przycisk Usuń albo kliknij przycisk Właściwości, a w oknie dialogowym Właściwości agenta kompilacji przypisz agentów do innych kontrolerów.

3. Zaznacz kontroler kompilacji, który chcesz usunąć, i kliknij przycisk Usuń.

[!UWAGA]

Będąc zalogowanym na serwerze kompilacji, w celu usunięcia kontrolera kompilacji można się posłużyć konsolą administracyjną programu Team Foundation.Jednak w takim przypadku wciąż może być konieczne użycie programu Visual Studio albo zalogowanie się najpierw na innych serwerach kompilacji i usunięcie wszelkich zdalnych agentów kompilacji należących do puli kontrolera.

Używać kontrolera kompilacji w kolekcji projektów zespołowych hostowanej w programie Visual Studio Online

Używanie hostowanego kontrolera kompilacji: Jeśli kolekcja projektów zespołowych jest hostowana w usłudze Visual Studio Online, zamiast wdrażać własny kontroler kompilacji możesz skorzystać z hostowanego kontrolera kompilacji.Aby użyć hostowanego kontrolera kompilacji, po prostu zaznacz go podczas konfigurowania procesu kompilacji.Zobacz sekcję Użyj obsługiwanego kontrolera kompilacji.

Używanie lokalnego kontrolera kompilacji: Jeśli proces kompilacji wymaga użycia zasobów wykraczających poza funkcjonalność hostowanego kontrolera kompilacji, możesz podłączyć lokalny kontroler kompilacji z hostowaną kolekcją projektów zespołowych.

Następne kroki

• Wdrażanie i konfigurowanie agentów kompilacji
  Zadania kompilacji mocno obciążające procesor można przekazać do agentów kompilacji.Dotyczy to np. pobierania plików z systemu kontroli wersji, obsługi obszaru roboczego, kompilowania kodu czy wykonywania testów.Na serwerze kompilacji można umieścić jednego lub więcej agentów kompilacji.

• Konfigurowanie folderów przechowywania
  Możesz przygotować, a następnie wyznaczyć jeden lub więcej folderów przechowywania, z których system kompilacji będzie dostarczał pliki binarne, wyniki testów i pliki dzienników do zespołu.

• Skalowanie systemu Team Foundation Build
  Wraz z powiększaniem się zespołu i kodu bazy można dość łatwo stopniowo rozbudowywać system kompilacji.

• Zarządzanie systemem kompilacji
  Po wdrożeniu serwera kompilacji można nim zarządzać z konsoli administracyjnej programu Team Foundation.Natomiast kontrolerem kompilacji i agentami kompilacji można zarządzać z konsoli administracyjnej programu Team Foundation lub z programu Visual Studio.

• Konfigurowanie procesu kompilacji
  Gdy system kompilacji jest gotowy, można przystąpić do konfigurowania procesu kompilacji. Definicja będzie zawierała instrukcje dotyczące projektów kodu wymagających skompilowania, czynności inicjujących kompilowanie, doboru testów i wszelkich innych procedur potrzebnych zespołowi.