Wdrażanie istniejącego pliku wykonywalnego w usłudze Service Fabric
W usłudze Azure Service Fabric jako usługę można uruchomić dowolny typ kodu, taki jak Node.js, Java lub C++. Usługa Service Fabric określa tego typu usługi jako pliki wykonywalne gościa.
Pliki wykonywalne gościa są traktowane przez usługę Service Fabric, na przykład usługi bezstanowe. W związku z tym są one umieszczane w węzłach w klastrze na podstawie dostępności i innych metryk. W tym artykule opisano sposób tworzenia pakietów i wdrażania pliku wykonywalnego gościa w klastrze usługi Service Fabric przy użyciu programu Visual Studio lub narzędzia wiersza polecenia.
Uwaga
Klaster usługi Service Fabric jest jedną dzierżawą zgodnie z projektem, a hostowane aplikacje są uznawane za zaufane. Jeśli rozważasz hostowanie niezaufanych aplikacji, zobacz Hosting niezaufanych aplikacji w klastrze usługi Service Fabric.
Zalety uruchamiania pliku wykonywalnego gościa w usłudze Service Fabric
Istnieje kilka zalet uruchamiania pliku wykonywalnego gościa w klastrze usługi Service Fabric:
- Wysoka dostępność. Aplikacje uruchamiane w usłudze Service Fabric są wysoce dostępne. Usługa Service Fabric zapewnia, że wystąpienia aplikacji są uruchomione.
- Monitorowanie kondycji. Monitorowanie kondycji usługi Service Fabric wykrywa, czy aplikacja jest uruchomiona, i udostępnia informacje diagnostyczne w przypadku wystąpienia awarii.
- Zarządzanie cyklem życia aplikacji. Oprócz zapewnienia uaktualnień bez przestojów usługa Service Fabric zapewnia automatyczne wycofywanie do poprzedniej wersji, jeśli podczas uaktualniania zgłoszono nieprawidłowe zdarzenie kondycji.
- Gęstość. W klastrze można uruchamiać wiele aplikacji, co eliminuje konieczność uruchamiania każdej aplikacji na własnym sprzęcie.
- Odnajdywanie: za pomocą interfejsu REST można wywołać usługę Nazewnictwa usługi Service Fabric, aby znaleźć inne usługi w klastrze.
Przykłady
- Przykład tworzenia pakietów i wdrażania pliku wykonywalnego gościa
- Przykład dwóch plików wykonywalnych gościa (C# i nodejs) komunikujących się za pośrednictwem usługi Naming przy użyciu interfejsu REST
Omówienie plików manifestu aplikacji i usługi
W ramach wdrażania pliku wykonywalnego gościa warto zrozumieć model pakowania i wdrażania usługi Service Fabric zgodnie z opisem w modelu aplikacji. Model pakowania usługi Service Fabric opiera się na dwóch plikach XML: manifestach aplikacji i usługi. Definicja schematu dla plików ApplicationManifest.xml i ServiceManifest.xml jest instalowana z zestawem SDK usługi Service Fabric w folderze C:\Program Files\Microsoft SDKs\Service Fabric\schemas\ServiceFabricServiceModel.xsd.
Manifest aplikacji Manifest aplikacji służy do opisywania aplikacji. Wyświetla listę usług, które je tworzą, oraz inne parametry używane do definiowania sposobu wdrażania co najmniej jednej usługi, na przykład liczby wystąpień.
W usłudze Service Fabric aplikacja jest jednostką wdrażania i uaktualniania. Aplikację można uaktualnić jako pojedynczą jednostkę, w której można zarządzać potencjalnymi awariami i potencjalnymi wycofywaniami. Usługa Service Fabric gwarantuje, że proces uaktualniania zakończy się pomyślnie lub, jeśli uaktualnienie zakończy się niepowodzeniem, nie pozostawi aplikacji w nieznanym lub niestabilnym stanie.
Manifest usługi Manifest usługi opisuje składniki usługi. Obejmuje ona dane, takie jak nazwa i typ usługi, oraz jego kod i konfiguracja. Manifest usługi zawiera również kilka dodatkowych parametrów, których można użyć do skonfigurowania usługi po jej wdrożeniu.
Struktura plików pakietu aplikacji
Aby wdrożyć aplikację w usłudze Service Fabric, aplikacja powinna być zgodna ze wstępnie zdefiniowaną strukturą katalogów. Poniżej przedstawiono przykład tej struktury.
|-- ApplicationPackageRoot
|-- GuestService1Pkg
|-- Code
|-- existingapp.exe
|-- Config
|-- Settings.xml
|-- Data
|-- ServiceManifest.xml
|-- ApplicationManifest.xml
Plik ApplicationPackageRoot zawiera plik ApplicationManifest.xml, który definiuje aplikację. Podkatalog dla każdej usługi zawartej w aplikacji jest używany do przechowywania wszystkich artefaktów, których wymaga usługa. Te podkatalogi to ServiceManifest.xml, a zazwyczaj następujące:
- Kod. Ten katalog zawiera kod usługi.
- Konfiguracja. Ten katalog zawiera plik Settings.xml (i inne pliki w razie potrzeby), do którego usługa może uzyskać dostęp w czasie wykonywania w celu pobrania określonych ustawień konfiguracji.
- Data. Jest to dodatkowy katalog do przechowywania dodatkowych danych lokalnych, których może potrzebować usługa. Dane powinny być używane do przechowywania tylko danych efemerycznych. Usługa Service Fabric nie kopiuje ani nie replikuje zmian w katalogu danych, jeśli usługa musi zostać przeniesiona (na przykład podczas pracy w trybie failover).
Uwaga
Nie musisz tworzyć config
katalogów i data
, jeśli ich nie potrzebujesz.
Następne kroki
Zapoznaj się z następującymi artykułami, aby uzyskać powiązane informacje i zadania.
- Wdrażanie aplikacji wykonywalnej gościa
- Wdrażanie wielu aplikacji wykonywalnych gości
- Tworzenie pierwszej aplikacji wykonywalnego gościa przy użyciu programu Visual Studio
- Przykład tworzenia pakietów i wdrażania pliku wykonywalnego gościa, w tym linku do wersji wstępnej narzędzia do tworzenia pakietów
- Przykład dwóch plików wykonywalnych gościa (C# i nodejs) komunikujących się za pośrednictwem usługi Naming przy użyciu interfejsu REST