Reliable Actors konfigurálása – KVSActorStateProvider

A KVSActorStateProvider alapértelmezett konfigurációját úgy módosíthatja, hogy módosítja a Microsoft Visual Studio csomaggyökerében, a megadott szereplő Config mappájában létrehozott settings.xml fájlt.

Az Azure Service Fabric-futtatókörnyezet előre definiált szakaszneveket keres a settings.xml fájlban, és felhasználja a konfigurációs értékeket a mögöttes futtatókörnyezeti összetevők létrehozásakor.

Megjegyzés

A Visual Studio-megoldásban létrehozott settings.xml fájlban ne törölje vagy módosítsa az alábbi konfigurációk szakaszneveit.

Replikátor biztonsági konfigurációja

A replikátor biztonsági konfigurációi a replikáció során használt kommunikációs csatorna védelmére szolgálnak. Ez azt jelenti, hogy a szolgáltatások nem látják egymás replikációs forgalmát, biztosítva, hogy a magas rendelkezésre állású adatok is biztonságosak legyenek. Alapértelmezés szerint egy üres biztonsági konfigurációs szakasz megakadályozza a replikáció biztonságát.

Fontos

Linux-csomópontokon a tanúsítványoknak PEM-formátumúnak kell lenniük. A tanúsítványok Linuxhoz való kereséséről és konfigurálásáról további információt a Tanúsítványok konfigurálása Linuxon című témakörben talál.

Szakasz neve

<ActorName>ServiceReplicatorSecurityConfig

Replikátor konfigurálása

A replikátor konfigurációi konfigurálják azt a replikátort, amely felelős az Aktor állapot magas megbízhatóságúvá tételéért. Az alapértelmezett konfigurációt a Visual Studio-sablon hozza létre, és elegendőnek kell lennie. Ez a szakasz a replikátor hangolásához elérhető további konfigurációkról szól.

Szakasz neve

<ActorName>ServiceReplicatorConfig

Konfigurációnevek

Name	Unit (Egység)	Alapértelmezett érték	Megjegyzések
BatchAcknowledgementInterval	Másodperc	0.015	Az az időszak, amelyre a másodlagos replikátor a művelet fogadása után várakozik, mielőtt nyugtát küld az elsődlegesnek. Az ebben az intervallumban feldolgozott műveletekhez küldendő egyéb nyugtázások egyetlen válaszként lesznek elküldve.
ReplicatorEndpoint	N/A	Nincs alapértelmezett kötelező paraméter	IP-cím és port, amelyet az elsődleges/másodlagos replikátor a replikakészlet más replikátoraival való kommunikációra használ. Ennek egy TCP-erőforrásvégpontra kell hivatkoznia a szolgáltatásjegyzékben. A szolgáltatásjegyzékben a végponterőforrások definiálásáról további információt a Szolgáltatásjegyzék erőforrásai című témakörben találhat.
RetryInterval	Másodperc	5	Az az időtartam, amely után a replikátor újra továbbít egy üzenetet, ha nem kap nyugtázást egy művelethez.
MaxReplicationMessageSize	Bájt	50 MB	Egyetlen üzenetben továbbítható replikációs adatok maximális mérete.
MaxPrimaryReplicationQueueSize	Műveletek száma	1024	Az elsődleges üzenetsor műveleteinek maximális száma. A művelet felszabadul, miután az elsődleges replikátor nyugtát kap az összes másodlagos replikátortól. Ennek az értéknek 64-nél nagyobbnak és 2-nél nagyobbnak kell lennie.
MaxSecondaryReplicationQueueSize	Műveletek száma	2048	A másodlagos üzenetsor műveleteinek maximális száma. A művelet felszabadul, miután az állapota magas rendelkezésre állásúvá válik az állandóság révén. Ennek az értéknek 64-nél nagyobbnak és 2-nél nagyobbnak kell lennie.

Tárolókonfiguráció

A tárolókonfigurációk a replikált állapot megőrzéséhez használt helyi tároló konfigurálására szolgálnak. Az alapértelmezett konfigurációt a Visual Studio-sablon hozza létre, és elegendőnek kell lennie. Ez a szakasz a helyi áruház hangolásához elérhető további konfigurációkról szól.

Szakasz neve

<ActorName>ServiceLocalStoreConfig

Konfigurációnevek

Name	Unit (Egység)	Alapértelmezett érték	Megjegyzések
MaxAsyncCommitDelayInMilliseconds	Ezredmásodperc	200	Beállítja a tartós helyi tároló véglegesítéseinek maximális kötegelési időközét.
MaxVerPages	Oldalak száma	16384	A helyi áruház adatbázisában található verziólapok maximális száma. Meghatározza a függőben lévő tranzakciók maximális számát.

Minta konfigurációs fájl

<?xml version="1.0" encoding="utf-8"?>
<Settings xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/2011/01/fabric">
   <Section Name="MyActorServiceReplicatorConfig">
      <Parameter Name="ReplicatorEndpoint" Value="MyActorServiceReplicatorEndpoint" />
      <Parameter Name="BatchAcknowledgementInterval" Value="0.05"/>
   </Section>
   <Section Name="MyActorServiceLocalStoreConfig">
      <Parameter Name="MaxVerPages" Value="8192" />
   </Section>
   <Section Name="MyActorServiceReplicatorSecurityConfig">
      <Parameter Name="CredentialType" Value="X509" />
      <Parameter Name="FindType" Value="FindByThumbprint" />
      <Parameter Name="FindValue" Value="9d c9 06 b1 69 dc 4f af fd 16 97 ac 78 1e 80 67 90 74 9d 2f" />
      <Parameter Name="StoreLocation" Value="LocalMachine" />
      <Parameter Name="StoreName" Value="My" />
      <Parameter Name="ProtectionLevel" Value="EncryptAndSign" />
      <Parameter Name="AllowedCommonNames" Value="My-Test-SAN1-Alice,My-Test-SAN1-Bob" />
   </Section>
</Settings>

Megjegyzések

A BatchAcknowledgementInterval paraméter szabályozza a replikáció késését. A "0" érték a lehető legalacsonyabb késést eredményezi az átviteli sebesség költségén (mivel több nyugtázási üzenetet kell küldeni és feldolgozni, amelyek mindegyike kevesebb nyugtát tartalmaz). Minél nagyobb a BatchAcknowledgementInterval értéke, annál nagyobb a replikáció teljes átviteli sebessége a nagyobb műveleti késés árán. Ez közvetlenül a tranzakciós véglegesítések késését jelenti.