Azure IoT Layered Network Management 用のサンプル ネットワーク環境を作成する (プレビュー)

CoreDNS を構成する

DNS のセットアップはさまざまな方法で実現できますが、この例では、K3S クラスターの既定の DNS サーバーである CoreDNS によって提供される拡張メカニズムを使用します。 解決する必要がある許可リストの URL が CoreDNS に追加されます。

レベル 4 Layered Network Management から configmap を作成する (プレビュー)

レベル 4 クラスターと Layered Network Management の準備ができたら、次の手順を実行します。

1. 次のコマンドを使用して、Layered Network Management サービスの IP アドレスを確認します。

   kubectl get services -n azure-iot-operations
   

   出力は次のようになります。 サービスの IP アドレスは 20.81.111.118 です。

   NAME          TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE
   lnm-level4   LoadBalancer   10.0.141.101   20.81.111.118   80:30960/TCP,443:31214/TCP   29s
   

2. 次のコマンドを使用して、構成マップを表示します。

   kubectl get cm -n azure-iot-operations
   

   出力は次の例のようになります。

   NAME                           DATA   AGE
   aio-lnm-level4-config          1      50s
   aio-lnm-level4-client-config   1      50s
   

3. aio-lnm-level4-client-config をカスタマイズします。 この構成は、レベル 3 クラスターから最上位レベルの Layered Network Management インスタンスにトラフィックを転送するために、レベル 3 セットアップの一部として必要です。

   # set the env var PARENT_IP_ADDR to the ip address of level 4 LNM instance.
     export PARENT_IP_ADDR="20.81.111.118"
   
   # run the script to generate a config map yaml
     kubectl get cm aio-lnm-level4-client-config -n azure-iot-operations -o yaml | yq eval '.metadata = {"name": "coredns-custom", "namespace": "kube-system"}' -| sed 's/PARENT_IP/'"$PARENT_IP_ADDR"'/' > configmap-custom-level4.yaml
   

   この手順では、configmap-custom-level4.yaml という名前のファイルを作成します。

K3S のレベル 3 CoreDNS を構成する

K3S クラスターを設定し、それをレベル 3 の分離レイヤーに移動した後、以前に生成されたカスタマイズ済みのクライアント構成でレベル 3 K3S の CoreDNS を構成します。

1. configmap-custom-level4.yaml をレベル 3 のホスト、またはクラスターにリモートでアクセスするシステムにコピーします。

2. 次のコマンドを実行します。

   # Create a config map called coredns-custom in the kube-system namespace
   kubectl apply -f configmap-custom-level4.yaml
   
   # Restart coredns
   kubectl rollout restart deployment/coredns -n kube-system
   
   # validate DNS resolution
   kubectl run -it --rm --restart=Never busybox --image=busybox:1.28 -- nslookup east.servicebus.windows.net
   
   # You should see the following output.
   kubectl run -it --rm --restart=Never busybox --image=busybox:1.28 -- nslookup east.servicebus.windows.net
   Server:    10.43.0.10
   Address 1: 10.43.0.10 kube-dns.kube-system.svc.cluster.local
   
   Name:      east.servicebus.windows.net
   Address 1: 20.81.111.118
   pod "busybox" deleted
   
   # Note: confirm that the resolved ip addresss matches the ip address of the level 4 Layered Network Management instance.
   

3. 前の手順では、クラスター内の許可リストに登録されている URL をレベル 4 に解決するように DNS 構成を設定します。 クラスター外の DNS が確実に同じ動作をするには、K3S クラスター内の CoreDNS にトラフィックを転送するように systemd-resolved を構成する必要があります。 K3S ホストで次のコマンドを実行します。次のディレクトリを作成します。

       sudo mkdir /etc/systemd/resolved.conf.d
   

   次の内容を含む lnm.conf という名前のファイルを作成します。 IP アドレスは、kube-system 名前空間で実行されている kube-dns サービスのレベル 3 クラスター IP アドレスである必要があります。

   [Resolve]
   DNS=<PUT KUBE-DNS SERVICE IP HERE> 
   DNSStubListener=no
   

   DNS リゾルバーを再起動します。

   sudo systemctl restart systemd-resolved
   

DNS サーバーを構成する

レベル 3 以下にのみ、カスタム DNS が必要です。 この例では、DNS 解決のために Ubuntu で実行する dnsmasq サーバーを使用します。

1. ローカル ネットワークに Ubuntu マシンをインストールします。

2. Ubuntu マシンで dnsmasq サービスを有効にします。

   apt update
   apt install dnsmasq
   systemctl status dnsmasq
   

