你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 Linux Service Fabric 群集部署到 Azure 虚拟网络

项目
01/04/2024

本文介绍了如何使用 Azure CLI 和模板将 Linux Service Fabric 群集部署到 Azure 虚拟网络 (VNET) 中。完成本教程后，云中会运行一个可在其中部署应用程序的群集。若要使用 PowerShell 创建 Windows 群集，请参阅在 Azure 上创建安全的 Windows 群集。

先决条件

开始之前：

如果没有 Azure 订阅，请创建一个免费帐户
安装 Service Fabric CLI
安装 Azure CLI
若要了解群集的关键概念，请阅读 Azure 群集概述
为生产群集部署计划并准备。

以下步骤将创建一个七节点 Service Fabric 群集。若要计算在 Azure 中运行 Service Fabric 群集的成本，请使用 Azure 定价计算器。

下载并浏览模板

下载以下资源管理器模板文件：

对于 Ubuntu 18.04 LTS：

AzureDeploy.json
- vmImageSku 属性设置为“18.04-LTS”
- Microsoft.ServiceFabric/clusters 资源的
  - apiVersion 设置为“2019-03-01”
  - vmImage 属性设置为“Ubuntu18_04”
AzureDeploy.Parameters.json

对于 Ubuntu 20.04 LTS：

AzureDeploy.json
- vmImageSku 属性设置为“20.04-LTS”
- Microsoft.ServiceFabric/clusters 资源的
  - apiVersion 设置为“2019-03-01”
  - vmImage 属性设置为“Ubuntu20_04”
AzureDeploy.Parameters.json

这些模板将包含七个虚拟机和三个节点类型的安全群集部署到虚拟网络中。其他示例模板可以在 GitHub 上找到。 AzureDeploy.json 部署若干资源，包括以下资源。

Service Fabric 群集

在 Microsoft.ServiceFabric/clusters 资源中，部署了具有以下特征的 Linux 群集：

三个节点类型
主节点类型包含五个节点（可在模板参数中配置），其他节点类型各包含一个节点
OS：(Ubuntu 18.04 LTS / Ubuntu 20.04)（可在模板参数中配置）
证书保护（可在模板参数中配置）
已启用 DNS 服务
铜级持久性级别（可在模板参数中配置）
银级可靠性级别（可在模板参数中配置）
客户端连接终结点：19000（可在模板参数中配置）
HTTP 网关终结点：19080（可在模板参数中配置）

Azure 负载均衡器

在 Microsoft.Network/loadBalancers 资源中，配置了负载均衡器，并为以下端口设置了探测和规则：

客户端连接终结点：19000
HTTP 网关终结点：19080
应用程序端口：80
应用程序端口：443

虚拟网络和子网

虚拟网络和子网的名称在模板参数中声明。虚拟网络和子网的地址空间也在模板参数中声明，并在 Microsoft.Network/virtualNetworks 资源中配置：

虚拟网络地址空间：10.0.0.0/16
Service Fabric 子网地址空间：10.0.2.0/24

如需其他任何应用程序端口，则需要调整 Microsoft.Network/loadBalancers 资源，以允许传入流量。

Service Fabric 扩展

在 Microsoft.Compute/virtualMachineScaleSets 资源中，已配置 Service Fabric Linux 扩展。此扩展用于将 Service Fabric 启动到 Azure 虚拟机以及配置节点安全性。

以下是 Service Fabric Linux 扩展的模板片段：

