Zabalit a nasadit existující spustitelný soubor pro Service Fabric

Při balení existující spustitelný soubor jako hostující spustitelný soubormůžete zvolit buď použití šablony projektu sady Visual Studio, nebo Vytvoření balíčku aplikace ručně. Pomocí sady Visual Studio je vytvořena šablona balíčku aplikace a soubory manifestu, které jsou vytvořeny novou šablonou projektu za vás.

Použití sady Visual Studio k zabalení a nasazení stávajícího spustitelného souboru

Visual Studio poskytuje šablonu služby Service Fabric, která vám umožní nasadit spustitelný soubor hosta do clusteru Service Fabric.

1. Vyberte soubor > Nový projekt a vytvořte aplikaci Service Fabric.
2. Jako šablonu služby vyberte spustitelný soubor typu Host .
3. Klikněte na Procházet a vyberte složku s vaším spustitelným souborem a vyplňte zbývající parametry a vytvořte službu.
   • Chování balíčku kódu. Může být nastaveno na zkopírování veškerého obsahu vaší složky do projektu aplikace Visual Studio, což je užitečné, pokud se spustitelný soubor nemění. Pokud očekáváte, že se spustitelný soubor změní a chcete, aby se dynamicky vybrala nová sestavení, můžete místo toho použít odkaz na složku. Můžete použít propojené složky při vytváření projektu aplikace v aplikaci Visual Studio. Tato vazba odkazuje na zdrojové umístění v rámci projektu, což vám umožní aktualizovat spustitelný soubor hosta ve zdrojovém cílovém umístění. Tyto aktualizace se stanou součástí balíčku aplikace při sestavení.
   • Program Určuje spustitelný soubor, který se má spustit pro spuštění služby.
   • Argumenty určují argumenty, které se mají předat spustitelnému souboru. Může se jednat o seznam parametrů s argumenty.
   • WorkingFolder určuje pracovní adresář pro proces, který bude spuštěn. Můžete zadat tři hodnoty:
     • CodeBase Určuje, že pracovní adresář bude nastaven na adresář kódu v balíčku aplikace ( Code adresář zobrazený v předchozí struktuře souborů).
     • CodePackage Určuje, že bude pracovní adresář nastaven na kořen balíčku aplikace ( GuestService1Pkg zobrazený v předchozí struktuře souborů).
     • Work Určuje, že soubory jsou umístěny v podadresáři s názvem Work.
4. Zadejte název služby a klikněte na OK.
5. Pokud vaše služba potřebuje koncový bod pro komunikaci, můžete nyní do souboru ServiceManifest.xml přidat protokol, port a typ. Příklad: <Endpoint Name="NodeAppTypeEndpoint" Protocol="http" Port="3000" UriScheme="http" PathSuffix="myapp/" Type="Input" />.
6. Pomocí ladění řešení v aplikaci Visual Studio teď můžete použít akci balíčku a publikování pro svůj místní cluster. Až budete připraveni, můžete aplikaci publikovat do vzdáleného clusteru nebo vrátit se změnami řešení do správy zdrojového kódu.
7. Přečtěte si, jak Spustit aplikaci , abyste viděli, jak zobrazit službu spustitelných souborů hosta běžící v Service Fabric Explorer.

Ukázkový návod najdete v tématu Vytvoření první spustitelné aplikace hosta pomocí sady Visual Studio.

Balení více spustitelných souborů se sadou Visual Studio

Sadu Visual Studio můžete použít k tvorbě balíčku aplikace, který obsahuje více spustitelných souborů hosta. Po přidání prvního spustitelného souboru hosta klikněte pravým tlačítkem na projekt aplikace a vyberte Add->New Service Fabric Service a přidejte do řešení druhý spustitelný soubor hosta.

Zabalení a nasazení stávajícího spustitelného souboru v systému Linux pomocí Yeoman

Postup vytvoření a nasazení spustitelného souboru hosta v systému Linux je stejný jako nasazení aplikace CSharp nebo Java.

1. V terminálu zadejte yo azuresfguest.
2. Pojmenujte svoji aplikaci.
3. Pojmenujte službu a zadejte podrobnosti včetně cesty ke spustitelnému souboru a parametrů, které musí být vyvolány pomocí.

Yeoman vytvoří balíček aplikace s odpovídající aplikací a soubory manifestu spolu s instalačními a odinstalačními skripty.

Balení více spustitelných souborů pomocí Yeoman v systému Linux

Pokud chcete přidat další službu do aplikace již vytvořené pomocí yo, proveďte následující kroky:

1. Změňte adresář na kořenovou složku stávající aplikace. Například cd ~/YeomanSamples/MyApplication, pokud MyApplication je aplikace vytvořená pomocí Yeomanu.
2. Spusťte yo azuresfguest:AddService a zadejte potřebné podrobnosti.

