Azure Virtual Network 経由で HDInsight 上の Apache Kafka に接続する

[アーティクル]
06/14/2024

Azure Virtual Network 経由で HDInsight 上の Apache Kafka へ直接接続する方法について説明します。このドキュメントでは、次の構成での Kafka への接続の詳細を示します。

オンプレミスネットワーク内のリソースからの接続。この接続は、ローカルネットワーク上の VPN デバイス (ソフトウェアまたはハードウェア) を使用して確立します。
VPN ソフトウェアクライアントを使用した開発環境からの接続。

注意

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。作業を始めるには、「Azure PowerShell をインストールする」を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

アーキテクチャと計画

HDInsight では、パブリックインターネット経由で Kafka に直接接続することはできません。代わりに、Kafka クライアント (プロデューサーおよびコンシューマー) で次の接続方法のいずれかを使用する必要があります。

HDInsight 上で Kafka と同じ仮想ネットワーク内でクライアントを実行する。この構成は、「HDInsight での Apache Kafka の開始」で使用されているものです。クライアントは、HDInsight のクラスター上、または同じネットワーク内の別の仮想マシン上で直接実行します。
オンプレミスネットワークなどのプライベートネットワークを仮想ネットワークに接続する。この構成では、オンプレミスネットワーク内のクライアントから直接 Kafka を操作することができます。この構成を有効にするには、次のタスクを実行します。
1. 仮想ネットワークを作成します。
2. サイト間構成を使用する VPN ゲートウェイを作成します。このドキュメントで使用する構成では、オンプレミスネットワーク内の VPN ゲートウェイデバイスへ接続します。
3. 仮想ネットワーク内に DNS サーバーを作成します。
4. 各ネットワークの DNS サーバー間の転送を構成します。
5. 仮想ネットワーク内の HDInsight クラスターに Kafka を作成します。
  
  詳細については、「オンプレミスネットワークから Apache Kafka に接続する」セクションを参照してください。
VPN ゲートウェイと VPN クライアントを使用して、仮想ネットワークに各マシンを接続する。この構成を有効にするには、次のタスクを実行します。
1. 仮想ネットワークを作成します。
2. ポイント対サイト構成を使用する VPN ゲートウェイを作成します。この構成は、Windows と macOS の両方のクライアントで使用することができます。
3. 仮想ネットワーク内の HDInsight クラスターに Kafka を作成します。
4. IP を提供するように Kafka を構成します。この構成を行うことで、クライアントでドメイン名の代わりにブローカー IP アドレスを使用して接続を行えるようになります。
5. 開発システムに VPN クライアントをダウンロードして使用します。
  
  詳細については、「VPN クライアントを使用して Apache Kafka に接続する」セクションを参照してください。
  警告
  
  この構成には次の制限があるため、推奨されるのは開発用途のみです。
  - 各クライアントは、VPN ソフトウェアクライアントを使用して接続する必要があります。
  - この VPN クライアントは仮想ネットワークに名前解決要求を渡さないため、Kafka との通信には IP アドレスを使用する必要があります。 IP で通信を行うには、Kafka クラスターで追加の構成を行う必要があります。

仮想ネットワークにおける HDInsight の使用方法の詳細については、Azure HDInsight クラスター用の仮想ネットワークの計画に関するページを参照してください。

オンプレミスネットワークから Apache Kafka に接続する

「Connect HDInsight to your on-premises network (オンプレミスネットワークに HDInsight を接続する)」の手順に従って、オンプレミスネットワークと通信する Kafka クラスターを作成します。

重要

HDInsight クラスターの作成時には、クラスター種類で Kafka を選択します。

これらの手順により、次の構成が作成されます。

Azure Virtual Network
サイト間 VPN ゲートウェイ
Azure Storage アカウント (HDInsight で使用します)
HDInsight 上の Kafka

Kafka クライアントがオンプレミスからクラスターへ接続できることを確認するには、「例: Python クライアント」セクションの手順を実行します。

VPN クライアントを使用して Apache Kafka に接続する

このセクションの手順では、次の構成を作成します。

Azure Virtual Network
ポイント対サイト VPN ゲートウェイ
Azure Storage アカウント (HDInsight で使用されます)
HDInsight 上の Kafka

ポイント対サイト接続での自己署名証明書の使用に関する記事の手順を実行します。このドキュメントでは、ゲートウェイに必要な証明書を作成しています。

PowerShell プロンプトを開き、次のコードを使用して Azure サブスクリプションにサインインします。

