Merge pull request #299500 from PatAltimore/patricka-aio-freshness

Update freshness

Author: prmerger-automator[bot]

articles/iot-operations/create-edge-apps/howto-develop-mqttnet-apps.md

@@ -1,25 +1,25 @@
 ---
-title: Use MQTTnet to develop distributed application workloads
-description: Develop distributed applications that talk with MQTT broker using MQTTnet.
+title: Develop distributed application workloads with MQTTnet
+description: Learn how to develop distributed applications using MQTTnet to connect with MQTT broker.
 author: PatAltimore
 ms.author: patricka
 ms.subservice: azure-mqtt-broker
 ms.topic: how-to
 ms.custom:
   - ignite-2023
-ms.date: 10/22/2024
+ms.date: 05/07/2025
 
 #CustomerIntent: As an developer, I want to understand how to use MQTTnet to develop distributed apps that talk with MQTT broker.
 ms.service: azure-iot-operations
 ---
 
-# Use MQTTnet to develop distributed application workloads that connect to MQTT broker
+# Develop distributed application workloads with MQTTnet
 
-[MQTTnet](https://dotnet.github.io/MQTTnet/) is an open-source, high performance .NET library for MQTT based communication. This article uses a Kubernetes service account token and MQTTnet to connect to MQTT broker. You should use service account tokens to connect in-cluster applications.
+[MQTTnet](https://dotnet.github.io/MQTTnet/) is an open-source, high performance .NET library for MQTT based communication. This article explains how to use a Kubernetes service account token and MQTTnet to connect to MQTT broker. Use service account tokens to connect in-cluster applications.
 
 ## Sample code
 
-The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet/Program.cs) performs the following steps:
+The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet/Program.cs) does the following:
 
 1. Creates an MQTT client using the `MqttFactory` class:
 
@@ -28,16 +28,15 @@ The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/m
     var mqttClient = mqttFactory.CreateMqttClient();
     ```
 
-1. The [Kubernetes pod specification](#pod-specification) mounts the service account on the container file system. The contents of the file are read:
-##3. The mounted token is used as the password with well-known username `K8S-SAT`:
+1. The [Kubernetes pod specification](#pod-specification) mounts the service account on the container file system, and the file contents are read. The mounted token is used as the password with the well known username `K8S-SAT`:
 
     ```csharp
     static string sat_auth_file = "/var/run/secrets/tokens/mqtt-client-token";
     ...
     var satToken = File.ReadAllBytes(sat_auth_file);
     ```
 
-1. The MQTT client options are configured using the `MqttClientOptions` class. Using the `MqttClientOptionsBuilder` as advised in the [client](https://github.com/dotnet/MQTTnet/wiki/Client) documentation is the advised way of setting the options:
+1. The MQTT client options are configured using the `MqttClientOptions` class. The `MqttClientOptionsBuilder`, as recommended in the [client](https://github.com/dotnet/MQTTnet/wiki/Client) documentation, is the preferred way to set the options:
 
     ```csharp
     var mqttClientOptions = new MqttClientOptionsBuilder()
@@ -53,7 +52,7 @@ The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/m
     var response = await mqttClient.ConnectAsync(mqttClientOptions.Build(), CancellationToken.None);
     ```
 
-6. MQTT messages can be created using the properties directly or using `MqttApplicationMessageBuilder`. This class has overloads that allow dealing with different payload formats. The API of the builder is a fluent API. The following code shows how to compose an application message and publish them to an article called *sampletopic*:
+1. Create MQTT messages using properties directly or with `MqttApplicationMessageBuilder`. This class provides overloads for handling different payload formats. The builder API uses a fluent design. The following code shows how to compose an application message and publish it to a topic called *sampletopic*:
 
     ```csharp
     var applicationMessage = new MqttApplicationMessageBuilder()
@@ -66,7 +65,7 @@ The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/m
 
 ## Pod specification
 