Ruční zabalení a nasazení stávajícího spustitelného souboru

Proces ručního balení spustitelného souboru hosta je založen na následujících obecných krocích:

1. Vytvořte adresářovou strukturu balíčku.
2. Přidejte kód a konfigurační soubory aplikace.
3. Upravte soubor manifestu služby.
4. Upravte soubor manifestu aplikace.

Vytvořit adresářovou strukturu balíčku

Můžete začít vytvořením adresářové struktury, jak je popsáno v části balení aplikace Azure Service Fabric.

Přidat kód a konfigurační soubory aplikace

Po vytvoření adresářové struktury můžete přidat kód a konfigurační soubory aplikace do adresářů kódu a konfigurace. Můžete také vytvořit další adresáře nebo podadresáře v adresáři Code nebo config.

Service Fabric provede xcopy obsah kořenového adresáře aplikace, takže není k dispozici žádná předdefinovaná struktura, která by používala více než vytváření dvou hlavních adresářů, kódů a nastavení. (Pokud chcete, můžete vybrat jiné názvy. Další podrobnosti najdete v další části.)

Upravit soubor manifestu služby

Dalším krokem je upravit soubor manifestu služby tak, aby obsahoval následující informace:

• Název typu služby. Toto je ID, které Service Fabric používá k identifikaci služby.
• Příkaz, který se má použít ke spuštění aplikace (ExeHost).
• Libovolný skript, který je třeba spustit pro nastavení aplikace (SetupEntrypoint).

Následuje příklad ServiceManifest.xml souboru:

<?xml version="1.0" encoding="utf-8"?>
<ServiceManifest xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" Name="NodeApp" Version="1.0.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric">
   <ServiceTypes>
      <StatelessServiceType ServiceTypeName="NodeApp" UseImplicitHost="true"/>
   </ServiceTypes>
   <CodePackage Name="code" Version="1.0.0.0">
      <SetupEntryPoint>
         <ExeHost>
             <Program>scripts\launchConfig.cmd</Program>
         </ExeHost>
      </SetupEntryPoint>
      <EntryPoint>
         <ExeHost>
            <Program>node.exe</Program>
            <Arguments>bin/www</Arguments>
            <WorkingFolder>CodePackage</WorkingFolder>
         </ExeHost>
      </EntryPoint>
   </CodePackage>
   <Resources>
      <Endpoints>
         <Endpoint Name="NodeAppTypeEndpoint" Protocol="http" Port="3000" Type="Input" />
      </Endpoints>
   </Resources>
</ServiceManifest>

Následující oddíly přecházejí do různých částí souboru, které je třeba aktualizovat.

Aktualizovat ServiceType

<ServiceTypes>
  <StatelessServiceType ServiceTypeName="NodeApp" UseImplicitHost="true" />
</ServiceTypes>

• Můžete vybrat libovolný název, který chcete ServiceTypeName . Hodnota se v ApplicationManifest.xml souboru používá k identifikaci služby.
• Zadejte UseImplicitHost="true". Tento atribut oznamuje Service Fabric, že je služba založená na samostatné aplikaci, takže všechny Service Fabric musí udělat, aby je spouštěla jako proces a sledovala svůj stav.

Aktualizovat CodePackage

Element CodePackage určuje umístění (a verzi) kódu služby.

<CodePackage Name="Code" Version="1.0.0.0">

NamePrvek slouží k zadání názvu adresáře v balíčku aplikace, který obsahuje kód služby. CodePackage má také version atribut. To lze použít k určení verze kódu a lze jej také použít k upgradu kódu služby pomocí infrastruktury správy životního cyklu aplikací v Service Fabric.

Volitelné: aktualizace SetupEntrypoint

<SetupEntryPoint>
   <ExeHost>
       <Program>scripts\launchConfig.cmd</Program>
   </ExeHost>
</SetupEntryPoint>

Element SetupEntryPoint slouží k určení libovolného spustitelného souboru nebo dávkového souboru, který by měl být proveden před spuštěním kódu služby. Je to volitelný krok, takže není nutné ho zahrnovat, pokud není nutná inicializace. SetupEntryPoint se spustí pokaždé, když se služba restartuje.

Existuje pouze jeden SetupEntryPoint, takže instalační skripty musí být seskupeny do jednoho dávkového souboru, pokud instalace aplikace vyžaduje více skriptů. SetupEntryPoint může spustit jakýkoli typ souboru: spustitelné soubory, dávkové soubory a rutiny prostředí PowerShell. Další podrobnosti najdete v tématu Konfigurace SetupEntryPoint.

