Konfigurowanie i uruchamianie generatora demonstracyjnego usługi Azure DevOps lokalnie

Azure DevOps Services

Ważne

Usługa Azure DevOps Demo Generator nie jest obsługiwana

Firma Microsoft zaprzestała dalszego opracowywania i inwestowania w generator demonstracyjny usługi Azure DevOps. Chociaż to narzędzie udostępnia cenne funkcje tworzenia wstępnie skonfigurowanych projektów Azure DevOps z przykładowymi danymi, firma koncentruje swoje zasoby na innych możliwościach platformy, które lepiej obsługują zmieniające się potrzeby klientów.

Zalecane alternatywy:

  • Ręcznie twórz projekty Azure DevOps przy użyciu przewodników wprowadzających.
  • Użyj interfejsu wiersza polecenia Azure DevOps do automatycznej konfiguracji projektu.
  • Zapoznaj się z interfejsami API REST Azure DevOps dla niestandardowych skryptów tworzenia projektu.

Projekt Azure DevOps Demo Generator można uruchomić jako aplikację konsolową lub plik wykonywalny na komputerze lokalnym. Takie podejście zapewnia większą kontrolę nad wykonywaniem narzędzia i umożliwia dostosowanie jego zachowania w określonych scenariuszach.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że na maszynie są zainstalowane następujące składniki:

Konfigurowanie lokalne generatora demonstracji.

Wykonaj następujące kroki, aby skonfigurować i uruchomić generator demonstracyjny na komputerze lokalnym:

  1. Sklonuj repozytorium generatora demonstracyjnego usługi Azure DevOps na komputer lokalny:

    git clone https://github.com/microsoft/AzDevOpsDemoGenerator.git
    cd AzDevOpsDemoGenerator
    
  2. Otwórz plik rozwiązania ADOGenerator.sln w programie Visual Studio lub preferowanym środowisku IDE.

  3. W programie Visual Studio należy ustawić projekt startowy.

    1. Kliknij prawym przyciskiem myszy projekt ADOGenerator w Eksploratorze rozwiązań.
    2. Wybierz Ustaw jako projekt startowy.
  4. Skompiluj rozwiązanie, aby przywrócić wszystkie zależności i upewnić się, że projekt kompiluje się pomyślnie:

    1. W programie Visual Studio: Kliknij prawym przyciskiem myszy rozwiązanie w Eksploratorze rozwiązań i wybierz pozycję Kompiluj rozwiązanie.
    2. Z wiersza polecenia:
    dotnet build
    
  5. Uruchom projekt jako aplikację konsolową przy użyciu jednej z następujących metod:

    1. W programie Visual Studio: Naciśnij F5 lub wybierz przycisk Start .
    2. Z wiersza polecenia:
    dotnet run --project src/ADOGenerator/ADOGenerator.csproj
    

Tworzenie pliku wykonywalnego

Utwórz autonomiczny plik wykonywalny, który można dystrybuować lub uruchamiać na maszynach bez zestawu .NET SDK:

Publikowanie projektu

W programie Visual Studio:

  1. Kliknij prawym przyciskiem myszy projekt ADOGenerator w Eksploratorze rozwiązań.
  2. Wybierz Publikuj.
  3. Postępuj zgodnie z monitami, aby skonfigurować ustawienia publikowania (folder docelowy, konfiguracja, środowisko uruchomieniowe).

Z wiersza polecenia:

dotnet publish src/ADOGenerator/ADOGenerator.csproj -c Release -r win-x64 --self-contained

Uruchamianie pliku wykonywalnego

Przejdź do opublikowanego katalogu i uruchom plik wykonywalny:

cd src/ADOGenerator/bin/Release/net8.0/win-x64/publish
./ADOGenerator.exe

Zagadnienia dotyczące konfiguracji

Podczas lokalnego uruchamiania generatora demonstracyjnego usługi Azure DevOps należy pamiętać o następujących czynnikach:

  • Pliki konfiguracji: upewnij się, że wymagane pliki konfiguracji (takie jak appsettings.json) znajdują się w katalogu wyjściowym.
  • Zależności: sprawdź, czy wszystkie niezbędne zależności są uwzględnione w danych wyjściowych kompilacji.
  • Uprawnienia: aplikacja wymaga odpowiednich uprawnień dostępu do usług Azure DevOps.
  • Dostęp do sieci: Upewnij się, że maszyna może nawiązać połączenie z usługą Azure DevOps Services za pośrednictwem protokołu HTTPS.

Rozwiązywanie problemów

Jeśli wystąpią problemy podczas konfigurowania lub uruchamiania generatora demonstracyjnego:

  1. Sprawdź dane wyjściowe konsoli: Przejrzyj komunikaty o błędach w konsoli, aby uzyskać informacje o konkretnych problemach.
  2. Sprawdź zależności: upewnij się, że wszystkie wymagane pakiety i zależności zostały prawidłowo przywrócone.
  3. Sprawdź poprawność konfiguracji: Sprawdź, czy pliki konfiguracji zawierają poprawne ustawienia i wartości.
  4. Sprawdź łączność: Zweryfikuj łączność sieciową z usługami Azure DevOps Services.
  5. Sprawdź wersję platformy .NET: Upewnij się, że używasz poprawnej wersji zestawu .NET SDK.

Podejścia alternatywne

Ponieważ firma Microsoft nie aktywnie opracowuje generatora demonstracyjnego, rozważ następujące alternatywy dla automatyzacji projektu: