Skip to content

Commit 0064a46

Browse files
committed
update state store pages
Signed-off-by: Ryan Winter <[email protected]>
1 parent 05391ff commit 0064a46

File tree

2 files changed

+14
-12
lines changed

2 files changed

+14
-12
lines changed

articles/iot-operations/create-edge-apps/howto-populate-state-store.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,14 +12,9 @@ ms.service: azure-iot-operations
1212

1313
# Populating the state store
1414

15-
The state store runs on the cluster and is accessed via MQTT broker using the MQTT5 protocol. There are currently two main ways of using the state store:
15+
The state store runs on the cluster and is accessed via MQTT broker using the MQTT5 protocol. The current method to populate the state store is using a CLI application.
1616

17-
1. Using the Azure IoT Operations SDKs to interact with the state store in your edge applications.
18-
1. Using the CLI tool to push data into the state store from an external computer.
1917

20-
## Azure IoT Operations SDKs
21-
22-
The SDKs are the recommended way to interact with the state store when developing edge applications. To read more about the SDKs and their available functions, refer to [Azure IoT Operations SDKs](overview-sdk-apps.md).
2318

2419
## State store CLI
2520

articles/iot-operations/create-edge-apps/overview-state-store.md

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -28,20 +28,27 @@ The state store allows an edge application to persist data on the edge. Typical
2828
1. Creating stateless applications
2929
1. Sharing state between applications
3030
1. Developing highly available applications
31-
1. Store data to be used by dataflow
31+
1. Storing data to be used by dataflows
32+
33+
## State store authorization
34+
35+
The state store extends MQTT broker's authorization mechanism, allowing individual clients to have optional read and write access to specific keys. Read more on how to [configure MQTT broker authorization](manage-mqtt-broker/howto-configure-authorization.md) for the state store.
3236

3337
## Interacting with the state store
3438

35-
The state store protocol is documented in [state store protocol](concept-about-state-store-protocol.md). SDKs are available for the state store for Go, C#, and Rust. Using an SDK is the recommended method of interacting with the state store, as implementing the interface can be complex.
39+
A CLI tool is available which enables interaction with the state store from a shell running on any machine.
3640

37-
Additional information about the [Azure IoT Operations SDKs](overview-sdk-apps.md) is available.
41+
1. Generate an X.509 certificate chain for authenticating with MQTT broker
42+
1. Create a `BrokerAuthentication` using x.509 certificates
43+
1. Create a `BrokerListener` as a LoadBalancer to enable off-cluster access
44+
1. Open ports on your cluster to enable access to the MQTT broker.
3845

39-
## State store authorization
46+
For instructions on setting up your cluster and using the tool, refer to the [state store CLI GitHub](https://github.com/Azure-Samples/explore-iot-operations/tree/main/tools/state-store-cli) page.
4047

41-
The state store extends MQTT broker's authorization mechanism, allowing individual clients to have optional read and write access to specific keys. Read more on how to [Configure MQTT broker authorization](manage-mqtt-broker/howto-configure-authorization.md).
48+
> [!NOTE]
49+
> SDKs to interact with the state store are currently in active development, and will be available in the near future to enable edge applications to interact with the state store.
4250
4351
## Related content
4452

4553
* [Learn about the MQTT broker state store protocol](concept-about-state-store-protocol.md)
46-
* [Learn how to populate the state store with data](howto-populate-state-store.md)
4754
* [Configure MQTT broker authorization](manage-mqtt-broker/howto-configure-authorization.md)

0 commit comments

Comments
 (0)