建立在 Windows Server 上執行的獨立叢集

  • 發行項

您可以使用 Azure Service Fabric 在執行 Windows Server 的任何虛擬機器或電腦上建立 Service Fabric 叢集。 這表示您能夠在包含一組互連式 Windows Server 電腦的任何環境中部署和執行 Service Fabric 應用程式，不論該環境是內部部署或是透過任何雲端提供者來提供。 Service Fabric 會提供一個安裝封裝來建立稱為獨立 Windows Server 封裝的 Service Fabric 叢集。 傳統的 Service Fabric 叢集在 Azure 上是以受控服務的形式提供，而獨立 Service Fabric 叢集則是自助服務。 如需差異的詳細資訊，請參閱比較 Azure 和獨立 Service Fabric 叢集。

本文將逐步引導您完成建立 Service Fabric 獨立叢集的步驟。

注意

此獨立 Windows Server 套件已免費正式上市，可使用於生產部署。 此套件包含處於「預覽」狀態的新 Service Fabric 功能。 捲動至「此套件包含的預覽功能」區段，以取得預覽功能的清單。 您可以立即下載一份 EULA。

取得 Windows Server 套件的 Service Fabric 支援

下載 Windows Server 套件的 Service Fabric

若要建立叢集，請使用適用於 Windows Server 套件 (Windows Server 2012 R2 及更新版本) 的 Service Fabric，可在這裡找到︰
下載連結 - Service Fabric 獨立封裝 - Windows Server

可在這裡找到封裝內容的詳細資訊。

叢集建立時會自動下載 Service Fabric 執行階段封裝。 如果從未連線到網際網路的機器部署，請從這裡下載頻外執行階段封裝︰
下載連結 - Service Fabric 執行階段 - Windows Server

獨立叢集組態範例在此︰
獨立叢集組態範例

建立叢集

已使用安裝套件安裝數個範例叢集組態檔。 ClusterConfig.Unsecure.DevCluster.json 是最簡單的叢集組態︰在單一電腦上執行的不安全叢集 (包含三個節點)。 其他組態檔說明使用 X.509 憑證或 Windows 安全性保護之單一或多重電腦的叢集。 您不需要修改本教學課程的任何預設組態設定，但請瀏覽組態檔並熟悉設定。 nodes 區段描述叢集中的三個節點︰名稱、IP 位址、節點類型、容錯網域和升級網域。 properties 區段定義叢集的安全性、可靠性層級、診斷集合和節點類型。

本文所建立的叢集並不安全。 任何人都可以匿名方式連線並執行管理作業，所以一律要使用 X.509 憑證或 Windows 安全性來保護生產叢集。 只有在建立叢集時才會設定安全性，而且不可能在叢集建立之後啟用安全性。 更新設定檔會啟用憑證安全性或 Windows 安全性。 若要深入了解 Service Fabric 叢集安全性，請閱讀保護叢集。

步驟 1：建立叢集

案例 A：建立不安全的本機開發叢集

Service Fabric 可以使用範例中所含的 ClusterConfig.Unsecure.DevCluster.json 檔案，部署到一個電腦開發叢集。

將獨立封裝解除封裝到電腦，將範例組態檔複製到本機電腦，然後從獨立套件資料夾，透過系統管理員 PowerShell 工作階段，執行 CreateServiceFabricCluster.ps1 指令碼。

.\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.Unsecure.DevCluster.json -AcceptEULA

如需疑難排解的詳細資料，請參閱規劃及準備叢集部署的「環境設定」一節。

如果您完成執行開發案例，您可以參閱「移除叢集」一節中的步驟，從電腦中移除 Service Fabric 叢集。

案例 B︰建立多部電腦的叢集

在您完成規劃及準備叢集部署中詳述的規劃和準備步驟之後，就可以開始使用您的叢集設定檔，建立生產叢集。

部署和設定叢集的叢集系統管理員必須具有電腦的系統管理員權限。 您無法在網域控制站上安裝 Service Fabric。

  1. 系統會使用獨立套件中的 TestConfiguration.ps1 指令碼作為最佳做法分析程式，以驗證是否可以在指定的環境上部署叢集。 部署準備會列出必要條件和環境需求。 執行指令碼來確認您是否可以建立開發叢集︰

    .\TestConfiguration.ps1 -ClusterConfigFilePath .\ClusterConfig.json

    您應該會看到如下所示的輸出。 如果底層欄位 "Passed" 傳回為 "True"，表示已通過例行性檢查，並可根據輸入組態來部署該叢集。

    Trace folder already exists. Traces will be written to existing trace folder: C:\temp\Microsoft.Azure.ServiceFabric.WindowsServer\DeploymentTraces
Running Best Practices Analyzer...
Best Practices Analyzer completed successfully.

LocalAdminPrivilege        : True
IsJsonValid                : True
IsCabValid                 : True
RequiredPortsOpen          : True
RemoteRegistryAvailable    : True
FirewallAvailable          : True
RpcCheckPassed             : True
NoConflictingInstallations : True
FabricInstallable          : True
Passed                     : True

  2. 建立叢集︰ 執行 CreateServiceFabricCluster.ps1 指令碼，以跨組態中的每一部機器部署 Service Fabric 叢集。

    .\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -AcceptEULA

注意

部署追蹤會寫入您可以執行 CreateServiceFabricCluster.ps1 PowerShell 指令碼的 VM/電腦。 這些可以根據指令碼執行的目錄，在其子資料夾 DeploymentTraces 中找到。 若要查看是否已正確將 Service Fabric 部署到電腦，請在 FabricDataRoot 目錄中找到安裝的檔案，如叢集組態檔的 FabricSettings 區段 (預設為 c:\ProgramData\SF) 中所述。 同時，也要能在 [工作管理員] 看到 FabricHost.exe 和 Fabric.exe 處理序正在執行中。