V předchozím příkladu SetupEntryPoint spustí dávkový soubor s názvem LaunchConfig.cmd , který je umístěn v scripts podadresáři adresáře kódu (za předpokladu, že element WorkingFolder je nastaven na základ kódu).

Aktualizovat vstupní bod

<EntryPoint>
  <ExeHost>
    <Program>node.exe</Program>
    <Arguments>bin/www</Arguments>
    <WorkingFolder>CodeBase</WorkingFolder>
  </ExeHost>
</EntryPoint>

EntryPointElement v souboru manifestu služby slouží k určení způsobu spuštění služby.

ExeHostElement určuje spustitelný soubor (a argumenty), které by měly být použity ke spuštění služby. Volitelně můžete přidat IsExternalExecutable="true" atribut ExeHost , který označuje, že program je externí spustitelný soubor mimo balíček kódu. Například, <ExeHost IsExternalExecutable="true">.

• Program Určuje název spustitelného souboru, který by měl službu spustit.
• Arguments Určuje argumenty, které se mají předat spustitelnému souboru. Může se jednat o seznam parametrů s argumenty.
• WorkingFolder Určuje pracovní adresář pro proces, který se bude spouštět. Můžete zadat tři hodnoty:
  • CodeBase Určuje, že pracovní adresář bude nastaven na adresář kódu v balíčku aplikace ( Code adresář v předchozí struktuře souborů).
  • CodePackage Určuje, že bude pracovní adresář nastaven na kořen balíčku aplikace ( GuestService1Pkg v předchozí struktuře souborů).
    • Work Určuje, že soubory jsou umístěny v podadresáři s názvem Work.

WorkingFolder je užitečné pro nastavení správného pracovního adresáře, aby bylo možné použít relativní cesty buď v rámci aplikace, nebo inicializačních skriptů.

Aktualizace koncových bodů a registrace u Naming Service pro komunikaci

<Endpoints>
   <Endpoint Name="NodeAppTypeEndpoint" Protocol="http" Port="3000" Type="Input" />
</Endpoints>

V předchozím příkladu Endpoint prvek určuje koncové body, na kterých může aplikace naslouchat. V tomto příkladu aplikace Node.js naslouchá na http na portu 3000.

Kromě toho můžete požádat Service Fabric o publikování tohoto koncového bodu do Naming Service, aby ostatní služby mohly zjistit adresu koncového bodu pro tuto službu. Díky tomu budete moci komunikovat mezi službami, které jsou spustitelnými soubory hosta. Adresa publikovaného koncového bodu je ve formátu UriScheme://IPAddressOrFQDN:Port/PathSuffix . UriScheme a PathSuffix jsou volitelné atributy. IPAddressOrFQDN je tato IP adresa nebo plně kvalifikovaný název domény uzlu, na který se tento spustitelný soubor umístí, a vypočítává se za vás.

V následujícím příkladu se po nasazení služby v Service Fabric Explorer zobrazí koncový bod podobný vašemu http://10.1.4.92:3000/myapp/ publikování pro instanci služby. Nebo pokud se jedná o místní počítač, uvidíte http://localhost:3000/myapp/ .

<Endpoints>
   <Endpoint Name="NodeAppTypeEndpoint" Protocol="http" Port="3000"  UriScheme="http" PathSuffix="myapp/" Type="Input" />
</Endpoints>

Pomocí těchto adres se reverzním proxy můžete komunikovat mezi službami.

Upravit soubor manifestu aplikace

Po nakonfigurování Servicemanifest.xml souboru je třeba provést některé změny v ApplicationManifest.xml souboru, aby se zajistilo, že bude použit správný typ služby a název.

<?xml version="1.0" encoding="utf-8"?>
<ApplicationManifest xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" ApplicationTypeName="NodeAppType" ApplicationTypeVersion="1.0" xmlns="http://schemas.microsoft.com/2011/01/fabric">
   <ServiceManifestImport>
      <ServiceManifestRef ServiceManifestName="NodeApp" ServiceManifestVersion="1.0.0.0" />
   </ServiceManifestImport>
</ApplicationManifest>

ServiceManifestImport

V ServiceManifestImport elementu můžete zadat jednu nebo více služeb, které chcete do aplikace zahrnout. Na služby se odkazuje pomocí nástroje ServiceManifestName , který určuje název adresáře, ve kterém ServiceManifest.xml se soubor nachází.

<ServiceManifestImport>
  <ServiceManifestRef ServiceManifestName="NodeApp" ServiceManifestVersion="1.0.0.0" />
</ServiceManifestImport>

Nastavení protokolování

U spustitelných souborů hosta je užitečné, abyste viděli protokoly konzoly, abyste zjistili, jestli se v aplikacích a konfiguračních skriptech zobrazují nějaké chyby. Přesměrování konzoly lze v ServiceManifest.xml souboru nakonfigurovat pomocí ConsoleRedirection elementu.