"extensions": [
  {
    "name": "[concat('ServiceFabricNodeVmExt','_vmNodeType0Name')]",
    "properties": {
      "type": "ServiceFabricLinuxNode",
      "autoUpgradeMinorVersion": true,
      "enableAutomaticUpgrade": true,
      "protectedSettings": {
        "StorageAccountKey1": "[listKeys(resourceId('Microsoft.Storage/storageAccounts', variables('supportLogStorageAccountName')),'2015-05-01-preview').key1]",
       },
       "publisher": "Microsoft.Azure.ServiceFabric",
       "settings": {
         "clusterEndpoint": "[reference(parameters('clusterName')).clusterEndpoint]",
         "nodeTypeRef": "[variables('vmNodeType0Name')]",
         "durabilityLevel": "Silver",
         "enableParallelJobs": true,
         "nicPrefixOverride": "[variables('subnet0Prefix')]",
         "certificate": {
           "commonNames": [
             "[parameters('certificateCommonName')]"
           ],
           "x509StoreName": "[parameters('certificateStoreValue')]"
         }
       },
       "typeHandlerVersion": "2.0"
     }
   },

设置模板参数

AzureDeploy.Parameters 文件声明用于部署群集和关联资源的多个值。可能需要使用某些参数来修改部署：

参数	示例值	注释
adminUserName	vmadmin	群集 VM 的管理员用户名。
adminPassword	Password#1234	群集 VM 的管理员密码。
clusterName	mysfcluster123	群集的名称。
location	southcentralus	群集的位置。
certificateThumbprint		如果创建自签名证书或提供证书文件，则值应为空。若要使用之前上传到密钥保管库的现有证书，请填写证书 SHA1 指纹值。例如“6190390162C988701DB5676EB81083EA608DCCF3”。
certificateUrlValue		如果创建自签名证书或提供证书文件，则值应为空。若要使用之前上传到 Key Vault 的现有证书，请填写证书 URL。例如，"https://mykeyvault.vault.azure.net:443/secrets/mycertificate/02bea722c9ef4009a76c5052bcbf8346"。
sourceVaultValue		如果创建自签名证书或提供证书文件，则值应为空。若要使用之前上传到 Key Vault 的现有证书，请填写源保管库值。例如“/subscriptions/333cc2c84-12fa-5778-bd71-c71c07bf873f/resourceGroups/MyTestRG/providers/Microsoft.KeyVault/vaults/MYKEYVAULT”。

部署虚拟网络和群集

接下来，设置网络拓扑并部署 Service Fabric 群集。 AzureDeploy.json 资源管理器模板为 Service Fabric 创建虚拟网络 (VNET) 和子网。该模板还会部署一个已启用证书安全性的群集。对于生产群集，请使用证书颁发机构 (CA) 提供的证书作为群集证书。可以使用自签名证书来保护测试群集。

本文中的模板部署一个群集，该群集使用证书指纹来标识群集证书。两个证书不能有相同的指纹，否则会增加证书管理的难度。将已部署的群集从使用证书指纹切换为使用证书公用名称会使证书管理更加简单。若要了解如何更新群集，以便使用证书公用名称进行证书管理，请阅读将群集更改为使用证书公用名称进行管理。

使用现有证书创建群集

以下脚本使用 az sf cluster create 命令和模板部署一个以现有证书保护的新群集。该命令还会在 Azure 中创建新的 Key Vault，并上传证书。

ResourceGroupName="sflinuxclustergroup"
Location="southcentralus"
Password="q6D7nN%6ck@6"
VaultName="linuxclusterkeyvault"
VaultGroupName="linuxclusterkeyvaultgroup"
CertPath="C:\MyCertificates\MyCertificate.pem"

# sign in to your Azure account and select your subscription
az login
az account set --subscription <guid>

# Create a new resource group for your deployment and give it a name and a location.
az group create --name $ResourceGroupName --location $Location

# Create the Service Fabric cluster.
az sf cluster create --resource-group $ResourceGroupName --location $Location \
   --certificate-password $Password --certificate-file $CertPath \
   --vault-name $VaultName --vault-resource-group $ResourceGroupName  \
   --template-file AzureDeploy.json --parameter-file AzureDeploy.Parameters.json

使用新的自签名证书创建群集

以下脚本使用 az sf cluster create 命令和模板在 Azure 中部署新群集。此命令还会在 Azure 中创建新的密钥保管库、向密钥保管库添加新的自签名证书，并将证书文件下载到本地。

ResourceGroupName="sflinuxclustergroup"
ClusterName="sflinuxcluster"
Location="southcentralus"
Password="q6D7nN%6ck@6"
VaultName="linuxclusterkeyvault"
VaultGroupName="linuxclusterkeyvaultgroup"
CertPath="C:\MyCertificates"

az sf cluster create --resource-group $ResourceGroupName --location $Location \
   --cluster-name $ClusterName --template-file C:\temp\cluster\AzureDeploy.json \
   --parameter-file C:\temp\cluster\AzureDeploy.Parameters.json --certificate-password $Password \
   --certificate-output-folder $CertPath --certificate-subject-name $ClusterName.$Location.cloudapp.azure.com \
   --vault-name $VaultName --vault-resource-group $ResourceGroupName

连接到安全群集

使用密钥通过 Service Fabric CLI 命令 sfctl cluster select 连接到群集。请注意仅针对自签名证书使用 --no-verify 选项。

sfctl cluster select --endpoint https://aztestcluster.southcentralus.cloudapp.azure.com:19080 \
--pem ./aztestcluster201709151446.pem --no-verify

检查是否已连接并使用 sfctl cluster health 命令检查群集是否处于正常状态。

sfctl cluster health

清理资源

如果不立即转到下一篇文章，可能需要删除该群集，以避免产生费用。

后续步骤

了解如何缩放群集。