Connect-AzAccount
# If you have multiple subscriptions, uncomment to set the subscription
#Select-AzSubscription -SubscriptionName "name of your subscription"

次のコードを使用して、構成情報を含む変数を作成します。

# Prompt for generic information
$resourceGroupName = Read-Host "What is the resource group name?"
$baseName = Read-Host "What is the base name? It is used to create names for resources, such as 'net-basename' and 'kafka-basename':"
$location = Read-Host "What Azure Region do you want to create the resources in?"
$rootCert = Read-Host "What is the file path to the root certificate? It is used to secure the VPN gateway."

# Prompt for HDInsight credentials
$adminCreds = Get-Credential -Message "Enter the HTTPS user name and password for the HDInsight cluster" -UserName "admin"
$sshCreds = Get-Credential -Message "Enter the SSH user name and password for the HDInsight cluster" -UserName "sshuser"

# Names for Azure resources
$networkName = "net-$baseName"
$clusterName = "kafka-$baseName"
$storageName = "store$baseName" # Can't use dashes in storage names
$defaultContainerName = $clusterName
$defaultSubnetName = "default"
$gatewaySubnetName = "GatewaySubnet"
$gatewayPublicIpName = "GatewayIp"
$gatewayIpConfigName = "GatewayConfig"
$vpnRootCertName = "rootcert"
$vpnName = "VPNGateway"

# Network settings
$networkAddressPrefix = "10.0.0.0/16"
$defaultSubnetPrefix = "10.0.0.0/24"
$gatewaySubnetPrefix = "10.0.1.0/24"
$vpnClientAddressPool = "172.16.201.0/24"

# HDInsight settings
$hdiWorkerNodes = 4
$hdiVersion = "3.6"
$hdiType = "Kafka"

次のコードを使用して、Azure リソースグループと仮想ネットワークを作成します。

# Create the resource group that contains everything
New-AzResourceGroup -Name $resourceGroupName -Location $location

# Create the subnet configuration
$defaultSubnetConfig = New-AzVirtualNetworkSubnetConfig -Name $defaultSubnetName `
    -AddressPrefix $defaultSubnetPrefix
$gatewaySubnetConfig = New-AzVirtualNetworkSubnetConfig -Name $gatewaySubnetName `
    -AddressPrefix $gatewaySubnetPrefix

# Create the subnet
New-AzVirtualNetwork -Name $networkName `
    -ResourceGroupName $resourceGroupName `
    -Location $location `
    -AddressPrefix $networkAddressPrefix `
    -Subnet $defaultSubnetConfig, $gatewaySubnetConfig

# Get the network & subnet that were created
$network = Get-AzVirtualNetwork -Name $networkName `
    -ResourceGroupName $resourceGroupName
$gatewaySubnet = Get-AzVirtualNetworkSubnetConfig -Name $gatewaySubnetName `
    -VirtualNetwork $network
$defaultSubnet = Get-AzVirtualNetworkSubnetConfig -Name $defaultSubnetName `
    -VirtualNetwork $network

# Set a dynamic public IP address for the gateway subnet
$gatewayPublicIp = New-AzPublicIpAddress -Name $gatewayPublicIpName `
    -ResourceGroupName $resourceGroupName `
    -Location $location `
    -AllocationMethod Dynamic
$gatewayIpConfig = New-AzVirtualNetworkGatewayIpConfig -Name $gatewayIpConfigName `
    -Subnet $gatewaySubnet `
    -PublicIpAddress $gatewayPublicIp

# Get the certificate info
# Get the full path in case a relative path was passed
$rootCertFile = Get-ChildItem $rootCert
$cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2($rootCertFile)
$certBase64 = [System.Convert]::ToBase64String($cert.RawData)
$p2sRootCert = New-AzVpnClientRootCertificate -Name $vpnRootCertName `
    -PublicCertData $certBase64

# Create the VPN gateway
New-AzVirtualNetworkGateway -Name $vpnName `
    -ResourceGroupName $resourceGroupName `
    -Location $location `
    -IpConfigurations $gatewayIpConfig `
    -GatewayType Vpn `
    -VpnType RouteBased `
    -EnableBgp $false `
    -GatewaySku Standard `
    -VpnClientAddressPool $vpnClientAddressPool `
    -VpnClientRootCertificates $p2sRootCert

警告

このプロセスは、完了するまで数分かかる可能性があります。

次のコードを使用して、Azure Storage アカウントと BLOB コンテナーを作成します。