<EntryPoint>
  <ExeHost>
    <Program>node.exe</Program>
    <Arguments>bin/www</Arguments>
    <WorkingFolder>CodeBase</WorkingFolder>
    <ConsoleRedirection FileRetentionCount="5" FileMaxSizeInKb="2048"/>
  </ExeHost>
</EntryPoint>

ConsoleRedirection dá se použít k přesměrování výstupu konzoly (stdout i stderr) do pracovního adresáře. Tato možnost umožňuje ověřit, že během instalace nebo provádění aplikace v clusteru Service Fabric nejsou žádné chyby.

FileRetentionCount Určuje, kolik souborů je uloženo v pracovním adresáři. Hodnota 5 například znamená, že soubory protokolu pro předchozích pět spuštění jsou uloženy v pracovním adresáři.

FileMaxSizeInKb Určuje maximální velikost souborů protokolu.

Soubory protokolu jsou uloženy v jednom z pracovních adresářů služby. Chcete-li zjistit, kde jsou soubory umístěny, použijte Service Fabric Explorer k určení uzlu, na kterém je služba spuštěna, a používaného pracovního adresáře. Tento postup je popsaný dále v tomto článku.

Nasazení

Posledním krokem je nasazení aplikace. Následující skript prostředí PowerShell ukazuje, jak nasadit aplikaci do místního vývojového clusteru a spustit novou službu Service Fabric.

Connect-ServiceFabricCluster localhost:19000

Write-Host 'Copying application package...'
Copy-ServiceFabricApplicationPackage -ApplicationPackagePath 'C:\Dev\MultipleApplications' -ImageStoreConnectionString 'file:C:\SfDevCluster\Data\ImageStoreShare' -ApplicationPackagePathInImageStore 'nodeapp'

Write-Host 'Registering application type...'
Register-ServiceFabricApplicationType -ApplicationPathInImageStore 'nodeapp'

New-ServiceFabricApplication -ApplicationName 'fabric:/nodeapp' -ApplicationTypeName 'NodeAppType' -ApplicationTypeVersion 1.0

New-ServiceFabricService -ApplicationName 'fabric:/nodeapp' -ServiceName 'fabric:/nodeapp/nodeappservice' -ServiceTypeName 'NodeApp' -Stateless -PartitionSchemeSingleton -InstanceCount 1

Službu Service Fabric je možné nasadit v různých "konfiguracích". Může být například nasazena jako jediná nebo více instancí nebo může být nasazena takovým způsobem, že v každém uzlu Service Fabric clusteru existuje jedna instance služby.

InstanceCountParametr New-ServiceFabricService rutiny slouží k určení, kolik instancí služby by mělo být spuštěno v clusteru Service Fabric. Hodnotu lze nastavit InstanceCount v závislosti na typu aplikace, kterou nasazujete. Mezi nejběžnější scénáře patří:

• InstanceCount = "1". V tomto případě je v clusteru nasazena pouze jedna instance služby. Plánovač Service Fabric určuje, na kterém uzlu bude služba nasazena.
• InstanceCount ="-1". V takovém případě se jedna instance služby nasadí na každý uzel v clusteru Service Fabric. Výsledek má jednu (a jenom jednu) instanci služby pro každý uzel v clusteru.

Tato konfigurace je užitečná pro aplikace front-end (například koncový bod REST), protože klientské aplikace potřebují připojit k jakémukoli uzlu v clusteru, aby používaly koncový bod. Tato konfigurace se dá použít i v případě, že jsou například všechny uzly Service Fabric clusteru připojené k nástroji pro vyrovnávání zatížení. Provoz klienta je pak možné distribuovat přes službu, která běží na všech uzlech v clusteru.

Kontrolovat spuštěnou aplikaci

V Service Fabric Explorer určete uzel, ve kterém je služba spuštěná. V tomto příkladu se spouští na Uzel1:

Pokud přejdete na uzel a přejdete na aplikaci, zobrazí se základní informace o uzlu včetně umístění na disku.

Pokud přejdete do adresáře pomocí Průzkumník serveru, můžete najít pracovní adresář a složku protokolu služby, jak je znázorněno na následujícím snímku obrazovky:

Další kroky

V tomto článku jste se naučili, jak zabalit spustitelný soubor hosta a nasadit ho do Service Fabric. Související informace a úlohy najdete v následujících článcích.

• Ukázka balení a nasazení spustitelného souboru hosta, včetně odkazu na předběžnou verzi nástroje pro balení
• Ukázka dvou spustitelných souborů hosta (C# a NodeJS), které komunikují přes službu pojmenování pomocí REST
• Vytvoření první aplikace Service Fabric pomocí sady Visual Studio