Példák Reliable Services-alkalmazások és szolgáltatások jegyzékeire
Az alábbiakban példákat láthat egy Service Fabric-alkalmazás alkalmazás- és szolgáltatásjegyzékére egy ASP.NET Core webes előtérrel és egy állapotalapú háttérrendszerrel. Ezeknek a példáknak az a célja, hogy bemuzák, milyen beállítások érhetők el, és hogyan használhatók. Ezek az alkalmazás- és szolgáltatásjegyzékek a Service Fabric .NET gyorsútmutató-jegyzékeken alapulnak.
A következő funkciók jelennek meg:
| Jegyzék | Features |
|---|---|
| Alkalmazásjegyzék | erőforrás-szabályozás, szolgáltatás futtatása helyi rendszergazdai fiókként, alapértelmezett szabályzat alkalmazása az összes szolgáltatáskódcsomagra, felhasználó- és csoportnevek létrehozása, adatcsomag megosztása szolgáltatáspéldányok között, szolgáltatásvégpontok felülbírálása |
| FrontEndService szolgáltatásjegyzéke | Szkript futtatása a szolgáltatás indításakor, HTTPS-végpont definiálása |
| A BackEndService szolgáltatásjegyzéke | Konfigurációs csomag deklarálása, adatcsomag deklarálása, végpont konfigurálása |
Az alkalmazásjegyzék elemeit, a VotingWeb szolgáltatás jegyzékelemét és a VotingData szolgáltatásjegyzék-elemeit az adott XML-elemekről további információkért tekintse meg.
Alkalmazásjegyzék
<?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="VotingType" ApplicationTypeVersion="1.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric">
<Parameters>
<Parameter Name="VotingData_MinReplicaSetSize" DefaultValue="3" />
<Parameter Name="VotingData_PartitionCount" DefaultValue="1" />
<Parameter Name="VotingData_TargetReplicaSetSize" DefaultValue="3" />
<Parameter Name="VotingWeb_InstanceCount" DefaultValue="-1" />
<Parameter Name="CpuCores" DefaultValue="2" />
<Parameter Name="Memory" DefaultValue="4084" />
<Parameter Name="BlockIOWeight" DefaultValue="200" />
<Parameter Name="MaximumIOBandwidth" DefaultValue="1024" />
<Parameter Name="MemoryReservationInMB" DefaultValue="1024" />
<Parameter Name="MemorySwapInMB" DefaultValue="4084"/>
<Parameter Name="Port" DefaultValue="8081" />
<Parameter Name="Protocol" DefaultValue="tcp" />
<Parameter Name="Type" DefaultValue="internal" />
</Parameters>
<!-- Import the ServiceManifest from the ServicePackage. The ServiceManifestName and ServiceManifestVersion
should match the Name and Version attributes of the ServiceManifest element defined in the
ServiceManifest.xml file. -->
<ServiceManifestImport>
<ServiceManifestRef ServiceManifestName="VotingDataPkg" ServiceManifestVersion="1.0.0" />
<!-- Override endpoints declared in the service manifest. -->
<ResourceOverrides>
<Endpoints>
<Endpoint Name="DataEndpoint" Port="[Port]" Protocol="[Protocol]" Type="[Type]" />
</Endpoints>
</ResourceOverrides>
<!-- Policies to be applied to the imported service manifest. -->
<Policies>
<!-- Set resource governance at the service package level. -->
<ServicePackageResourceGovernancePolicy CpuCores="[CpuCores]" MemoryInMB="[Memory]"/>
<!-- Set resource governance at the code package level. -->
<ResourceGovernancePolicy CodePackageRef="Code" CpuPercent="10" MemoryInMB="[Memory]" BlockIOWeight="[BlockIOWeight]"
MaximumIOBandwidth="[MaximumIOBandwidth]" MaximumIOps="[MaximumIOps]" MemoryReservationInMB="[MemoryReservationInMB]"
MemorySwapInMB="[MemorySwapInMB]"/>
<!-- Share the data package across multiple instances of the VotingData service-->
<PackageSharingPolicy PackageRef="Data"/>
<!-- Give read rights on the "DataEndpoint" endpoint to the Customer2 account.-->
<SecurityAccessPolicy GrantRights="Read" PrincipalRef="Customer2" ResourceRef="DataEndpoint" ResourceType="Endpoint"/>
</Policies>
</ServiceManifestImport>
<!-- Import the ServiceManifest from the ServicePackage. The ServiceManifestName and ServiceManifestVersion
should match the Name and Version attributes of the ServiceManifest element defined in the
ServiceManifest.xml file. -->
<ServiceManifestImport>
<ServiceManifestRef ServiceManifestName="VotingWebPkg" ServiceManifestVersion="1.0.0" />
<!-- Policies to be applied to the imported service manifest. -->
<Policies>
<!-- Run the setup entry point (defined in the imported service manifest) as the SetupAdminUser account
(declared in the following Principals section). -->
<RunAsPolicy CodePackageRef="Code" UserRef="SetupAdminUser" EntryPointType="Setup" />
</Policies>
</ServiceManifestImport>
<DefaultServices>
<!-- The section below creates instances of service types, when an instance of this
application type is created. You can also create one or more instances of service type using the
ServiceFabric PowerShell module.
The attribute ServiceTypeName below must match the name defined in the imported ServiceManifest.xml file. -->
<Service Name="VotingData">
<StatefulService ServiceTypeName="VotingDataType" TargetReplicaSetSize="[VotingData_TargetReplicaSetSize]" MinReplicaSetSize="[VotingData_MinReplicaSetSize]">
<UniformInt64Partition PartitionCount="[VotingData_PartitionCount]" LowKey="0" HighKey="25" />
</StatefulService>
</Service>
<Service Name="VotingWeb" ServicePackageActivationMode="ExclusiveProcess">
<StatelessService ServiceTypeName="VotingWebType" InstanceCount="[VotingWeb_InstanceCount]">
<SingletonPartition />
</StatelessService>
</Service>
</DefaultServices>
<!-- Define users and groups required to run the services and access resources. Principals are used in the Policies section(s). -->
<Principals>
<!-- Declare a set of groups as security principals, which can be referenced in policies. Groups are useful if there are multiple users
for different service entry points and they need to have certain common privileges that are available at the group level. -->
<Groups>
<!-- Create a group that has administrator privileges. -->
<Group Name="LocalAdminGroup">
<Membership>
<SystemGroup Name="Administrators" />
</Membership>
</Group>
</Groups>
<Users>
<!-- Declare a user and add the user to the Administrators system group. The SetupAdminUser account is used to run the
setup entry point of the VotingWebPkg code package (described in the preceding Policies section).-->
<User Name="SetupAdminUser">
<MemberOf>
<SystemGroup Name="Administrators" />
</MemberOf>
</User>
<!-- Create a user. Local user accounts are created on the machines where the application is deployed. By default, these accounts
do not have the same names as those specified here. Instead, they are dynamically generated and have random passwords. -->
<User Name="Customer1" >
<MemberOf>
<!-- Add the user to the local administrators group.-->
<Group NameRef="LocalAdminGroup" />
</MemberOf>
</User>
<!-- Create a user as a local user with the specified account name and password. Local user accounts are created on the machines
where the application is deployed. -->
<User Name="Customer2" AccountType="LocalUser" AccountName="Customer1" Password="MyPassword">
<MemberOf>
<!-- Add the user to the local administrators group.-->
<Group NameRef="LocalAdminGroup" />
</MemberOf>
</User>
<!-- Create a user as NetworkService. -->
<User Name="MyDefaultAccount" AccountType="NetworkService" />
</Users>
</Principals>
<!-- Policies applied at the application level. -->
<Policies>
<!-- Specify a default user account for all code packages that don’t have a specific RunAsPolicy defined in
the ServiceManifestImport section(s). -->
<DefaultRunAsPolicy UserRef="MyDefaultAccount" />
</Policies>
</ApplicationManifest>
VotingWeb szolgáltatásjegyzéke
<?xml version="1.0" encoding="utf-8"?>
<ServiceManifest Name="VotingWebPkg"
Version="1.0.0"
xmlns="http://schemas.microsoft.com/2011/01/fabric"
xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<ServiceTypes>
<!-- This is the name of your ServiceType.
This name must match the string used in RegisterServiceType call in Program.cs. -->
<StatelessServiceType ServiceTypeName="VotingWebType" />
</ServiceTypes>
<!-- Code package is your service executable. -->
<CodePackage Name="Code" Version="1.0.0">
<!-- A privileged entry point that by default runs with the same credentials as Service Fabric (typically the NetworkService account) before
any other entry point. Use the setup entry point to set system environment variables, give the account running the service (NETWORK SERVICE, by default)
access to a certificate's private key, or perform other setup tasks. In the application manifest, you can change the security permissions to run the startup script
under a local system account or an administrator account. -->
<SetupEntryPoint>
<ExeHost>
<!-- The setup script to run. -->
<Program>Setup.bat</Program>
<!-- Pass arguments to the script when it runs.-->
<Arguments>MyValue</Arguments>
<!-- The working directory for the process in the code package on the node where the application is deployed. CodePackage sets the working directory to be
the root of the code package regardless of where the EXE is defined in the code package directory. This is where the processes can write the data. Writing data
in the code package or code base is not recommended as those folders could be shared between different application instances and may get deleted.-->
<WorkingFolder>CodePackage</WorkingFolder>
<!-- Warning! Do not use console redirection in a production application, only use it for local development and debugging. Redirects console output from the startup
script to an output file in the application folder called "log" on the cluster node where the application is deployed and run. Also set the number of output files
to retain and the maximum file size (in KB). -->
<ConsoleRedirection FileRetentionCount="10" FileMaxSizeInKb="20480"/>
</ExeHost>
</SetupEntryPoint>
<EntryPoint>
<ExeHost>
<Program>VotingWeb.exe</Program>
<!-- The working directory for the process in the code package on the node where the application is deployed. CodePackage sets the working directory to be
the root of the code package regardless of where the EXE is defined in the code package directory. This is where the processes can write the data. Writing data
in the code package or code base is not recommended as those folders could be shared between different application instances and may get deleted.-->
<WorkingFolder>CodePackage</WorkingFolder>
</ExeHost>
</EntryPoint>
</CodePackage>
<!-- Config package is the contents of the Config directory under PackageRoot that contains an
independently-updateable and versioned set of custom configuration settings for your service. -->
<ConfigPackage Name="Config" Version="1.0.0" />
<Resources>
<Endpoints>
<!-- Configure a HTTPS endpoint on port 443. This endpoint is used by the communication listener to obtain the port on which to
listen. Please note that if your service is partitioned, this port is shared with
replicas of different partitions that are placed in your code. -->
<Endpoint Protocol="https" Name="EndpointHttps" Type="Input" Port="443" />
</Endpoints>
</Resources>
</ServiceManifest>
VotingData szolgáltatásjegyzéke
<?xml version="1.0" encoding="utf-8"?>
<ServiceManifest Name="VotingDataPkg"
Version="1.0.0"
xmlns="http://schemas.microsoft.com/2011/01/fabric"
xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<ServiceTypes>
<!-- This is the name of your ServiceType.
This name must match the string used in RegisterServiceType call in Program.cs. -->
<StatefulServiceType ServiceTypeName="VotingDataType" HasPersistedState="true" />
</ServiceTypes>
<!-- Code package is your service executable. -->
<CodePackage Name="Code" Version="1.0.0">
<EntryPoint>
<ExeHost>
<Program>VotingData.exe</Program>
<!-- The working directory for the process in the code package on the node where the application is deployed. CodePackage sets the working directory to be
the root of the code package regardless of where the EXE is defined in the code package directory. This is where the processes can write the data. Writing data
in the code package or code base is not recommended as those folders could be shared between different application instances and may get deleted.-->
<WorkingFolder>CodePackage</WorkingFolder>
</ExeHost>
</EntryPoint>
</CodePackage>
<!-- Declares a folder, named by the Name attribute, under PackageRoot that contains a Settings.xml file. This file contains sections of user-defined,
key-value pair settings that the process can read back at run time. During an upgrade, if only the ConfigPackage version has changed,
then the running process is not restarted. Instead, a callback notifies the process that configuration settings have changed so they can be reloaded dynamically. -->
<ConfigPackage Name="Config" Version="1.0.0" />
<!-- Declares a folder, named by the Name attribute, under PackageRoot which contains static data files to be consumed by the process at run time. -->
<DataPackage Name="Data" Version="1.0.0"/>
<Resources>
<Endpoints>
<!-- Define an internal (used for intra-application communication) TCP endpoint. Since no port is specified, one is created and assigned dynamically
to the service.-->
<Endpoint Name="DataEndpoint" Protocol="tcp" Type="Internal" />
</Endpoints>
</Resources>
</ServiceManifest>
Alkalmazásjegyzék elemei
ApplicationManifest elem
Deklaratív módon írja le az alkalmazás típusát és verzióját. A rendszerösszetevő szolgáltatások egy vagy több szolgáltatásjegyzéke egy alkalmazástípus megírására hivatkozik. A rendszerösszetevő szolgáltatások konfigurációs beállításait felül lehet bírálni a paraméteres alkalmazásbeállítások használatával. Az alapértelmezett szolgáltatások, szolgáltatássablonok, egyszerű szolgáltatások, szabályzatok, diagnosztikai beállítások és tanúsítványok az alkalmazás szintjén is deklarálhatók. További információ: ApplicationManifest Elem
Paraméterek elem
Deklarálja az alkalmazásjegyzékben használt paramétereket. Ezeknek a paramétereknek az értéke az alkalmazás példányosításakor adható meg, és az alkalmazás- vagy szolgáltatáskonfigurációs beállítások felülbírálásához használható. További információ: Paraméterek elem
Paraméterelem
A jegyzékben használandó alkalmazásparaméter. A paraméter értéke módosítható az alkalmazás példányosítása során, vagy ha nincs megadva érték, a rendszer az alapértelmezett értéket használja. További információ: Paraméterelem
ServiceManifestImport elem
Importálja a szolgáltatásfejlesztő által létrehozott szolgáltatásjegyzéket. Az alkalmazás minden egyes rendszerösszetevő szolgáltatásához importálni kell egy szolgáltatásjegyzéket. A konfigurációs felülbírálások és szabályzatok deklarálhatók a szolgáltatásjegyzékhez. További információ: ServiceManifestImport Elem
ServiceManifestRef elem
Hivatkozással importálja a szolgáltatásjegyzéket. Jelenleg a szolgáltatásjegyzékfájlnak (ServiceManifest.xml) jelen kell lennie a buildcsomagban. További információ: ServiceManifestRef Elem
ResourceOverrides elem
A szolgáltatásjegyzék-erőforrásokban deklarált végpontok erőforrás-felülbírálásait adja meg. További információ: ResourceOverrides elem
Végpontok elem
A felülbírálandó végpont(ok). További információ: Endpoints Element
Végpontelem
A szolgáltatásjegyzékben deklarált végpont felülbírálandó. További információ: Endpoint Element
Szabályzatok elem
Az importált szolgáltatásjegyzékre alkalmazandó szabályzatokat (végpontkötés, csomagmegosztás, futtatókörnyezet és biztonsági hozzáférés) ismerteti. További információ: Szabályzatok elem
ServicePackageResourceGovernancePolicy elem
Meghatározza a teljes szolgáltatáscsomag szintjén alkalmazott erőforrás-szabályozási szabályzatot. További információ: ServicePackageResourceGovernancePolicy elem
ResourceGovernancePolicy elem
A codepackage erőforráskorlátait határozza meg. További információ: ResourceGovernancePolicy Elem
PackageSharingPolicy elem
Azt jelzi, hogy egy kódot, konfigurációt vagy adatcsomagot meg kell-e osztani az azonos szolgáltatástípusú szolgáltatáspéldányok között. További információ: PackageSharingPolicy elem
SecurityAccessPolicy elem
Hozzáférési engedélyeket ad egy szolgáltatásjegyzékben definiált erőforráson (például végponton) lévő egyszerű felhasználónak. Általában nagyon hasznos a szolgáltatások különböző erőforrásokhoz való hozzáférésének szabályozása és korlátozása a biztonsági kockázatok minimalizálása érdekében. Ez különösen akkor fontos, ha az alkalmazás egy piactérről származó szolgáltatások gyűjteményéből épül fel, amelyeket különböző fejlesztők fejlesztettek ki. További információ: SecurityAccessPolicy Elem
RunAsPolicy elem
Megadja azt a helyi felhasználót vagy helyi rendszerfiókot, amelyként egy szolgáltatáskódcsomag fut. A tartományi fiókok támogatottak olyan Windows Server-üzemelő példányokon, ahol elérhető a Microsoft Entra ID. Alapértelmezés szerint az alkalmazások azon a fiókon futnak, amelyen a Fabric.exe folyamat fut. Az alkalmazások más fiókként is futtathatók, amelyeket az Egyszerűk szakaszban kell deklarálni. Ha futtatási szabályzatot alkalmaz egy szolgáltatásra, és a szolgáltatásjegyzék a HTTP protokollal deklarálja a végponterőforrásokat, meg kell adnia egy SecurityAccessPolicy-t is, hogy az e végpontokhoz lefoglalt portok megfelelő hozzáférés-vezérléssel rendelkezzenek ahhoz a futtató felhasználói fiókhoz, amelyen a szolgáltatás fut. HTTPS-végpont esetén meg kell határoznia egy EndpointBindingPolicy-t is, amely jelzi a tanúsítvány nevét, hogy visszatérjen az ügyfélhez. További információ: RunAsPolicy Elem
DefaultServices elem
Deklarálja azokat a szolgáltatáspéldányokat, amelyek automatikusan létrejönnek, amikor egy alkalmazás példányosítása történik az alkalmazástípussal. További információ: DefaultServices Elem
Szolgáltatáselem
Deklarálja, hogy egy szolgáltatás automatikusan létrejön az alkalmazás példányosításakor. További információ: Szolgáltatáselem
StatefulService elem
Állapotalapú szolgáltatást definiál. További információ: StatefulService Elem
StatelessService elem
Állapot nélküli szolgáltatást definiál. További információ: StatelessService Elem
Egyszerű elemek
Ismerteti azokat a biztonsági tagokat (felhasználókat, csoportokat), amelyek szükségesek ahhoz, hogy az alkalmazás szolgáltatásokat és erőforrásokat futtasson. A rendszer a szabályzatok szakaszaiban hivatkozik a tagokra. További információ: Principals Element
Csoportok elem
Biztonsági tagokként deklarál egy csoportokat, amelyekre a szabályzatok hivatkozhatnak. A csoportok akkor hasznosak, ha több felhasználó is van a különböző szolgáltatásbeléptetési pontokhoz, és bizonyos közös jogosultságokkal kell rendelkezniük, amelyek a csoport szintjén érhetők el. További információ: Csoportok elem
Csoportelem
Biztonsági tagként deklarál egy csoportot, amelyre a szabályzatok hivatkozhatnak. További információ: Csoportelem
Tagsági elem
További információ: Tagsági elem
SystemGroup elem
További információ: SystemGroup Elem
Felhasználók elem
Biztonsági tagokként deklarál egy felhasználócsoportot, amelyre a szabályzatok hivatkozhatnak. További információ: Felhasználók elem
Felhasználói elem
Biztonsági tagként deklarál egy felhasználót, amelyre a szabályzatok hivatkozhatnak. További információ: Felhasználói elem
MemberOf elem
A felhasználók bármely meglévő tagsági csoporthoz hozzáadhatók, így örökölhetik a tagsági csoport összes tulajdonságát és biztonsági beállításait. A tagsági csoport olyan külső erőforrások védelmére használható, amelyeket különböző szolgáltatásoknak vagy ugyanazon szolgáltatásnak (egy másik gépen) kell elérnie. További információ: MemberOf Elem
SystemGroup elem
A felhasználót hozzáadni kívánt rendszercsoport. A rendszercsoportot a Csoportok szakaszban kell meghatározni. További információ: SystemGroup Elem
Csoportelem
A felhasználót hozzáadni kívánt csoport. A csoportot a Csoportok szakaszban kell definiálni. További információ: Csoportelem
Szabályzatok elem
Az alkalmazás szintjén alkalmazandó szabályzatokat (naplógyűjtés, alapértelmezett futtatókörnyezet, állapot és biztonsági hozzáférés) ismerteti. További információ: Szabályzatok elem
DefaultRunAsPolicy elem
Adjon meg egy alapértelmezett felhasználói fiókot az összes olyan szolgáltatáskód-csomaghoz, amely nem rendelkezik meghatározott RunAsPolicy-fiókkal a ServiceManifestImport szakaszban. További információ: DefaultRunAsPolicy elem
VotingWeb szolgáltatásjegyzék elemei
ServiceManifest elem
Deklaratív módon leírja a szolgáltatás típusát és verzióját. Felsorolja az egymástól függetlenül frissíthető kódot, konfigurációt és adatcsomagokat, amelyek egy vagy több szolgáltatástípus támogatásához egy szolgáltatáscsomagot alkotnak. Az erőforrások, a diagnosztikai beállítások és a szolgáltatás metaadatai, például a szolgáltatás típusa, az állapottulajdonságok és a terheléselosztási metrikák is meg vannak adva. További információ: ServiceManifest Elem
ServiceTypes elem
Meghatározza, hogy a jegyzékben szereplő CodePackage mely szolgáltatástípusokat támogatja. Amikor egy szolgáltatás példányosított egy ilyen szolgáltatástípussal, a jegyzékben deklarált összes kódcsomag a belépési pontok futtatásával aktiválódik. A szolgáltatástípusok a jegyzék szintjén vannak deklarálva, nem pedig a kódcsomag szintjén. További információ: ServiceTypes Elem
StatelessServiceType elem
Állapot nélküli szolgáltatástípust ír le. További információ: StatelessServiceType elem
CodePackage elem
Egy meghatározott szolgáltatástípust támogató kódcsomagot ismertet. Amikor egy szolgáltatás példányosított egy ilyen szolgáltatástípussal, a jegyzékben deklarált összes kódcsomag a belépési pontok futtatásával aktiválódik. Az eredményként kapott folyamatok várhatóan futásidőben regisztrálják a támogatott szolgáltatástípusokat. Ha több kódcsomag is létezik, az összes aktiválva lesz, amikor a rendszer a deklarált szolgáltatástípusok bármelyikét keresi. További információ: CodePackage Elem
SetupEntryPoint-elem
Olyan kiemelt belépési pont, amely alapértelmezés szerint ugyanazokkal a hitelesítő adatokkal fut, mint a Service Fabric (általában a NETWORK Standard kiadás RVICE-fiók) bármely más belépési pont előtt. Az EntryPoint által megadott végrehajtható fájl általában a hosszú ideig futó szolgáltatásgazda. Egy külön beállítási belépési pont jelenléte esetén nem kell hosszú ideig magas jogosultságokkal futtatni a szolgáltatás gazdagépét. További információ: SetupEntryPoint Elem
ExeHost-elem
További információ: ExeHost Elem
Programelem
A végrehajtható név. Például: "MySetup.bat" vagy "MyServiceHost.exe". További információ: Programelem
Argumentumok elem
További információ: Argumentumok elem
WorkingFolder elem
A folyamat munkakönyvtára a kódcsomagban azon a fürtcsomóponton, ahol az alkalmazás telepítve van. Három értéket adhat meg: Work (az alapértelmezett), CodePackage vagy CodeBase. A CodeBase azt határozza meg, hogy a munkakönyvtár arra a könyvtárra legyen beállítva, amelyben az EXE definiálva van a kódcsomagban. A CodePackage a munkakönyvtárat a kódcsomag gyökerének állítja be, függetlenül attól, hogy hol van definiálva az EXE a kódcsomag könyvtárában. A Work a munkakönyvtárat a csomóponton létrehozott egyedi mappára állítja be. Ez a mappa a teljes alkalmazáspéldány esetében ugyanaz. Alapértelmezés szerint az alkalmazás összes folyamatának munkakönyvtára az alkalmazás munkahelyi mappájára van állítva. Itt írhatják a folyamatok az adatokat. Nem ajánlott adatokat írni a kódcsomagba vagy a kódbázisba, mivel ezek a mappák megoszthatók különböző alkalmazáspéldányok között, és törölhetők. További információ: WorkingFolder Elem
ConsoleRedirection elem
Figyelmeztetés:
Éles alkalmazásokban ne használjon konzolátirányítást, csak helyi fejlesztéshez és hibakereséshez. Átirányítja a konzol kimenetét az indítási szkriptből a "log" nevű alkalmazásmappában lévő kimeneti fájlra azon a fürtcsomóponton, ahol az alkalmazást üzembe helyezik és futtatják. További információ: ConsoleRedirection Elem
EntryPoint-elem
Az EntryPoint által megadott végrehajtható fájl általában a hosszú ideig futó szolgáltatásgazda. Egy külön beállítási belépési pont jelenléte esetén nem kell hosszú ideig magas jogosultságokkal futtatni a szolgáltatás gazdagépét. Az EntryPoint által megadott végrehajtható fájl a SetupEntryPoint sikeres kilépése után fut. A rendszer figyeli és újraindítja az eredményül kapott folyamatot (a SetupEntryPointtal kezdve), ha bármikor leáll vagy összeomlik. További információ: EntryPoint-elem
ExeHost-elem
További információ: ExeHost Elem
ConfigPackage elem
Deklarál egy mappát a Name attribútummal a PackageRoot alatt, amely egy Gépház.xml fájlt tartalmaz. Ez a fájl a felhasználó által definiált kulcs-érték pár beállításainak azon szakaszait tartalmazza, amelyeket a folyamat futásidőben vissza tud olvasni. Ha a frissítés során csak a ConfigPackage verziója módosult, a futó folyamat nem indul újra. Ehelyett a visszahívás értesíti a konfigurációs beállítások módosításának folyamatát, hogy azok dinamikusan betölthetők legyenek. További információ: ConfigPackage elem
Erőforrások elem
A szolgáltatás által használt erőforrásokat ismerteti, amelyek lefordított kód módosítása nélkül deklarálhatók és a szolgáltatás üzembe helyezésekor módosíthatók. Ezeknek az erőforrásoknak a hozzáférését az alkalmazásjegyzék Egyszerűk és szabályzatok szakasza szabályozza. További információ: Erőforrások elem
Végpontok elem
A szolgáltatás végpontjait határozza meg. További információ: Endpoints Element
Végpontelem
A szolgáltatásjegyzékben deklarált végpont felülbírálandó. További információ: Endpoint Element
VotingData szolgáltatásjegyzék elemei
ServiceManifest elem
Deklaratív módon leírja a szolgáltatás típusát és verzióját. Felsorolja az egymástól függetlenül frissíthető kódot, konfigurációt és adatcsomagokat, amelyek egy vagy több szolgáltatástípus támogatásához egy szolgáltatáscsomagot alkotnak. Az erőforrások, a diagnosztikai beállítások és a szolgáltatás metaadatai, például a szolgáltatás típusa, az állapottulajdonságok és a terheléselosztási metrikák is meg vannak adva. További információ: ServiceManifest Elem
ServiceTypes elem
Meghatározza, hogy a jegyzékben szereplő CodePackage mely szolgáltatástípusokat támogatja. Amikor egy szolgáltatás példányosított egy ilyen szolgáltatástípussal, a jegyzékben deklarált összes kódcsomag a belépési pontok futtatásával aktiválódik. A szolgáltatástípusok a jegyzék szintjén vannak deklarálva, nem pedig a kódcsomag szintjén. További információ: ServiceTypes Elem
StatefulServiceType elem
Állapotalapú szolgáltatástípust ír le. További információ: StatefulServiceType elem
CodePackage elem
Egy meghatározott szolgáltatástípust támogató kódcsomagot ismertet. Amikor egy szolgáltatás példányosított egy ilyen szolgáltatástípussal, a jegyzékben deklarált összes kódcsomag a belépési pontok futtatásával aktiválódik. Az eredményként kapott folyamatok várhatóan futásidőben regisztrálják a támogatott szolgáltatástípusokat. Ha több kódcsomag is létezik, az összes aktiválva lesz, amikor a rendszer a deklarált szolgáltatástípusok bármelyikét keresi. További információ: CodePackage Elem
EntryPoint-elem
Az EntryPoint által megadott végrehajtható fájl általában a hosszú ideig futó szolgáltatásgazda. Egy külön beállítási belépési pont jelenléte esetén nem kell hosszú ideig magas jogosultságokkal futtatni a szolgáltatás gazdagépét. Az EntryPoint által megadott végrehajtható fájl a SetupEntryPoint sikeres kilépése után fut. A rendszer figyeli és újraindítja az eredményül kapott folyamatot (a SetupEntryPointtal kezdve), ha bármikor leáll vagy összeomlik. További információ: EntryPoint-elem
ExeHost-elem
További információ: ExeHost Elem
Programelem
A végrehajtható név. Például: "MySetup.bat" vagy "MyServiceHost.exe". További információ: Programelem
WorkingFolder elem
A folyamat munkakönyvtára a kódcsomagban azon a fürtcsomóponton, ahol az alkalmazás telepítve van. Három értéket adhat meg: Work (az alapértelmezett), CodePackage vagy CodeBase. A CodeBase azt határozza meg, hogy a munkakönyvtár arra a könyvtárra legyen beállítva, amelyben az EXE definiálva van a kódcsomagban. A CodePackage a munkakönyvtárat a kódcsomag gyökerének állítja be, függetlenül attól, hogy hol van definiálva az EXE a kódcsomag könyvtárában. A Work a munkakönyvtárat a csomóponton létrehozott egyedi mappára állítja be. Ez a mappa a teljes alkalmazáspéldány esetében ugyanaz. Alapértelmezés szerint az alkalmazás összes folyamatának munkakönyvtára az alkalmazás munkahelyi mappájára van állítva. Itt írhatják a folyamatok az adatokat. Nem ajánlott adatokat írni a kódcsomagba vagy a kódbázisba, mivel ezek a mappák megoszthatók különböző alkalmazáspéldányok között, és törölhetők. További információ: WorkingFolder Elem
ConfigPackage elem
Deklarál egy mappát a Name attribútummal a PackageRoot alatt, amely egy Gépház.xml fájlt tartalmaz. Ez a fájl a felhasználó által definiált kulcs-érték pár beállításainak azon szakaszait tartalmazza, amelyeket a folyamat futásidőben vissza tud olvasni. Ha a frissítés során csak a ConfigPackage verziója módosult, a futó folyamat nem indul újra. Ehelyett a visszahívás értesíti a konfigurációs beállítások módosításának folyamatát, hogy azok dinamikusan betölthetők legyenek. További információ: ConfigPackage elem
DataPackage elem
Deklarál egy, a Name attribútum által elnevezett mappát a PackageRoot alatt, amely statikus adatfájlokat tartalmaz, amelyeket a folyamat futásidőben használ fel. A Service Fabric újra felhasználja a gazdagépben és a támogatási csomagokban megadott összes EXE-t és DLLHOST-t, amikor a szolgáltatásjegyzékben felsorolt adatcsomagok bármelyike frissül. További információ: DataPackage Elem
Erőforrások elem
A szolgáltatás által használt erőforrásokat ismerteti, amelyek lefordított kód módosítása nélkül deklarálhatók és a szolgáltatás üzembe helyezésekor módosíthatók. Ezeknek az erőforrásoknak a hozzáférését az alkalmazásjegyzék Egyszerűk és szabályzatok szakasza szabályozza. További információ: Erőforrások elem
Végpontok elem
A szolgáltatás végpontjait határozza meg. További információ: Endpoints Element
Végpontelem
A szolgáltatásjegyzékben deklarált végpont felülbírálandó. További információ: Endpoint Element
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: