Megosztás a következőn keresztül:

Különálló Windows-fürt konfigurációs beállításai

  • Cikk

Ez a cikk egy különálló Azure Service Fabric-fürt konfigurációs beállításait ismerteti, amelyek a ClusterConfig.json fájlban állíthatók be. Ezzel a fájllal adja meg a fürt csomópontjaival, biztonsági konfigurációjával, valamint a hálózati topológiával kapcsolatos információkat a hiba- és frissítési tartományok tekintetében. A konfigurációs beállítások módosítása vagy hozzáadása után létrehozhat egy önálló fürtöt , vagy frissítheti egy különálló fürt konfigurációját.

Az önálló Service Fabric-csomag letöltésekor a ClusterConfig.json-minták is megtalálhatók. A nevükben a "DevCluster" nevű minták létrehoznak egy fürtöt, amelyben mindhárom csomópont ugyanazon a gépen található, logikai csomópontok használatával. Ezen csomópontok közül legalább egyet elsődleges csomópontként kell megjelölni. Ez a fürttípus fejlesztési vagy tesztelési környezetekben hasznos. Éles fürtként nem támogatott. A "MultiMachine" nevű minták segítenek éles szintű fürtök létrehozásában, amelyek mindegyik csomópontja külön gépen található. Ezeknek a fürtöknek az elsődleges csomópontjainak száma a fürt megbízhatósági szintjén alapul. Az 5.7-es verzió, az API 05-2017-es verziójában eltávolítottuk a megbízhatósági szintű tulajdonságot. Ehelyett a kód a fürt legoptimalizáltabb megbízhatósági szintjét számítja ki. Ne próbáljon meg értéket beállítani ehhez a tulajdonsághoz az 5.7-től kezdődően.

  • ClusterConfig.Unsecure.DevCluster.json és ClusterConfig.Unsecure.MultiMachine.json bemutatja, hogyan hozhat létre nem biztonságos teszt- vagy éles fürtöt.

  • A ClusterConfig.Windows.DevCluster.json és a ClusterConfig.Windows.MultiMachine.json bemutatja, hogyan hozhat létre windowsos biztonsággal védett teszt- vagy éles fürtöket.

  • ClusterConfig.X509.DevCluster.json és ClusterConfig.X509.MultiMachine.json bemutatja, hogyan hozhat létre X509 tanúsítványalapú biztonsággal védett teszt- vagy éles fürtöket.

Most vizsgáljuk meg a ClusterConfig.json fájl különböző szakaszait.

Általános fürtkonfigurációk

Az általános fürtkonfigurációk a széles körű fürtspecifikus konfigurációkat fedik le, ahogyan az a következő JSON-kódrészletben is látható:

    "name": "SampleCluster",
    "clusterConfigurationVersion": "1.0.0",
    "apiVersion": "01-2017",

Bármilyen rövid nevet adhat a Service Fabric-fürtnek, ha hozzárendeli a névváltozóhoz. A clusterConfigurationVersion a fürt verziószáma. Növelje azt minden alkalommal, amikor frissíti a Service Fabric-fürtöt. Hagyja meg az apiVersion értékét az alapértelmezett értékre.

A fürt csomópontjai

A Service Fabric-fürt csomópontjait a csomópontok szakasz használatával konfigurálhatja, ahogy az alábbi kódrészlet is mutatja:

"nodes": [{
    "nodeName": "vm0",
    "iPAddress": "localhost",
    "nodeTypeRef": "NodeType0",
    "faultDomain": "fd:/dc1/r0",
    "upgradeDomain": "UD0"
}, {
    "nodeName": "vm1",
    "iPAddress": "localhost",
    "nodeTypeRef": "NodeType1",
    "faultDomain": "fd:/dc1/r1",
    "upgradeDomain": "UD1"
}, {
    "nodeName": "vm2",
    "iPAddress": "localhost",
    "nodeTypeRef": "NodeType2",
    "faultDomain": "fd:/dc1/r2",
    "upgradeDomain": "UD2"
}],

A Service Fabric-fürtöknek legalább három csomópontot kell tartalmazniuk. A beállításnak megfelelően további csomópontokat is hozzáadhat ehhez a szakaszhoz. Az alábbi táblázat az egyes csomópontok konfigurációs beállításait ismerteti:

Csomópont-konfiguráció Leírás
nodeName Bármilyen felhasználóbarát nevet adhat a csomópontnak.
iPAddress A parancsablak megnyitásával és a parancs beírásával ipconfigkeresse meg a csomópont IP-címét. Jegyezze fel az IPV4-címet, és rendelje hozzá az iPAddress változóhoz.
nodeTypeRef Minden csomóponthoz más csomóponttípus rendelhető. A csomóponttípusok a következő szakaszban vannak definiálva.
faultDomain A tartalék tartományok lehetővé teszik a fürtgazdák számára, hogy meghatározzák azokat a fizikai csomópontokat, amelyek megosztott fizikai függőségek miatt egyidejűleg meghiúsulhatnak.
upgradeDomain A frissítési tartományok olyan csomópontkészleteket írnak le, amelyek körülbelül egy időben leállnak a Service Fabric-frissítésekhez. Kiválaszthatja, hogy mely csomópontokhoz rendelje hozzá a frissítési tartományokat, mert a fizikai követelmények nem korlátozzák őket.