# Create the storage account
New-AzStorageAccount `
    -ResourceGroupName $resourceGroupName `
    -Name $storageName `
    -SkuName Standard_GRS `
    -Location $location `
    -Kind StorageV2 `
    -EnableHttpsTrafficOnly 1

# Get the storage account keys and create a context
$defaultStorageKey = (Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName `
    -Name $storageName)[0].Value
$storageContext = New-AzStorageContext -StorageAccountName $storageName `
    -StorageAccountKey $defaultStorageKey

# Create the default storage container
New-AzStorageContainer -Name $defaultContainerName `
    -Context $storageContext

次のコードを使用して、HDInsight クラスターを作成します。

# Create the HDInsight cluster
New-AzHDInsightCluster `
    -ResourceGroupName $resourceGroupName `
    -ClusterName $clusterName `
    -Location $location `
    -ClusterSizeInNodes $hdiWorkerNodes `
    -ClusterType $hdiType `
    -OSType Linux `
    -Version $hdiVersion `
    -HttpCredential $adminCreds `
    -SshCredential $sshCreds `
    -DefaultStorageAccountName "$storageName.blob.core.windows.net" `
    -DefaultStorageAccountKey $defaultStorageKey `
    -DefaultStorageContainer $defaultContainerName `
    -DisksPerWorkerNode 2 `
    -VirtualNetworkId $network.Id `
    -SubnetName $defaultSubnet.Id

警告

このプロセスは、完了するまで約 15 分かかります。

IP を提供するように Kafka を構成する

既定では、Apache Zookeeper は、Kafka ブローカーのドメイン名をクライアントに返します。この構成では、仮想ネットワーク内のエンティティに対して名前解決を使用できないため、VPN ソフトウェアクライアントは使用できません。このように構成する場合は、次の手順を実行して、ドメイン名ではなく IP アドレスを提供するように Kafka を構成します。

Web ブラウザーを使用し、https://CLUSTERNAME.azurehdinsight.net にアクセスします。 CLUSTERNAME を HDInsight クラスター上の Kafka の名前に置き換えます。

プロンプトが表示されたら、クラスターの HTTPS ユーザー名とパスワードを入力します。クラスターの Ambari Web UI が表示されます。
Kafka に関する情報を表示するには、左にある一覧から [Kafka] を選択します。
Kafka 構成を表示するには、上部中央の [Configs (構成)] を選択します。
kafka-env 構成を検索するには、右上の [Filter (フィルター)] フィールドに「kafka-env」と入力します。

IP アドレスを提供するように Kafka を構成するには、次のテキストを kafka-env-template フィールドの最後に追加します。

# Configure Kafka to advertise IP addresses instead of FQDN
IP_ADDRESS=$(hostname -i)
echo advertised.listeners=$IP_ADDRESS
sed -i.bak -e '/advertised/{/advertised@/!d;}' /usr/hdp/current/kafka-broker/conf/server.properties
echo "advertised.listeners=PLAINTEXT://$IP_ADDRESS:9092" >> /usr/hdp/current/kafka-broker/conf/server.properties

Kafka がリッスンするインターフェイスを構成するには、右上の [Filter (フィルター)] フィールドに「listeners」と入力します。
すべてのネットワークインターフェイスをリッスンするように Kafka を構成するには、 [listeners (リスナー)] フィールドの値を PLAINTEXT://0.0.0.0:9092に変更します。
構成を保存するには、 [Save (保存)] ボタンを使用します。変更を説明するテキストメッセージを入力します。変更が保存されたら、 [OK] を保存します。
Kafka の再起動時にエラーが発生しないようにするため、 [Service Actions (サービスアクション) ] ボタンを使用して [Turn On Maintenance Mode (メンテナンスモードの有効化)] を選択します。 [OK] を選択して、この操作を完了します。
Kafka を再起動するには、 [Restart (再起動)] ボタンをクリックし、 [Restart All Affected (影響を受けるものをすべて再起動)] を選択します。再起動を確認し、操作が完了したら [OK] ボタンを使用します。
メンテナンスモードを無効にするには、 [Service Actions (サービスアクション)] ボタンをクリックし、 [Turn Off Maintenance Mode (メンテナンスモードの無効化)] を選択します。 [OK] を選択して、この操作を完了します。

VPN ゲートウェイに接続する

VPN ゲートウェイに接続するには、ポイント対サイト接続の構成に関するドキュメントの「Azure への接続」セクションに従います。

例: Python クライアント

Kafka への接続を検証するには、次の手順に従って Python プロデューサーとコンシューマーを作成します。

次のいずれかの方法により、Kafka クラスター内のノードの完全修飾ドメイン名 (FQDN) と IP アドレスを取得します。

$resourceGroupName = "The resource group that contains the virtual network used with HDInsight"

$clusterNICs = Get-AzNetworkInterface -ResourceGroupName $resourceGroupName | where-object {$_.Name -like "*node*"}

$nodes = @()
foreach($nic in $clusterNICs) {
    $node = new-object System.Object
    $node | add-member -MemberType NoteProperty -name "Type" -value $nic.Name.Split('-')[1]
    $node | add-member -MemberType NoteProperty -name "InternalIP" -value $nic.IpConfigurations.PrivateIpAddress
    $node | add-member -MemberType NoteProperty -name "InternalFQDN" -value $nic.DnsSettings.InternalFqdn
    $nodes += $node
}
$nodes | sort-object Type

az network nic list --resource-group <resourcegroupname> --output table --query "[?contains(name,'node')].{NICname:name,InternalIP:ipConfigurations[0].privateIpAddress,InternalFQDN:dnsSettings.internalFqdn}"

このスクリプトは、$resourceGroupName が仮想ネットワークを含む Azure リソースグループの名前であることを前提としています。

返された情報を、次の手順で使用するために保存します。

次のコマンドを使用して、kafka-python クライアントをインストールします。
```
pip install kafka-python
```
データを Kafka に送信するには、次の Python コードを使用します。
```
from kafka import KafkaProducer
# Replace the `ip_address` entries with the IP address of your worker nodes
# NOTE: you don't need the full list of worker nodes, just one or two.
producer = KafkaProducer(bootstrap_servers=['kafka_broker_1','kafka_broker_2'])
for _ in range(50):
   producer.send('testtopic', b'test message')
```
'kafka_broker' エントリを、このセクションの手順 1 で返されたアドレスに置き換えます。
- ソフトウェア VPN クライアント を使用している場合、kafka_broker エントリはワーカーノードの IP アドレスに置き換えます。
- カスタム DNS サーバー経由での名前解決を有効化 している場合は、kafka_broker エントリをワーカーノードの FQDN に置き換えます。
  
  Note
  
  このコードは、文字列 test message をトピック testtopic に送信します。 HDInsight 上の Kafka の既定の構成では、このトピックが存在しない場合、このトピックは作成されません。「トピックを自動的に作成するように HDInsight 上の Apache Kafka を構成する方法」を参照してください。あるいは、メッセージを生成する前にトピックを手動で作成できます。
Kafka からメッセージを取得するには、次の Python コードを使用します。
```
from kafka import KafkaConsumer
# Replace the `ip_address` entries with the IP address of your worker nodes
# Again, you only need one or two, not the full list.
# Note: auto_offset_reset='earliest' resets the starting offset to the beginning
#       of the topic
consumer = KafkaConsumer(bootstrap_servers=['kafka_broker_1','kafka_broker_2'],auto_offset_reset='earliest')
consumer.subscribe(['testtopic'])
for msg in consumer:
  print (msg)
```
'kafka_broker' エントリを、このセクションの手順 1 で返されたアドレスに置き換えます。
- ソフトウェア VPN クライアント を使用している場合、kafka_broker エントリはワーカーノードの IP アドレスに置き換えます。
- カスタム DNS サーバー経由での名前解決を有効化 している場合は、kafka_broker エントリをワーカーノードの FQDN に置き換えます。

次のステップ

仮想ネットワークでの HDInsight の使用については、Azure HDInsight クラスター用の仮想ネットワークデプロイの計画に関するドキュメントを参照してください。

ポイント対サイト VPN ゲートウェイを使用する Azure Virtual Network の作成の詳細については、次のドキュメントを参照してください。

HDInsight 上の Apache Kafka の操作の詳細については、次のドキュメントを参照してください。

次の方法で共有

Azure Virtual Network 経由で HDInsight 上の Apache Kafka に接続する

アーキテクチャと計画

オンプレミスネットワークから Apache Kafka に接続する

VPN クライアントを使用して Apache Kafka に接続する

IP を提供するように Kafka を構成する

VPN ゲートウェイに接続する

例: Python クライアント

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Virtual Network 経由で HDInsight 上の Apache Kafka に接続する

アーキテクチャと計画

オンプレミス ネットワークから Apache Kafka に接続する

VPN クライアントを使用して Apache Kafka に接続する

IP を提供するように Kafka を構成する

VPN ゲートウェイに接続する

例: Python クライアント

次のステップ

フィードバック

その他のリソース

オンプレミスネットワークから Apache Kafka に接続する