3. 次に示すように /etc/dnsmasq.conf ファイルを変更して、これらのドメインを上位レベルにルーティングします。

   • IPv4 アドレスを 10.104.0.10 から、そのレベルのそれぞれの宛先アドレスに変更します。 この場合、親レベルの Layered Network Management サービスの IP アドレスです。
   • dnsmasq を実行している interface を確認し、必要に応じて値を変更します。

   次の構成には、Azure IoT Operations を有効にするために必要なエンドポイントのみが含まれています。

   # Add domains which you want to force to an IP address here.
   address=/management.azure.com/10.104.0.10
   address=/dp.kubernetesconfiguration.azure.com/10.104.0.10
   address=/.dp.kubernetesconfiguration.azure.com/10.104.0.10
   address=/login.microsoftonline.com/10.104.0.10
   address=/.login.microsoft.com/10.104.0.10
   address=/.login.microsoftonline.com/10.104.0.10
   address=/login.microsoft.com/10.104.0.10
   address=/mcr.microsoft.com/10.104.0.10
   address=/.data.mcr.microsoft.com/10.104.0.10
   address=/gbl.his.arc.azure.com/10.104.0.10
   address=/.his.arc.azure.com/10.104.0.10
   address=/k8connecthelm.azureedge.net/10.104.0.10
   address=/guestnotificationservice.azure.com/10.104.0.10
   address=/.guestnotificationservice.azure.com/10.104.0.10
   address=/sts.windows.nets/10.104.0.10
   address=/k8sconnectcsp.azureedge.net/10.104.0.10
   address=/.servicebus.windows.net/10.104.0.10
   address=/servicebus.windows.net/10.104.0.10
   address=/obo.arc.azure.com/10.104.0.10
   address=/.obo.arc.azure.com/10.104.0.10
   address=/adhs.events.data.microsoft.com/10.104.0.10
   address=/dc.services.visualstudio.com/10.104.0.10
   address=/go.microsoft.com/10.104.0.10
   address=/onegetcdn.azureedge.net/10.104.0.10
   address=/www.powershellgallery.com/10.104.0.10
   address=/self.events.data.microsoft.com/10.104.0.10
   address=/psg-prod-eastus.azureedge.net/10.104.0.10
   address=/.azureedge.net/10.104.0.10
   address=/api.segment.io/10.104.0.10
   address=/nw-umwatson.events.data.microsoft.com/10.104.0.10
   address=/sts.windows.net/10.104.0.10
   address=/.azurecr.io/10.104.0.10
   address=/.blob.core.windows.net/10.104.0.10
   address=/global.metrics.azure.microsoft.scloud/10.104.0.10
   address=/.prod.hot.ingestion.msftcloudes.com/10.104.0.10
   address=/.prod.microsoftmetrics.com/10.104.0.10
   address=/global.metrics.azure.eaglex.ic.gov/10.104.0.10
   
   # --address (and --server) work with IPv6 addresses too.
   address=/guestnotificationservice.azure.com/fe80::20d:60ff:fe36:f83
   address=/.guestnotificationservice.azure.com/fe80::20d:60ff:fe36:f833
   address=/.servicebus.windows.net/fe80::20d:60ff:fe36:f833
   address=/servicebus.windows.net/fe80::20d:60ff:fe36:f833
   
   # If you want dnsmasq to listen for DHCP and DNS requests only on
   # specified interfaces (and the loopback) give the name of the
   # interface (eg eth0) here.
   # Repeat the line for more than one interface.
   interface=enp1s0
   
   listen-address=::1,127.0.0.1,10.102.0.72
   
   no-hosts
   

4. 代わりに、address=/#/<IP of upper level Layered Network Management service> を IPv4 アドレス セクションに入れることもできます。 次に例を示します。

   # Add domains which you want to force to an IP address here.
   address=/#/<IP of upper level Layered Network Management service>
   
   # --address (and --server) work with IPv6 addresses too.
   address=/#/fe80::20d:60ff:fe36:f833
   
   # If you want dnsmasq to listen for DHCP and DNS requests only on
   # specified interfaces (and the loopback) give the name of the
   # interface (eg eth0) here.
   # Repeat the line for more than one interface.
   interface=enp1s0
   
   listen-address=::1,127.0.0.1,10.102.0.72
   
   no-hosts
   

5. dnsmasq サービスを再起動して、変更を適用します。

   sudo systemctl restart dnsmasq
   systemctl status dnsmasq