-The `serviceAccountName` field in the pod configuration must match the service account associated with the token being used. Also, note the `serviceAccountToken.expirationSeconds` is set to **86400 seconds**, and once it expires, you need to reload the token from disk. This logic isn't implemented in this sample.
+The `serviceAccountName` field in the pod configuration must match the service account associated with the token being used. Also, note that the `serviceAccountToken.expirationSeconds` is set to **86400 seconds**, and when it expires, you need to reload the token from disk. This logic isn't implemented in this sample.
 
 ```yaml
 apiVersion: v1
@@ -86,7 +85,7 @@ spec:
 
   volumes:
 
-  # SAT token used to authenticate between the application and the MQTT broker  
+  # The SAT token authenticates the application with the MQTT broker  
   - name: mqtt-client-token
     projected:
       sources:
@@ -121,7 +120,7 @@ spec:
       value: "/var/run/secrets/tokens/mqtt-client-token"
 ```
 
-To run the sample, follow the instructions in its [README](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet).
+Run the sample by following the instructions in its [README](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet).
 
 ## Related content
 

articles/iot-operations/manage-mqtt-broker/overview-broker.md

@@ -1,29 +1,31 @@
 ---
-title: Publish and subscribe MQTT messages using MQTT broker
+title: Publish and Subscribe MQTT Messages Using Azure MQTT Broker
 description: Use MQTT broker to publish and subscribe to messages. Destinations include other MQTT brokers, data flows, and Azure cloud services.
+#customer intent: As a solution architect, I want to learn about the architecture of the Azure MQTT Broker so that I can design fault-tolerant and scalable IoT solutions.  
 author: PatAltimore
 ms.author: patricka
 ms.subservice: azure-mqtt-broker
 ms.topic: conceptual
 ms.custom:
   - ignite-2023
-ms.date: 11/04/2024
-
-#CustomerIntent: As an operator, I want to understand how I can use MQTT broker to publish and subscribe to MQTT topics.
+  - ai-gen-docs-bap
+  - ai-gen-title
+  - ai-seo-date:05/07/2025
+ms.date: 05/07/2025
 ms.service: azure-iot-operations
 ---
 
 # Azure IoT Operations built-in local MQTT broker
 
 [!INCLUDE [kubernetes-management-preview-note](../includes/kubernetes-management-preview-note.md)]
 
-Azure IoT Operations features an MQTT broker that's enterprise grade and compliant with standards. The MQTT broker is scalable, highly available, and Kubernetes-native. It provides the messaging plane for IoT Operations, enables bidirectional edge/cloud communication, and powers [event-driven applications](/azure/architecture/guide/architecture-styles/event-driven) at the edge.
+Azure IoT Operations includes an MQTT broker that's enterprise grade and standards compliant. The MQTT broker is scalable, highly available, and Kubernetes native. It provides the messaging plane for IoT Operations, enables bidirectional edge-to-cloud communication, and supports [event-driven applications](/azure/architecture/guide/architecture-styles/event-driven) at the edge.
 
 ## MQTT compliance
 
-MQTT has emerged as the common language that's used among protocols in the IoT space. MQTT's simple design allows a single broker to serve tens of thousands of clients simultaneously, with lightweight publish-subscribe topic creation and management. Many IoT devices support MQTT natively out of the box. Downstream translation gateways rationalize the long tail of IoT protocols into MQTT.
+MQTT is a common protocol in the IoT space. Its simple design lets a single broker serve thousands of clients simultaneously with lightweight publish-subscribe topic creation and management. Many IoT devices natively support MQTT. Downstream translation gateways convert various IoT protocols into MQTT.
 
-The MQTT broker underpins the messaging layer in IoT Operations and supports both MQTT v3.1.1 and MQTT v5. For more information about supported MQTT features, see [MQTT feature support in MQTT broker](../reference/mqtt-support.md).
+The MQTT broker supports the messaging layer in IoT Operations and is compatible with MQTT v3.1.1 and MQTT v5. For more information about supported MQTT features, see [MQTT feature support in MQTT broker](../reference/mqtt-support.md).
 
 ## Architecture
 
@@ -32,26 +34,26 @@ The MQTT broker has two major layers:
 - Stateless frontend layer
 - Stateful and sharded backend layer
 
-The frontend layer handles client connections and requests and routes them to the backend. The backend layer partitions data by different keys, such as a client ID for client sessions and a topic name for topic messages. It uses chain replication to replicate data within each partition.
+The frontend layer handles client connections and requests, and it routes them to the backend. The backend layer partitions data by keys, like a client ID for client sessions and a topic name for topic messages. The backend layer uses chain replication to copy data within each partition.
 
 The goals of the architecture are:
 
