Azure 仮想ネットワークに Linux Service Fabric クラスターをデプロイする

この記事では、Azure CLI とテンプレートを使用して Linux Service Fabric クラスターを Azure 仮想ネットワーク (VNET) 内にデプロイする方法を学習します。 完了すると、クラウドで実行されているクラスターにアプリケーションをデプロイできるようになります。 PowerShell を使用して Windows クラスターを作成する場合は、Azure でのセキュリティで保護された Windows クラスターの作成に関するページを参照してください。

前提条件

作業を開始する前に、次のことを行います。

• Azure サブスクリプションを持っていない場合は無料アカウントを作成する
• Service Fabric CLI をインストールします。
• Azure CLI をインストールします。
• クラスターの主要な概念については、Azure クラスターの概要に関するページを参照してください。
• 運用環境用のクラスターのデプロイを計画して準備します。

次の手順で、7 ノードの Service Fabric クラスターを作成します。 Azure で Service Fabric クラスターを実行することによって発生するコストを計算するには、Azure 料金計算ツールを使用します。

テンプレートのダウンロードと詳細の確認

次の Resource Manager テンプレート ファイルをダウンロードします。

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

これらのテンプレートでは、7 つの仮想マシンと 3 つのノード タイプから成るセキュリティ保護されたクラスターが、仮想ネットワーク内にデプロイされます。 GitHub には他のサンプル テンプレートがあります。 AzureDeploy.json では、次のような多数のリソースがデプロイされます。

Service Fabric クラスター

Microsoft.ServiceFabric/clusters リソースでは、以下の特性によって Linux クラスターがデプロイされます。

• 3 つのノード タイプ
• プライマリ ノード タイプに 5 つのノード (テンプレート パラメーターで構成可能)、他のノード タイプにそれぞれ 1 つのノード
• OS: (Ubuntu 18.04 LTS / Ubuntu 20.04) (テンプレート パラメーターで構成可能)
• 証明書の保護 (テンプレート パラメーターで構成可能)
• DNS サービスが有効
• ブロンズ持続性レベル (テンプレート パラメーターで構成可能)
• シルバー信頼性レベル (テンプレート パラメーターで構成可能)
• クライアント接続エンドポイント: 19000 (テンプレート パラメーターで構成可能)
• HTTP ゲートウェイ エンドポイント: 19080 (テンプレート パラメーターで構成可能)

Azure Load Balancer

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 Virtual Machines にブートストラップし、ノード セキュリティを構成するために使われます。

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 ファイルでは、クラスターおよび関連リソースのデプロイに使用される多くの値が宣言されています。 実際のデプロイに合わせて変更する必要があるパラメーターの一部を次に示します。

仮想ネットワークとクラスターのデプロイ

次に、ネットワーク トポロジを設定し、Service Fabric クラスターをデプロイします。 AzureDeploy.json Resource Manager テンプレートでは、Service Fabric 用の仮想ネットワーク (VNET) とサブネットが作成されます。 このテンプレートを使用すると、証明書セキュリティが有効なクラスターもデプロイできます。 運用環境クラスターの場合は、証明機関 (CA) から取得した証明書をクラスター証明書として使用します。 自己署名証明書を使用して、テスト クラスターを保護することができます。

この記事のテンプレートでは、クラスター証明書を識別するために証明書の拇印を使用するクラスターがデプロイされます。 2 つの証明書が同じ拇印を持つことはできず、そのことが証明書の管理をより困難にしています。 デプロイされたクラスターで使用するのを、証明書の拇印から証明書共通名に切り替えることで、証明書の管理が大幅に単純化します。 証明書の管理に証明書共通名を使用するようにクラスターを更新する方法については、証明書共通名管理へのクラスターの変更に関するページを参照してください。

既存の証明書を使用したクラスターの作成

次のスクリプトでは、既存の証明書で保護された新しいクラスターをデプロイするために、az sf cluster create コマンドとテンプレートを使用しています。 また、このコマンドを使用して、Azure に新しいキー コンテナーを作成し、証明書をアップロードします。

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

リソースをクリーンアップする

次の記事にすぐに進まない場合は、料金の発生を避けるため、クラスターを削除することができます。

次のステップ

クラスターのスケーリングの方法について学びます。

この記事のテンプレートでは、クラスター証明書を識別するために証明書の拇印を使用するクラスターがデプロイされます。 2 つの証明書が同じ拇印を持つことはできず、そのことが証明書の管理をより困難にしています。 デプロイされたクラスターで使用するのを、証明書の拇印から証明書共通名に切り替えることで、証明書の管理が大幅に単純化します。 証明書の管理に証明書共通名を使用するようにクラスターを更新する方法については、証明書共通名管理へのクラスターの変更に関するページを参照してください。