Udostępnij za pośrednictwem


Wdrażanie i konfigurowanie agentów kompilacji

Aby użyć Team Foundation Build, zespół musi mieć co najmniej jednego agenta kompilacji do wykonywania pracy obciążenie procesora proces kompilacji.

Kompilacja dwóch serwerów

Każdy agent kompilacji jest poświęcony i kontrolowana przez kontrolera kompilacja pojedynczy.Agentów kompilacji może znajdować się na tym samym serwerze kompilacji, obsługującego ich kontrolera kompilacja, ale nie jest to wymagane, a w niektórych przypadkach potrzeb drużyny podtrzymywanych może zostać spełniony poprzez serwer kompilacji pojedynczej do kontrolera kompilacja, które formanty budować agentów na wielu serwerach kompilacji hosta.

Agent kompilacji wykonuje kroki znajdujących się w proces kompilacji AgentScope aktywności.Kroki te obejmują zazwyczaj pobieranie plików z kontroli wersji, obsługa administracyjna obszaru roboczego, kompilowanie kodu, wykonywanie testów i scalanie plików do kontroli wersji.

Upewnij się, serwer kompilacji, który obsługuje agentów budować ma wystarczające możliwości przechowywania i przetwarzania, aby dopasować rozmiar i złożoność kodu i testy na Kolekcja projektów zespołu.Zazwyczaj należy udostępniać nie więcej niż jeden agent budować na każdy rdzeń procesora na serwerze kompilacji.Można również zwiększyć wydajność przez przeznaczenie jeden fizyczny dysk twardy do katalog roboczy każdego agenta kompilacji.

PoradaPorada

Jeśli Twój Kolekcja projektów zespołu jest utrzymywana na Team Foundation Servicei potrzeb drużyny można spełnić przez agenta budować jeden standard, można użyć Gospodarzem kontroler budować zamiast wdrażać agent kompilacji.

Wymagane są uprawnienia

Musisz być członkiem grupy Administratorzy systemu Windows na serwerze kompilacji i jest członkiem grupy Administratorzy zbudować kolekcji projektu na Twojej kolekcji projektu zespołu.Zobacz Team Foundation Uprawnienia serwera.

Co chcesz zrobić?

Tworzenie lub modyfikowanie agent kompilacji

Aby utworzyć lub zmodyfikować agent kompilacji z serwera kompilacji

  1. Zaloguj się na budowy serwera , który chcesz skonfigurować.

  2. Z menu Start systemu Windows, uruchom Konsoli administracyjnej programu Team Foundation.

    Konsoli administracyjnej programu Team Foundation jest wyświetlany.

  3. W okienku drzewa konsoli administracyjnej programu Team Foundation, rozwiń nazwę serwera, a następnie wybierz Zbudować konfiguracji węzła.

    Informacje na temat serwera kompilacji pojawia się w okienku Zawartość.

    Jeśli wiadomość Konfigurowanie zainstalowane funkcjeSkonfigurować zainstalowane funkcje pojawi się, zobacz Wdrażanie serwera kompilacji.

  4. Na stronie Tworzenie konfiguracji:

    • Aby utworzyć nowy agent kompilacji, wybierz polecenie Nowy Agent.

    • Aby zmodyfikować istniejący agent kompilacji

      Budowanie agenta

      Wybierz polecenie Właściwości.

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

Aby zmodyfikować agent kompilacji z programu Visual Studio

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

    1. Jeśli nie nawiązano już do zespołu projektu w Kolekcja projektów zespołu, następnie połączenia z projektem zespołu.

    2. Wybierz Ikona domuStart, a następnie Tworzy ikonęKompilacje

  2. Na stronie buduje wybierz opcję Akcje, a następnie Zarządzanie kontrolerami budować.

    Zarządzanie kontrolerami budować pojawi się okno dialogowe.

    Okno dialogowe Tworzenie kontrolerów grochu

  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.

Tworzenie okna dialogowego właściwości agenta

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

Kontroler: Wybierz zbudować kontroler chcesz sterować tym agentem kompilacji.Kontrolera kompilacja można uruchomić na tym samym serwerze budować jako agent tej kompilacji lub na serwerze różnych kompilacji.

Można znaleźć w sekcjach poniżej szczegółowe informacje na temat sposobu konfigurowania agent kompilacji.

Instalowanie programu Visual Studio i innego oprogramowania, aby włączyć kompilacji i inne możliwości

Jest najlepszym rozwiązaniem w agencie kompilacji należy zainstalować wersję Visual Studio, że Twój zespół używa na swoich komputerach odchylenia standardowego.Zobacz Instalacja programu Visual Studio.Należy również zainstalować oprogramowania i składników, które są instalowane na Twoim komputerze odchylenia standardowego, które są wymagane do budowania aplikacji.W przeciwnym razie mogą wystąpić problemy, takie jak niektóre projekty kodu nie można skompilować.

Określić katalog roboczy

Można określić katalog roboczy, który korzysta z agenta 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 inne podkatalogi, w tym folderze.

PoradaPorada

Można zwiększyć wydajność przez przeznaczenie jeden fizyczny dysk twardy do katalog roboczy każdego agenta kompilacji.

Bb399135.collapse_all(pl-pl,VS.110).gifUżyj tokenów katalogu roboczym