-- **Fault tolerance and isolation**: Message publishing continues if backend pods fail and prevents failures from propagating to the rest of the system.
+- **Fault tolerance and isolation**: Message publishing continues if backend pods fail, and failures don't propagate to the rest of the system.
 - **Failure recovery**: Automatic failure recovery without operator intervention.
-- **No message loss**: Delivery of messages if at least one frontend pod and one backend pod in a partition is running.
-- **Elastic scaling**: Horizontal scaling of publishing and subscribing throughput to support edge and cloud deployments.
-- **Consistent performance at scale**: Limit message latency overhead because of chain replication.
-- **Operational simplicity**: Minimum dependency on external components to simplify maintenance and complexity.
+- **No message loss**: Messages are delivered if at least one frontend pod and one backend pod in a partition are running.
+- **Elastic scaling**: Horizontal scaling of publishing and subscribing throughput supports edge and cloud deployments.
+- **Consistent performance at scale**: Limits message latency overhead due to chain replication.
+- **Operational simplicity**: Reduces dependency on external components to simplify maintenance and complexity.
 
 ## Configuration
 
-For configuration, the MQTT broker is composed of several Kubernetes custom resources that define different aspects of the broker's behavior and functionality:
+For configuration, the MQTT broker uses several Kubernetes custom resources to define different aspects of the broker's behavior and functionality:
 
 - The main resource is [Broker](/rest/api/iotoperations/broker), which defines the global settings like cardinality, memory usage profile, and diagnostic settings.
 - A Broker resource can have up to three [BrokerListeners](/rest/api/iotoperations/broker-listener), each of which listens for incoming MQTT connections on the specified service type (`NodePort`, `LoadBalancer`, or `ClusterIP`). Each BrokerListener resource can have multiple ports.
 - Each port within a BrokerListener resource can be associated with a [BrokerAuthentication](/rest/api/iotoperations/broker-authentication) resource and a [BrokerAuthorization](/rest/api/iotoperations/broker-authorization) resource. These authentication and authorization policies determine which clients can connect to the port and what actions they can perform on the broker.
 
-The relationship between Broker and BrokerListener is *one-to-many*. The relationship between BrokerListener and BrokerAuthentication/BrokerAuthorization is *many-to-many*. The entity relationship diagram for these resources is:
+The relationship between Broker and BrokerListener is *one-to-many*, while the relationship between BrokerListener and BrokerAuthentication/BrokerAuthorization is *many-to-many*. The entity relationship diagram for these resources is:
 
 <!-- ```mermaid
 erDiagram
@@ -89,11 +91,11 @@ erDiagram
 :::image type="content" source="media/overview-broker/default-broker-resources.svg" alt-text="Diagram that shows the default broker resources and relationships between them.":::
 
 > [!IMPORTANT]
-> To prevent unintentional disruption with communication between IoT Operations internal components, we recommend that you don't modify any default configuration.
+> To avoid disrupting communication between IoT Operations internal components, don't modify any default configuration.
 > 
-> To customize the MQTT broker deployment, *add* new resources like BrokerListeners, BrokerAuthentication, and BrokerAuthorization to the default Broker.
+> To customize the MQTT broker deployment, add new resources such as BrokerListeners, BrokerAuthentication, and BrokerAuthorization to the default Broker.
 > 
-> The Broker resource itself is immutable and can't be modified after deployment, but it only needs customization in advanced scenarios. To learn more about customizing the Broker resource, see [Customize default Broker](#customize-default-broker).
+> The Broker resource is immutable and can't be modified after deployment, but it requires customization only in advanced scenarios. To learn more about customizing the Broker resource, see [Customize default Broker](#customize-default-broker).
 
 In a full deployment, you could have multiple BrokerListeners, each with multiple ports, and each port could have different BrokerAuthentication and BrokerAuthorization resources associated with it.
 
@@ -104,7 +106,7 @@ For example, starting from the default setup, you add:
 - A BrokerAuthentication resource named *example-authn*, with a custom authentication method.
 - A BrokerAuthorization resource named *example-authz*, with your custom authorization settings.
 
-Then, if you configure all the new ports by using the same BrokerAuthentication and BrokerAuthorization resources, the setup looks like:
+If you configure all the new ports with the same BrokerAuthentication and BrokerAuthorization resources, the setup looks like this:
 
 <!-- ```mermaid
 erDiagram
