Wdrażanie istniejącego pliku wykonywalnego w usłudze Service Fabric

  • Artykuł

Możesz uruchomić dowolny typ kodu, taki jak Node.js, Java lub C++ w usłudze Azure Service Fabric jako usługa. Usługa Service Fabric określa te typy usług 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 pojedynczą 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

Uruchamianie pliku wykonywalnego gościa w klastrze usługi Service Fabric ma kilka zalet:

  • Wysoka dostępność. Aplikacje uruchamiane w usłudze Service Fabric są wysoko dostępne. Usługa Service Fabric gwarantuje, ż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 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.

Samples

Omówienie plików manifestu aplikacji i usługi

W ramach wdrażania pliku wykonywalnego gościa warto zapoznać się z modelem tworzenia pakietów 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 jednej lub większej liczby usług, takich jak liczba 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 nie powiedzie się, nie pozostawia 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 definiujący 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 są ServiceManifest.xml i, 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.
  • Dane. 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.