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

[アーティクル]
06/01/2023

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

パラメーター	値の例	Notes
adminUserName	vmadmin	クラスター VM の管理者ユーザー名。
adminPassword	Password#1234	クラスター VM の管理者パスワード。
clusterName	mysfcluster123	クラスターの名前。
location	southcentralus	クラスターの場所。
certificateThumbprint		自己署名証明書を作成する場合または証明書ファイルを提供する場合は、値を空にする必要があります。以前にキーコンテナーにアップロードされた既存の証明書を使用するには、証明書の SHA1 サムプリントの値を入力します。例: "6190390162C988701DB5676EB81083EA608DCCF3"。
certificateUrlValue		自己署名証明書を作成する場合または証明書ファイルを提供する場合は、値を空にする必要があります。以前にキーコンテナーにアップロードされた既存の証明書を使用するには、証明書の URL を入力します。 (例: https://mykeyvault.vault.azure.net:443/secrets/mycertificate/02bea722c9ef4009a76c5052bcbf8346")。
sourceVaultValue		自己署名証明書を作成する場合または証明書ファイルを提供する場合は、値を空にする必要があります。以前にキーコンテナーにアップロードされた既存の証明書を使用するには、ソースコンテナー値を入力します。たとえば、"/subscriptions/333cc2c84-12fa-5778-bd71-c71c07bf873f/resourceGroups/MyTestRG/providers/Microsoft.KeyVault/vaults/MYKEYVAULT" と入力します。

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

次に、ネットワークトポロジを設定し、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

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

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

次のステップ

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