案例 C：建立離線 (網際網路中斷連線的) 叢集

叢集建立時會自動下載 Service Fabric 執行階段套件。 將叢集部署到未連線到網際網路的電腦時，您必須另外下載 Service Fabric 執行階段套件，並在建立叢集時提供指向它的路徑。 可以從另一部有連線到網際網路電腦，到下載連結 - Service Fabric 執行階段 - Windows Server 另外下載執行階段套件。 將執行階段套件複製到您要部署離線叢集之處，然後執行 CreateServiceFabricCluster.ps1 搭配 -FabricRuntimePackagePath 參數建立叢集，如下列範例所示：

.\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -FabricRuntimePackagePath .\MicrosoftAzureServiceFabric.cab

.\ClusterConfig.json 和 .\MicrosoftAzureServiceFabric.cab 分別為叢集設定與執行階段 .cab 檔案的路徑。

步驟 2：連接到叢集

連線到叢集，以確認叢集正在執行且可用。 ServiceFabric PowerShell 模組會隨著執行階段套件一起安裝。 您可以從其中一個叢集節點，或透過 Service Fabric 執行階段從遠端電腦來連線到叢集。 Connect-ServiceFabricCluster Cmdlet 會建立叢集連線。

若要連線到不安全的叢集，請執行下列 PowerShell 命令：

Connect-ServiceFabricCluster -ConnectionEndpoint <*IPAddressofaMachine*>:<Client connection end point port>

例如：

Connect-ServiceFabricCluster -ConnectionEndpoint 192.13.123.234:19000

如需連線到叢集的其他範例，請參閱連線到安全的叢集。 連線到叢集之後，使用 Get-ServiceFabricNode Cmdlet 來顯示叢集中的節點清單以及每個節點的狀態資訊。 每個節點的 HealthState 應該為「正常」。

PS C:\temp\Microsoft.Azure.ServiceFabric.WindowsServer> Get-ServiceFabricNode |Format-Table

NodeDeactivationInfo NodeName IpAddressOrFQDN NodeType  CodeVersion  ConfigVersion NodeStatus NodeUpTime NodeDownTime HealthState
-------------------- -------- --------------- --------  -----------  ------------- ---------- ---------- ------------ -----------
                     vm2      localhost       NodeType2 5.6.220.9494 0                     Up 00:03:38   00:00:00              OK
                     vm1      localhost       NodeType1 5.6.220.9494 0                     Up 00:03:38   00:00:00              OK
                     vm0      localhost       NodeType0 5.6.220.9494 0                     Up 00:02:43   00:00:00              OK

步驟 3：使用 Service Fabric Explorer 將叢集視覺化

Service Fabric Explorer 是一個理想的工具，可將叢集視覺化及管理應用程式。 Service Fabric Explorer 是在叢集中執行的一個服務，您可以使用瀏覽器瀏覽至 http://localhost:19080/Explorer 來存取該服務。

叢集儀表板會提供您叢集的概觀，包括應用程式和節點健康情況的摘要。 節點檢視會顯示叢集的實體配置。 對於指定的節點，您可以檢查已經在該節點上部署程式碼的應用程式。

Service Fabric Explorer

新增和移除節點

當您的商務需求改變時，您可以在獨立 Service Fabric 叢集中新增或移除節點。 如需詳細步驟，請參閱在 Service Fabric 獨立叢集中新增或移除節點。

移除叢集

若要移除叢集，請從封裝資料夾執行 RemoveServiceFabricCluster.ps1 PowerShell 指令碼，然後傳入 JSON 組態檔的路徑。 您可以選擇指定刪除作業的記錄檔位置。

此指令碼可以在以系統管理員身分存取叢集組態檔中列為節點的所有電腦的任何電腦上執行。 執行此指令碼所在的電腦不一定是叢集的一部分。

# Removes Service Fabric from each machine in the configuration
.\RemoveServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -Force

# Removes Service Fabric from the current machine
.\CleanFabric.ps1

收集的遙測資料及如何選擇退出

根據預設，產品會收集 Service Fabric 使用情形的遙測來改善產品。 如果無法連線，則安裝會失敗，除非您選擇退出遙測。

  1. 這只是儘可能上傳，不會影響叢集功能。 只有執行主要容錯移轉管理員的節點才會傳送遙測。 沒有其他節點會傳送遙測。
  2. 遙測是由下列項目所組成：
  • 服務數
  • ServiceTypes 數目
  • Applications 的數目
  • ApplicationUpgrades 的數目
  • FailoverUnits 的數目
  • InBuildFailoverUnits 的數目
  • UnhealthyFailoverUnits 的數目
  • Replicas 的數目
  • InBuildReplicas 的數目
  • StandByReplicas 的數目
  • OfflineReplicas 的數目
  • CommonQueueLength
  • QueryQueueLength
  • FailoverUnitQueueLength
  • CommitQueueLength
  • Nodes 的數目
  • IsContextComplete: True/False
  • ClusterId︰這是針對每個叢集隨機產生的 GUID。
  • ServiceFabricVersion
  • 遙測上傳來源虛擬機器的 IP 位址

若要停用遙測，請將下列命令新增至叢集組態中的 properties：enableTelemetry: false。

此封裝包含的預覽功能

無。

注意

從適用於 Windows Server 的獨立叢集 GA 新版本 (5.3.204.x 版)著手，您可以手動或自動將叢集升級至未來的版本。 請參閱獨立 Service Fabric 叢集版本升級文件，以取得詳細資訊。

下一步