Przygotowywanie środowiska deweloperskiego w systemie Windows

Aby kompilować i uruchamiać aplikacje usługi Azure Service Fabric na maszynie deweloperskiej z systemem Windows, należy zainstalować środowisko uruchomieniowe, zestaw SDK oraz narzędzia usługi Service Fabric. Należy również włączyć wykonywanie skryptów programu Windows PowerShell zawartych w zestawie SDK.

Wymagania wstępne

Upewnij się, że używasz obsługiwanej wersji systemu Windows.

Pobieranie i instalowanie środowiska uruchomieniowego i zestawu SDK

Uwaga

Interfejs WebPI używany wcześniej na potrzeby instalacji zestawu SDK/narzędzi został wycofany 1 lipca 2022 r.

Środowisko uruchomieniowe można zainstalować niezależnie. Jednak zestaw SDK wymaga środowiska uruchomieniowego, więc w przypadku środowiska deweloperskiego należy zainstalować środowisko uruchomieniowe i zestaw SDK. Poniższe linki są pobierane dla najnowszych wersji środowiska uruchomieniowego i zestawu SDK:

Pakiet Wersja
Instalowanie środowiska uruchomieniowego usługi Service Fabric dla systemu Windows 10.1.1951.9590
Instalowanie zestawu SDK usługi Service Fabric 7.1.1951

Możesz znaleźć bezpośrednie linki do instalatorów dla poprzednich wydań w wersjach usługi Service Fabric.

Aby uzyskać obsługiwane wersje, zobacz Wersje usługi Service Fabric.

Instalowanie środowiska uruchomieniowego

Instalator środowiska uruchomieniowego musi zostać uruchomiony z poziomu powłoki wiersza polecenia i należy użyć flagi /accepteula . Zalecamy uruchomienie powłoki wiersza polecenia z podwyższonym poziomem uprawnień, aby zachować wydruki dziennika. Poniższy przykład dotyczy programu PowerShell:

.\MicrosoftServiceFabric.<version>.exe /accepteula

Instalacja zestawu SDK

Po zainstalowaniu środowiska uruchomieniowego można pomyślnie zainstalować zestaw SDK. Instalator można uruchomić z poziomu powłoki wiersza polecenia lub Eksploratora plików.

Uwaga

Klastry pojedynczej maszyny (OneBox) nie są obsługiwane w przypadku uaktualnień aplikacji lub klastra; usuń klaster OneBox i utwórz go ponownie, jeśli chcesz przeprowadzić uaktualnienie klastra lub wystąpią problemy z uaktualnieniem aplikacji.

Aby użyć programu Visual Studio 2017 lub 2019

Narzędzia Service Fabric Tools są częścią obciążenia Programowanie na platformie Azure w programach Visual Studio 2019 i 2017. Włącz to obciążenie w ramach instalacji programu Visual Studio. Ponadto należy zainstalować zestaw SDK i środowisko uruchomieniowe usługi Microsoft Azure Service Fabric zgodnie z opisem powyżej Pobierz i zainstaluj środowisko uruchomieniowe i zestaw SDK.

Włączanie wykonywania skryptów programu PowerShell

Platforma Service Fabric korzysta ze skryptów programu Windows PowerShell do tworzenia lokalnego klastra projektowego i do wdrażania aplikacji z programu Visual Studio. Domyślnie system Windows blokuje uruchamianie tych skryptów. Aby je włączyć, należy zmienić zasady wykonywania w programie PowerShell. Uruchom program PowerShell jako administrator i wprowadź następujące polecenie:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Instalowanie platformy Docker (opcjonalnie)

Usługa Service Fabric to orkiestrator kontenerów służący do wdrażania mikrousług w klastrze maszyn. Aby uruchamiać aplikacje kontenera systemu Windows w lokalnym klastrze programistycznym, należy najpierw zainstalować platformę Docker dla systemu Windows. Pobierz aplikację Docker CE dla systemu Windows (stabilna). Po zainstalowaniu i uruchomieniu platformy Docker kliknij prawym przyciskiem myszy ikonę zasobnika i wybierz pozycję Przełącz do kontenerów systemu Windows. Ten krok jest wymagany do uruchomienia obrazów platformy Docker opartych na systemie Windows.

Następne kroki

Po zakończeniu konfigurowania środowiska projektowego rozpocznij tworzenie i uruchamianie aplikacji.