Fürt tulajdonságai

A Fürtkonfigurálás.json tulajdonság szakasza a fürt konfigurálására szolgál az alábbi módon:

Megbízhatóság

A megbízhatósági szint fogalma határozza meg a Service Fabric rendszerszolgáltatások replikáinak vagy példányainak számát, amelyek a fürt elsődleges csomópontjain futtathatók. Meghatározza ezeknek a szolgáltatásoknak és így a fürtnek a megbízhatóságát. Az értéket a rendszer a fürtlétrehozási és frissítési időpontban számítja ki.

Diagnosztika

A diagnosticsStore szakaszban konfigurálhatja a paramétereket a diagnosztika engedélyezéséhez, valamint a csomópont- vagy fürthibák elhárításához, ahogy az az alábbi kódrészletben látható:

"diagnosticsStore": {
    "metadata":  "Please replace the diagnostics store with an actual file share accessible from all cluster machines.",
    "dataDeletionAgeInDays": "7",
    "storeType": "FileShare",
    "IsEncrypted": "false",
    "connectionstring": "c:\\ProgramData\\SF\\DiagnosticsStore"
}

A metaadatok a fürt diagnosztikájának leírása, és a beállításoknak megfelelően állíthatók be. Ezek a változók segítenek az ETW-nyomkövetési naplók és összeomlási memóriaképek, valamint a teljesítményszámlálók gyűjtésében. Az ETW-nyomkövetési naplókkal kapcsolatos további információkért lásd: Nyomkövetési napló és ETW-nyomkövetés. Minden napló, beleértve az összeomlási memóriaképeket és a teljesítményszámlálókat is, átirányítható a gép connectionString mappájába. Az AzureStorage használatával diagnosztikát is tárolhat. Tekintse meg a következő mintarészletet:

"diagnosticsStore": {
    "metadata":  "Please replace the diagnostics store with an actual file share accessible from all cluster machines.",
    "dataDeletionAgeInDays": "7",
    "storeType": "AzureStorage",
    "IsEncrypted": "false",
    "connectionstring": "xstore:DefaultEndpointsProtocol=https;AccountName=[AzureAccountName];AccountKey=[AzureAccountKey]"
}

Biztonság

A biztonsági szakasz szükséges egy különálló Service Fabric-fürthöz. Az alábbi kódrészlet a szakasz egy részét mutatja be:

"security": {
    "metadata": "This cluster is secured using X509 certificates.",
    "ClusterCredentialType": "X509",
    "ServerCredentialType": "X509",
    . . .
}

A metaadatok a biztonságos fürt leírása, és a beállításoknak megfelelően állíthatók be. A ClusterCredentialType és a ServerCredentialType határozza meg a fürt és a csomópontok által implementálandó biztonsági típust. A tanúsítványalapú biztonsághoz X509 vagy Active Directory-alapú Windows rendszerre állíthatók be. A biztonsági szakasz többi része a biztonság típusán alapul. A biztonsági szakasz többi részének kitöltéséről további információt a Tanúsítványalapú biztonság önálló fürtön vagy Windows-biztonságönálló fürtön című témakörben talál.

Csomóponttípusok

A nodeTypes szakasz a fürt csomóponttípusát ismerteti. Legalább egy csomóponttípust meg kell adni egy fürthöz az alábbi kódrészletben látható módon:

"nodeTypes": [{
    "name": "NodeType0",
    "clientConnectionEndpointPort": "19000",
    "clusterConnectionEndpointPort": "19001",
    "leaseDriverEndpointPort": "19002",
    "serviceConnectionEndpointPort": "19003",
    "httpGatewayEndpointPort": "19080",
    "reverseProxyEndpointPort": "19081",
    "applicationPorts": {
        "startPort": "20575",
        "endPort": "20605"
    },
    "ephemeralPorts": {
        "startPort": "20606",
        "endPort": "20861"
    },
    "isPrimary": true
}]

A név az adott csomóponttípus rövid neve. Az ilyen csomóponttípusú csomópont létrehozásához rendelje hozzá a csomópont felhasználóbarát nevét az adott csomóponthoz tartozó NodeTypeRef változóhoz, ahogy korábban említettük. Minden csomóponttípushoz adja meg a használt kapcsolati végpontokat. Ezekhez a kapcsolati végpontokhoz tetszőleges portszámot választhat, feltéve, hogy nem ütköznek a fürt többi végpontjával. Többcsomópontos fürtön egy vagy több elsődleges csomópont található (azaz aPrimary értéke igaz), a megbízhatósági szinttől függően. Az elsődleges és a nemprimáris csomóponttípusokról a Service Fabric-fürt kapacitástervezési szempontjai című témakörben talál további információt a nodeTypes és a reliabilityLevel szolgáltatással kapcsolatban.

