【Azure微服务 Service Fabric 】使用az命令建立Service Fabric集群

问题描述

在使用Service Fabric的快速入门文档: 将 Windows 容器部署到 Service Fabric。 其中在建立Service Fabric时候,示例代码中使用的是PowerShell脚本调用AZ模块来执行建立命令。可是在本地执行时,碰见了没法运行'Connect-AzAccount'等命令。node

Connect-AzAccount : The term 'Connect-AzAccount' is not recognized as the name of a cmdlet, function, script file, or
operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try
again.
At line:1 char:1
+ Connect-AzAccount -Environment AzureChinaCloud
+ ~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (Connect-AzAccount:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

 

因此决定使用az cli命令来代替,但官方文档中只给出了PowerShell的命令,因此须要使用对应的az命令来替换。主要替换的命令有三个。shell

1) Connect-AzAccount -Environment AzureChinaCloud 替换为 az cloud set --name AzureChinaCloudapi

2) Select-AzSubscription -SubscriptionId $subscriptionId 替换为 az account set --subscription $subscriptionIdapp

3) New-AzServiceFabricCluster 替换为 az sf cluster createide

# Create the Service Fabric cluster.
New-AzServiceFabricCluster -Name $clustername -ResourceGroupName $groupname -Location $clusterloc `
-ClusterSize $clustersize -VmUserName $adminuser -VmPassword $adminpwd -CertificateSubjectName $subname `
-CertificatePassword $certpwd -CertificateOutputFolder $certfolder `
-OS WindowsServer2016DatacenterwithContainers -VmSku $vmsku -KeyVaultName $vaultname

:在命令New-AzServiceFabricCluster中替换对应的参数便可。ui

 

如出现参数名不存在的状况,可使用-h 帮助命令来获取正常的参数。如az sf cluster create -hthis

参数错误cli.azure.cli.core.parser : az: error: unrecognized argumentsspa

使用help命令查看正确参数debug

 

重要部分(使用az CLI命令替换后的所有命令)

#Provide the subscription Id
$subscriptionId = 'yourSubscriptionId'

# Certificate variables.
$certpwd="Password#1234" | ConvertTo-SecureString -AsPlainText -Force
$certfolder="c:\mycertificates\"

# Variables for VM admin.
$adminuser="vmadmin"
$adminpwd="Password#1234" | ConvertTo-SecureString -AsPlainText -Force 

# Variables for common values
$clusterloc="chinaeast"
$clustername = "mysfcluster"
$groupname="mysfclustergroup"       
$vmsku = "Standard_D2_v2"
$vaultname = "mykeyvault"
$subname="$clustername.$clusterloc.cloudapp.chinacloudapi.cn"

# Set the number of cluster nodes. Possible values: 1, 3-99
$clustersize=5 

# Set the context to the subscription Id where the cluster will be created
az cloud set --name AzureChinaCloud
az login
az account set --subscription $subscriptionId

# Create the Service Fabric cluster.
az sf cluster create --cluster-name $clustername --resource-group $groupname --location $clusterloc `
 --cluster-size $clustersize --vm-user-name $adminuser --vm-password $adminpwd --certificate-subject-name $subname `
 --certificate-password $certpwd --certificate-output-folder  $certfolder `
 --os WindowsServer2016DatacenterwithContainers --vm-sku $vmsku --vault-name $vaultname --debug

注:日志

  • 脚本建立一个由五个节点组成的 Service Fabric 群集(使用 X.509 证书保护的群集)。该命令将建立一个自签名证书,并将其上传到新的 Key Vault。 该证书也会复制到本地目录"c:\mycertificates\"中。
  • 在执行中如须要查看日志输出,能够添加 --debug。

 

成功结果

当Service Fabric建立完成后,能够经过Visual Studio 2019发布建立好的Container到集群中。发布成功后,经过Service Fabric Explorer查看效果:

当根据文档部署Container后,访问SF集群URL并加上80端口(端口由发布Container时指定),既能够查看到IIS的默认页面.

 

在ServiceManifest.xml文件中配置Endpoint端口,在访问时候须要很是注意的一点是:确保SF的Load Balance中已开启该端口。能够经过psping方式来验证。

  <Resources>
    <Endpoints>
      <!-- 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 Name="MyContainerServiceTypeEndpoint" Port="80" />
    </Endpoints>

 

引用使用PowerShell AzModule命令建立SF集群的所有代码为:

建立群集

如下示例脚本建立一个由五个节点组成的 Service Fabric 群集(使用 X.509 证书保护的群集)。 该命令将建立一个自签名证书,并将其上传到新的 Key Vault。 该证书也会复制到本地目录。 可在建立 Service Fabric 群集中详细了解如何使用此脚本建立群集。

必要时,请使用 Azure PowerShell 指南中的说明安装 Azure PowerShell。

在运行如下脚本以前,请在 PowerShell 中运行 Connect-AzAccount -Environment AzureChinaCloud 来与 Azure 创建链接。

将如下脚本复制到剪贴板,并打开 Windows PowerShell ISE 。 将内容粘贴到空的 Untitled1.ps1 窗口。 而后,为脚本中的变量提供值:subscriptionIdcertpwdcertfolderadminuseradminpwd 等等。 运行该脚本以前,为 certfolder 指定的目录必须存在。

#Provide the subscription Id
$subscriptionId = 'yourSubscriptionId'

# Certificate variables.
$certpwd="Password#1234" | ConvertTo-SecureString -AsPlainText -Force
$certfolder="c:\mycertificates\"

# Variables for VM admin.
$adminuser="vmadmin"
$adminpwd="Password#1234" | ConvertTo-SecureString -AsPlainText -Force 

# Variables for common values
$clusterloc="chinaeast"
$clustername = "mysfcluster"
$groupname="mysfclustergroup"       
$vmsku = "Standard_D2_v2"
$vaultname = "mykeyvault"
$subname="$clustername.$clusterloc.cloudapp.chinacloudapi.cn"

# Set the number of cluster nodes. Possible values: 1, 3-99
$clustersize=5 

# Set the context to the subscription Id where the cluster will be created
Select-AzSubscription -SubscriptionId $subscriptionId

# Create the Service Fabric cluster.
New-AzServiceFabricCluster -Name $clustername -ResourceGroupName $groupname -Location $clusterloc `
-ClusterSize $clustersize -VmUserName $adminuser -VmPassword $adminpwd -CertificateSubjectName $subname `
-CertificatePassword $certpwd -CertificateOutputFolder $certfolder `
-OS WindowsServer2016DatacenterwithContainers -VmSku $vmsku -KeyVaultName $vaultname

为变量提供值后,按 F5 运行该脚本。

运行脚本并建立群集后,在输出中查找 ClusterEndpoint。 例如:

 

参考文档:

将 Windows 容器部署到 Service Fabrichttps://docs.azure.cn/zh-cn/service-fabric/service-fabric-quickstart-containers

az sf cluster: https://docs.microsoft.com/en-us/cli/azure/sf/cluster?view=azure-cli-latest#az_sf_cluster_create

相关文章
相关标签/搜索