Diagnozowanie problemów kompilacji

Diagnozować i naprawiać problemy kompilacji jest regularne zadania podczas tworzenia oprogramowania.Team Foundation Build zapewnia narzędzia ułatwiające diagnozowania i rozwiązywania problemów, takich jak:

• Buduje uszkodzonego lub częściowo pomyślne

• Wyjątki, błędy lub ostrzeżenia

• Nieoczekiwane zdarzenia lub wyników

Co chcesz zrobić?

• Ustalić, dlaczego nie działa kompilacji

• Należy szukać informacji o problemie w oknie Wyniki kompilacji

• Rozwiązywania problemów, gdy przy użyciu kontrolera gospodarzem budować

• Żądania i przeglądać dzienniki diagnostyczne

  • Pobierz dzienniki diagnostyczne, gdy używana jest do lokalnego kontrolera kompilacja

  • Uzyskać dzienniki diagnostyczne, gdy używany jest kontroler gospodarzem zbudować

  • Wyświetlanie dzienników diagnostycznych

• System kompilacji i debugowania proces kompilacji

• Więcej porad

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.

Ustalić, dlaczego nie działa kompilacji

Jeśli kompilacja jest dalej w kolejce , ale jest nadal nie działa, upewnij się, kontrolera kompilacja i co najmniej jeden z jego agentów kompilacji są dostępne i włączone.Jeśli proces kompilacji ma budować agenta filtrów, upewnij się, że agent kompilacji, który spełnia kryteria jest dostępne i włączone.Zobacz Manage Your Build System, określić, który budować agentów proces kompilacji, i Wdrażanie i konfigurowanie agentów kompilacji.

Należy szukać informacji o problemie w oknie Wyniki kompilacji

Jeśli kompilacji jest uruchomiony, tkwi w niektórych część procesu lub ukończonych, to można uzyskać więcej informacji o problemach związanych z zbudować okno wyniki.Wybierz polecenie Wyświetl dziennik Aby wyświetlić bardziej szczegółowe informacje:

• Wybierz polecenie Następny błąd lub Kolejnym ostrzeżeniem aby przejść bezpośrednio do problemów w kompilacji.

• Po wyświetleniu wystąpienia Pliku dziennika programu MSBuild łącza, wybierz ją, aby uzyskać więcej szczegółowych informacji o zdarzeniach, które wystąpiły podczas MSBuild aktywności skompilowany kod i wykonać inne zadania.

• Można skopiować informacje i, należy udostępnić go osobom, które mogą pomóc rozwiązać problemy.Zaznaczanie fragmentów dziennika lub otwarcie menu skrótów z dowolnego miejsca w dzienniku, a następnie wybierz Zaznacz wszystko.Można następnie otworzyć menu skrótów i wybrać kopię Aby skopiować tekst do Schowka.

Wyświetlanie dzienników diagnostycznych

Jeśli nie masz wystarczających informacji, aby zdiagnozować problem, można wyświetlić bardziej szczegółowe dzienniki diagnostyczne.

Pobierz dzienniki diagnostyczne, gdy używana jest do lokalnego kontrolera kompilacja

Kiedy host jest kontrolera kompilacja lokalne, dzienniki diagnostyczne są przechowywane w folder pośredniczący.W zbudować okno wyniki, wybierz polecenie Diagnostyka, a następnie:

• Jeśli kompilacja jest zakończone, wybierz polecenie końcowego dzienników jako datę i godzinę.

• Jeśli kompilacja nie jest jeszcze zakończone, wybierz polecenie Dzienniki żądań.

  

  System montuje dzienniki.

  Jeśli dzienniki są gotowe, wybierz polecenie Diagnostyka, na daty i godziny dla użytkownika, który zwrócił dziennika.

System otwiera podfolder folderu poczty odebranej, zawierający dzienniki diagnostyczne.

[!UWAGA]

Jeśli używasz programu Visual Studio 2010, Diagnostyka menu nie jest wyowietlana w oknie Wyniki kompilacji, ale można nadal przeglądać dzienniki diagnostyczne w ten folder po zakończeniu kompilacji.

Uzyskać dzienniki diagnostyczne, gdy używany jest kontroler gospodarzem zbudować

Podczas korzystania z Gospodarzem kontroler budować, zaleca się, że wybierasz kopiować budować danych wyjściowych do serwera dla tymczasowej lokalizacji.W takim przypadku dzienniki diagnostyczne są przechowywane w programie TFS i można je obejrzeć i pobrać je z przeglądarki sieci web.