Mimo że można określić ścieżkę literału dla Katalog roboczy właściwości (na przykład c:\temp\build\), prostsze i bardziej wytrzymałe podejście 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 dla systemu i użytkownika, który jest zalogowany.Zmienna najbardziej typowe, można użyć jest SYSTEMDRIVE, ale w niektórych sytuacjach można również używać zmiennych takich jak USERNAME lub HOMEPATH.

    PoradaPorada

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

  • Zmienne Foundation Budowanie zespołu
    Można użyć następujących zmiennych w agencie kompilacji, praca katalog:

    • $(BuildAgentId): Automatycznie wygenerowane całkowitą, która jednoznacznie identyfikuje agent kompilacji wewnątrz Kolekcja projektów zespołu.

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

    • $(BuildDefinitionId): Automatycznie wygenerowane całkowitą, która jednoznacznie identyfikuje budować definicja w ramach Kolekcja projektów zespołu.

    • $(BuildDefinitionPath): Nazwa i Nazwa definicji kompilacji, oddzielonych ukośnikiem projektu zespół.

Bb399135.collapse_all(pl-pl,VS.110).gifPrzykład katalog roboczy

Na przykład masz agent kompilacji, o nazwie BuildBot3.Zdefiniowano dwie wersje, które są wywoływane NightlyBuild i WeeklyBuild w projekcie zespołu, który nosi nazwę CoolApp.W Katalog roboczy pole, można określić następującą wartość: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath).W efekcie agenta build BuildBot3 tworzy i wykorzystuje następujące dwa katalogi robocze:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Bb399135.collapse_all(pl-pl,VS.110).gifUpewnij się, że ścieżka do katalogu roboczego nie jest za długa

Katalog roboczy, który określisz nie mogą powodować agent kompilacji do produkcji ścieżki fizyczne, które są dłuższe niż 259 znaków.W przeciwnym razie swoje buduje może zakończyć się niepowodzeniem i ten błąd logowania: TF10128: The pathŚcieżka_fizyczna contains more than the allowed 259 characters. Type or select a shorter path.

Aby rozwiązać ten problem, należy określić katalog roboczy, że wyniki w krótszej ścieżki fizycznej.Na przykład można określić $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), mogących doprowadzić do katalogu roboczego, takie jak: c:\bld\3\2\.

Bb399135.collapse_all(pl-pl,VS.110).gifPodkatalogi, utworzone w katalogu roboczym

Agent Kompilacja tworzy i działa w następujących podkatalogi dla danej ścieżki.

Podkatalog

Używany do przechowywania plików...

Sources

Odczytane przez przedstawiciela kompilacji, takie jak pliki źródłowe.Określ pliki, które pliki do pobrania w obszar roboczy ustawienia dla każdego zbudować definicji.Zobacz Praca z obszarami roboczymi kompilacji.

Binaries

Opracowane przez przedstawiciela kompilacji, takie jak pliki skompilowanej aplikacji.

TestResults

Produkcja niezależnie od badań uruchomiono agenta kompilacji.

Włącz biura kompilacji uruchomić testy

Można zdefiniować kompilacji proces wykonuje jeden lub więcej automatycznych kolorów testów.

Ważna uwagaWażne

Wiele rodzajów testów i badań operacje wymagają zainstalowania na agent kompilacji tej samej wersji programu Visual Studio, że Twój zespół używa na swoich komputerach odchylenia standardowego.Zobacz Instalacja programu Visual Studio.

Można uruchomić agenta kompilacji:

Przypisz tagi przedstawiające celów lub funkcjami agentów kompilacji

W skali systemu kompilacji rośnie, należy Definiowanie agentów specjalistyczne kompilacji.W każdym przypadku, gdy agent kompilacji ma specjalne funkcje lub jest przeznaczony do określonego rodzaju sposób użycia, należy przypisać jeden lub więcej znaczników do tego agenta.W ten sposób gdy członek zespołu tworzy budować definicja, która wymaga pewnego rodzaju kompilacji agent mogą określać tagu w swojej definicji kompilacji.

Można przypisać znaczniki z okno dialogowe właściwości agenta budować, opisane powyżej.Możesz wtedy zastosować znaczniki do definicji build.

Poniższej tabeli zamieszczono przykładów nazw znaczników i funkcjami agentów kompilacji, które reprezentują może.

Można zastosować następujący tag...

Aby zidentyfikować agenta kompilacji, które mogą...

x 86

Kompilować aplikacje 32-bitowe

x 64

Kompilować aplikacji 64-bitowych

BVT

Uruchomić testy BVT, w których są uruchamiane przez użytkownika Budowanie w ramach nocnego BVT.

WindowsStore

Skompilować i przetestować aplikację magazynu systemu Windows.

USŁUGI IIS

Skompiluj aplikacji ASP.NET sieci Web i następnie etap i udostępniają go na komputerze, na którym jest uruchomiony agent kompilacji.

interaktywne

Wykonywanie zadań, które wymagają agent w serwera kompilacji, działający w tryb interakcyjny.

Można zastosować więcej niż jeden tag agentem kompilacji.Na przykład możesz tworzyć agent kompilacji z tagi x 86 i Zwolnij, aby wskazać czynnikiem, który jest skonfigurowany do kompilowania Konfiguracja wersji 32-bitowej aplikacji.

Po uruchomieniu wielu agentów budować na tym samym serwerze kompilacji one prawdopodobnie będą miały takie same możliwości.W związku z tym prawdopodobnie chcesz zastosować te same znaczniki dla wszystkich podmiotów budować na tym serwerze kompilacji.

Usuń agent kompilacji

  1. W Visual Studio, otwórz Zarządzanie kontrolerami budować okno dialogowe, jak wyjaśniono wcześniej w Tworzenie lub modyfikowanie agenta budować.

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

PoradaPorada

Umożliwia także konsoli administracyjnej programu Team Foundation do usunięcia agent kompilacji, gdy jesteś w stanie zalogowania na budowy serwera.

Kolejne kroki