Diagnozowanie problemów Twojej kompilacji

Diagnozowanie i rozwiązywanie problemów związanych z kompilacją jest typowym zadaniem podczas tworzenia oprogramowania.Program Team Foundation Build oferuje narzędzia pomocne przy debugowaniu i rozwiązywaniu problemów, takich jak:

• Kompilacje nieudane lub częściowo udane

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

• Nieoczekiwane zdarzenia lub wyniki

Co chcesz zrobić?

• Określ, dlaczego kompilacja nie działa

• Poszukaj informacji o problemie w oknie wyników kompilacji

• Żądaj i przeglądaj dzienniki diagnostyki

• Sprawdź system kompilacji i debuguj proces kompilacji

• Uzyskaj więcej porad

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.

Określ, dlaczego kompilacja nie działa

Jeśli kompilacja jest następna w kolejce, ale nadal nie działa, upewnij się, że kontroler kompilacji i co najmniej jeden z jego agentów kompilacji jest dostępny i włączony.Jeśli proces kompilacji ma filtry agentów kompilacji, upewnij się, że agent kompilacji, który spełnia kryteria, jest dostępny i włączony.Zobacz sekcję Zarządzanie systemem kompilacji, Określ, którzy agenci kompilacji mają przetwarzać kompilację i Wdrażanie i konfigurowanie agentów kompilacji.

Poszukaj informacji o problemie w oknie wyników kompilacji

Jeśli kompilacja jest uruchomiona, zablokowana w pewnej części procesu lub zakończona, można uzyskać więcej informacji o problemach w oknie wyników kompilacji.Wybierz Pokaż dziennik, aby wyświetlić bardziej szczegółowe informacje:

• Aby przejść bezpośrednio do problemów w kompilacji, wybierz opcję Następny błąd lub Następne ostrzeżenie.

• Po wyświetleniu wystąpień łącza Pliku dziennika MSBuild wybierz je, aby uzyskać bardziej szczegółowe informacje o zdarzeniach, które wystąpiły podczas kompilowania kodu przez aktywność MSBuild i wykonywania innych zadań.

• Można kopiować informacje i, jeśli się chce, udostępnić je osobom, które mogą pomóc rozwiązać te problemy.Wybierz określone fragmenty w dzienniku lub otwórz menu kontekstowe z dowolnego miejsca w dzienniku, a następnie wybierz polecenie Zaznacz wszystko.Następnie można otworzyć menu kontekstowe i wybrać polecenie Kopiuj, aby skopiować tekst do schowka.

Wyświetlanie dzienników diagnostyki

Jeśli nadal nie ma wystarczających informacji, aby zdiagnozować problem, można wyświetlić bardziej szczegółowe dzienniki diagnostyki.W oknie wyników kompilacji wybierz opcję Diagnostyka, a następnie:

• Jeśli kompilacja zostanie zakończona, wybierz opcję Końcowe dzienniki na date and time.

• Jeśli kompilacja nie jest jeszcze zakończona, wybierz opcję Dziennik żądań.

  

  System składa dzienniki.

  Jeśli dzienniki są gotowe, wybierz opcję Diagnostyka, Począwszy od date and time dla User who requested the log.

Jeśli Twoje etapy kompilacji generują dane wyjściowe do ścieżki UNC folderu docelowego, system otwiera podfolder folderu docelowego zawierający dzienniki diagnostyki.Po otwarciu folderu docelowego lub pobraniu pliku .zip można wyświetlić jeden z poniższych dzienników:

• Z kontrolera kompilacji: ActivityLog

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

• Dla każdego rozwiązania skompilowanego przez działanie programu MSBuild: Solution_Name

Najlepszym sposobem wyświetlenia tych dzienników jest ich skopiowanie na maszynę deweloperską i otwarcie stamtąd.

[!UWAGA]

Jeśli korzystasz z programu Visual Studio 2010, menu Diagnostyka nie jest wyświetlane w oknie wyników kompilacji, ale można nadal przeglądać dzienniki diagnostyki w folderze docelowym, gdy kompilacja jest ukończona.