A csomóponttípusok konfigurálásához használt végpontok

  • clientConnectionEndpointPort az ügyfél által a fürthöz való csatlakozáshoz használt port az ügyfél API-k használatakor.
  • clusterConnectionEndpointPort az a port, ahol a csomópontok kommunikálnak egymással.
  • leaseDriverEndpointPort a fürtbérlet illesztőprogramja által használt port, amellyel megállapíthatja, hogy a csomópontok továbbra is aktívak-e.
  • serviceConnectionEndpointPort a csomóponton üzembe helyezett alkalmazások és szolgáltatások által az adott csomóponton található Service Fabric-ügyféllel való kommunikációhoz használt port.
  • A httpGatewayEndpointPort a Service Fabric Explorer által a fürthöz való csatlakozáshoz használt port.
  • az ephemeralPorts felülbírálja az operációs rendszer által használt dinamikus portokat. A Service Fabric ezen portok egy részét alkalmazásportként használja, a többi pedig elérhető az operációs rendszerhez. Ezt a tartományt az operációs rendszerben meglévő tartományra is leképezi, így minden célra használhatja a minta JSON-fájlokban megadott tartományokat. Győződjön meg arról, hogy a kezdő és a záró port közötti különbség legalább 255. Előfordulhat, hogy ütközésekbe ütközik, ha ez a különbség túl alacsony, mert ez a tartomány meg van osztva az operációs rendszerrel. A konfigurált dinamikus porttartomány megtekintéséhez futtassa a parancsot netsh int ipv4 show dynamicport tcp.
  • Az applicationPorts a Service Fabric-alkalmazások által használt portok. Az alkalmazásport-tartománynak elég nagynak kell lennie ahhoz, hogy lefedje az alkalmazások végpontkövetelményeit. Ennek a tartománynak kizárólagosnak kell lennie a gép dinamikus porttartományából, azaz a konfigurációban beállított rövid élettartamtartományból. A Service Fabric ezeket a portokat használja, amikor új portokra van szükség, és gondoskodik a tűzfal megnyitásáról ezekhez a portokhoz.
  • A reverseProxyEndpointPort egy opcionális fordított proxyvégpont. További információ: A Service Fabric fordított proxyja.

Naplóbeállítások

A fabricSettings szakaszban beállíthatja a Service Fabric-adatok és -naplók gyökérkönyvtárait. Ezeket a címtárakat csak a kezdeti fürtlétrehozás során szabhatja testre. Tekintse meg a szakasz következő mintarészletét:

"fabricSettings": [{
    "name": "Setup",
    "parameters": [{
        "name": "FabricDataRoot",
        "value": "C:\\ProgramData\\SF"
    }, {
        "name": "FabricLogRoot",
        "value": "C:\\ProgramData\\SF\\Log"
}]

Javasoljuk, hogy a FabricDataRoot és a FabricLogRoot nem operációsrendszer-meghajtót használjon. Nagyobb megbízhatóságot biztosít olyan helyzetek elkerüléséhez, amikor az operációs rendszer nem válaszol. Ha csak az adatgyökereket szabja testre, a naplógyökér egy szinttel az adatgyökér alá kerül.

Állapotalapú Reliable Services-beállítások

A KtlLogger szakaszban beállíthatja a Reliable Services globális konfigurációs beállításait. További információ ezekről a beállításokról: Állapotalapú megbízható szolgáltatások konfigurálása. Az alábbi példa bemutatja, hogyan módosíthatja a létrehozott megosztott tranzakciónaplót az állapotalapú szolgáltatások megbízható gyűjteményeinek visszaállításához:

"fabricSettings": [{
    "name": "KtlLogger",
    "parameters": [{
        "name": "SharedLogSizeInMB",
        "value": "4096"
    }]
}]

Bővítményfunkciók

A bővítményfunkciók konfigurálásához konfigurálja az apiVersion 04–2017-as vagy újabb verzióját, és konfigurálja az addonFeaturest az itt látható módon:

"apiVersion": "04-2017",
"properties": {
    "addOnFeatures": [
        "DnsService",
        "RepairManager"
    ]
}

Az összes elérhető bővítményfunkció a Service Fabric REST API-referenciájában tekinthető meg.

Tárolótámogatás

Ha engedélyezni szeretné a tárolók támogatását a Windows Server-tárolók és a Hyper-V-tárolók önálló fürtökhöz, engedélyezni kell a DnsService bővítmény funkciót.

Következő lépések

Miután az önálló fürtbeállításnak megfelelően konfigurált egy teljes ClusterConfig.json fájlt, üzembe helyezheti a fürtöt. Kövesse az önálló Service Fabric-fürt létrehozása című témakör lépéseit.

Ha önálló fürt van üzembe helyezve, frissítheti az önálló fürt konfigurációját is.

Megtudhatja, hogyan jelenítheti meg a fürtöt Service Fabric Explorer.