W zbudować okno wyniki, wybierz polecenie Akcje, Otwórz w przeglądarce, a następnie w wyniki kompilacji w przeglądarce sieci web, wybierz Diagnostyka.Następnie można Wyświetl dzienniki , aby otworzyć menu, z którego można wybrać dziennik chcesz wyświetlić lub pobrać wszystkie dzienniki w pliku zip.

Wyświetlanie dzienników diagnostycznych

Po otwarciu folderu przechowywania lub Pobierz plik zip, można przeglądać następujące dzienniki:

• Z kontrolera kompilacja:ActivityLog

• Z każdego agenta kompilacji, które uczestniczyły w kompilacji: **ActivityLog.AgentScope.**Build_Agent_ID

• Dla każdego roztworu, opracowane przez MSBuild aktywności: Solution_Name

Najlepszym sposobem, aby wyświetlić te dzienniki jest skopiowanie plików do komputera odchylenia standardowego i otworzyć je stamtąd.

System kompilacji i debugowania proces kompilacji

Niektórych problemów może być spowodowane przez dany system budowania lokalnej.

Porada
Spróbuj wdrażanie komputera odchylenia standardowego jako serwera kompilacji, tak aby mogli łatwiej uzyskać bezpośredni dostęp do środowiska, w którym jest uruchomiony proces kompilacji.Zobacz Wdrażanie i konfigurowanie serwera kompilacji.

Sprawdź budowy podzespołów komputera

Upewnij się, że Twój serwera kompilacji, kontroler i agenta są poprawnie skonfigurowane.See Wdrażanie i konfigurowanie serwera kompilacji, Wdrażanie i konfigurowanie kontrolera kompilacji, and Wdrażanie i konfigurowanie agentów kompilacji.

Zaloguj się do serwera kompilacji i Potwierdź, że działa on poprawnie.Można również znaleźć szczegółowe dane diagnostyczne w serwera kompilacji.Zobacz Manage Your Build System.

Debugowanie procesu tworzenia na serwerze kompilacji

Do diagnozowania problemów powodowanych przez proces budowania niestandardowego działalności, lub przez nie przechwycony wyjątkami, próby debugowania procesu tworzenia na serwerze kompilacji.

1. Zaloguj się do serwera kompilacji.

2. Uruchom Visual Studio jako administrator.

3. W programie Visual Studio, na pasku menu wybierz polecenie Narzędzia, Dołącz do procesu.

4. Na Dołącz do procesu okno dialogowe:

   1. Wybierz Pokaż procesy wszystkich użytkowników.

   2. Wybierz TFSBuildServiceHost.exe.

   3. Wybierz polecenie dołączyć.

5. Wybierz polecenie z paska menu program Debug: polecenie, Wyjątki.Na Wyjątki okno dialogowe, wybierz Wyjątków CLR.Wybierz przycisk OK.

6. Z paska menu, wybierz polecenie Narzędzia, Opcje.Na Opcje okno dialogowe, w okienku drzewa, wybierz debugowanie SQL.W Ogólne listy, a następnie wyczyść Włączyć tylko kod Moje pole wyboru.Wybierz przycisk OK.

7. W programie Visual Studio kolejki budować i upewnij się, że działa pod kontrolą kontrolera kompilacja i serwera kompilacji, które są obsługiwane przez serwera kompilacji, na którym włączono debugera.

Teraz można debugować wyjątki są generowane podczas procesu tworzenia a także ustawić punkty przerwania i debugować swoje działania procesu budowania niestandardowego.Zobacz Debugowania w środowisku Visual Studio.

Porady

• Podczas, gdy są diagnozowania problemów z procesem kompilacji, wstrzymując może zapisać siebie i swoje problemy drużyny go, dopóki nie zostanie naprawiony proces:

  • Edytowanie definicji build, a następnie w dolnej części Ogólne tab, wybrać wstrzymana.

  • Po wstrzymaniu budować definicja Aby przetestować swój poprawki do procesu tworzenia, zaznacz w kolejce kompilacji, otwórz menu skrótów i wybierz polecenie Rozpocznij teraz.

• Jeśli uważasz, że jeden składnik systemu kompilacji może być przyczyną problemów, można uruchomić, zatrzymać, lub ponownie uruchomić serwer kompilacji lub włączyć lub wyłączyć kontroler lub agent w razie potrzeby.Zobacz Manage Your Build System.

• Często podczas próby rozwiązania problemów proces kompilacji, należy budować z tym samym opcje, aby przetestować różne poprawki w kolejce.Można szybko ponownie kompilacji:

  • Z zbudować okno wyniki wybierając Akcje, Ponowić próbę budować.

  • Z buduje stronę w Eksploratorze zespołu lub zbudować Explorer wybierając wypełniony kompilacji, otwarcie menu skrótów i wybierając polecenie Ponowić próbę budować.