@@ -165,18 +167,18 @@ erDiagram
 
 :::image type="content" source="media/overview-broker/full-broker-deployment-resources.svg" alt-text="Diagram that shows a full custom broker deployment and relationships between each.":::
 
-This way, you keep the default setup intact and add new resources to customize the MQTT broker deployment to your needs.
+This approach keeps the default setup intact and lets you add new resources to customize the MQTT broker deployment.
 
 ## Default Broker resource
 
-Each IoT Operations deployment can have only one Broker, and it must be named *default*. The default Broker resource is required for IoT Operations to function. It's immutable and can't be modified after deployment.
+Each IoT Operations deployment can have only one broker, and it must be named *default*. The default broker resource is required for IoT Operations to function. It's immutable and can't be modified after deployment.
 
 > [!CAUTION]
-> Don't delete the default Broker resource. Doing so disrupts communication between IoT Operations internal components, and the deployment stops functioning.
+> Don't delete the default broker resource. Doing so disrupts communication between IoT Operations internal components, and the deployment stops functioning.
 
 ### Customize default Broker
 
-Customizing the default Broker resource isn't required for most setups. The settings that require customization include:
+Customizing the default broker resource isn't required for most setups. The settings that require customization include:
 
 - [Cardinality](./howto-configure-availability-scale.md#configure-scaling-settings): Determines the broker's capacity to handle more connections and messages, and it enhances high availability if there are pod or node failures.
 - [Memory profile](./howto-configure-availability-scale.md#configure-memory-profile): Sets the maximum memory usage of the broker and how to handle memory usage as the broker scales up.
@@ -185,7 +187,7 @@ Customizing the default Broker resource isn't required for most setups. The sett
 - [Advanced MQTT client options](./howto-broker-mqtt-client-options.md): Configuration for advanced MQTT client options like session expiry, message expiry, and keep-alive settings.
 - [Encryption of internal traffic](./howto-encrypt-internal-traffic.md): Configuration for encrypting internal traffic between broker frontend and backend pods.
 
-You can customize the default broker only during initial deployment time, by using the Azure CLI or the Azure portal. A new deployment is required if you need different Broker configuration settings.
+You can customize the default broker only during the initial deployment, by using the Azure CLI or the Azure portal. A new deployment is required if you need different broker configuration settings.
 
 To customize the default Broker during deployment:
 
@@ -195,7 +197,7 @@ When you follow the guide to [deploy IoT Operations](../deploy-iot-ops/howto-dep
 
 # [Azure CLI](#tab/azure-cli)
 
-To configure settings like disk-backed message buffer and advanced MQTT client options, use the `--broker-config-file` flag during `az iot ops create`. To learn more, see [Azure CLI support for advanced MQTT broker configuration](https://aka.ms/aziotops-broker-config).
+To configure settings like the disk-backed message buffer and advanced MQTT client options, use the `--broker-config-file` flag during `az iot ops create`. To learn more, see [Azure CLI support for advanced MQTT broker configuration](https://aka.ms/aziotops-broker-config).
 
 # [Bicep](#tab/bicep)
 
@@ -208,13 +210,13 @@ Use the Azure portal or the Azure CLI to customize the default Broker resource.
 ---
 
 > [!IMPORTANT] 
-> You can't update the broker resource after the initial deployment. Configuration changes to cardinality, memory profile, or disk buffer aren't allowed post-deployment.
+> You can't update the broker resource after the initial deployment. Configuration changes to cardinality, memory profile, or the disk buffer aren't allowed post-deployment.
 >
 > As a workaround, when deploying Azure IoT Operations with the [az iot ops init](/cli/azure/iot/ops#az-iot-ops-init) command, you can include the `--broker-config-file` parameter with a JSON configuration file for the MQTT broker. For more information, see [Advanced MQTT broker config](https://github.com/Azure/azure-iot-ops-cli-extension/wiki/Advanced-Mqtt-Broker-Config) and [Configure core MQTT broker settings](../manage-mqtt-broker/howto-configure-availability-scale.md).
 
 ### View default Broker settings
 
-To view the settings for the default Broker:
+To view the settings for the default broker:
 
 # [Portal](#tab/portal)