Sprawdź system kompilacji i debuguj proces kompilacji

Przyczyną niektórych problemów może być lokalny system kompilacji.

Porada
Należy wypróbować wdrażanie maszyny deweloperskiej jako serwera kompilacji, tak aby łatwiej można było uzyskać bezpośredni dostęp do środowiska, w którym jest uruchomiony proces kompilacji.Zobacz sekcję Wdrażanie i konfigurowanie serwera kompilacji.

Sprawdź składniki systemu kompilacji

Upewnij się, że serwer kompilacji, kontroler i agent są poprawnie skonfigurowane.Zobacz sekcję Wdrażanie i konfigurowanie serwera kompilacji, Wdrażanie i konfigurowanie kontrolera kompilacji i Wdrażanie i konfigurowanie agentów kompilacji.

Zaloguj się do serwera kompilacji i potwierdź, że działa on poprawnie.Można również przeglądać szczegółowe dane diagnostyczne na serwerze kompilacji.Zobacz sekcję Zarządzanie systemem kompilacji.

Debuguj proces kompilacji na serwerze kompilacji

Aby zdiagnozować problemy spowodowane przez niestandardowy proces kompilacji lub nieprzechwycone wyjątki, spróbuj debugować proces kompilacji na serwerze kompilacji.

1. Zaloguj się do serwera kompilacji.

2. Uruchom program Visual Studio jako administrator.

3. W programie Visual Studio z paska menu wybierz Narzędzia, Dołącz do procesu.

4. W oknie dialogowym Dołącz do procesu:

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

   2. Wybierz plik TFSBuildServiceHost.exe.

   3. Wybierz opcję Dołącz.

5. Na pasku menu wybierz kolejno Debuguj, Wyjątki.W oknie dialogowym Wyjątki wybierz Wyjątki środowiska uruchomieniowego języka wspólnego.Wybierz przycisk OK.

6. Na pasku menu wybierz kolejno Narzędzia, Opcje.W oknie dialogowym Opcje w okienku drzewa wybierz Debugowanie.Na liście Ogólne wyczyść pole wyboru Włącz funkcję tylko mój kod.Wybierz przycisk OK.

7. W programie Visual Studio należy wykonać kompilację w kolejce i upewnić się, że działa na kontrolerze kompilacji i serwerze kompilacji, które są obsługiwane przez serwer kompilacji, na którym włączono debugera.

Można teraz debugować wyjątki, które powstały podczas procesu tworzenia, jak również ustalić punkty przerwania i debugować aktywności niestandardowego procesu kompilacji.Zobacz sekcję Debugowanie w Visual Studio.

Porady

• Diagnozując problemy z procesem kompilacji, możesz oszczędzić czas swój i członków zespołu, wstrzymując go do czasu naprawienia procesu:

  • Edytuj definicję kompilacji, a następnie w dolnej części karty Ogólne wybierz polecenie Wstrzymany.

  • Aby przetestować poprawki do procesu kompilacji, zaznacz kompilacja w kolejce, otwórz jej menu kontekstowe, a następnie wybierz polecenie Rozpocznij teraz.

• Jeśli składniki systemu kompilacji mogą być przyczyną jednego z problemów, można uruchomić, zatrzymać lub ponowne uruchomić serwer kompilacji albo włączyć lub wyłączyć kontroler bądź agenta, stosownie do potrzeb.Zobacz sekcję Zarządzanie systemem kompilacji.

• Często podczas próby rozwiązania problemów z procesem kompilacji należy wielokrotnie umieścić w kolejce kompilację z tymi samymi opcjami, aby przetestować różne poprawki.Można szybko odtworzyć strukturę:

  • Z okna wyników kompilacji, wybierając kolejno Akcje > Ponów próbę kompilacji.

  • Ze strony Kompilacje w programie Team Explorer lub z programu Build Explorer, wybierając ukończoną kompilację, otwierając menu kontekstowe i wybierając polecenie Ponów próbę kompilacji.

• Czy używasz obsługiwanego kontrolera kompilacji?Zobacz sekcję Użyj obsługiwanego kontrolera kompilacji.