Skip to content

Commit 8df6ce9

Browse files
committed
add operations experience steps
1 parent 2100b20 commit 8df6ce9

File tree

3 files changed

+18
-23
lines changed

3 files changed

+18
-23
lines changed

articles/iot-operations/connect-to-cloud/howto-schema-registry.md

Lines changed: 16 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to install schema registry on your cluster and create mes
44
author: kgremban
55
ms.author: kgremban
66
ms.topic: how-to
7-
ms.date: 08/03/2024
7+
ms.date: 09/23/2024
88

99
#CustomerIntent: As an operator, I want to understand how I can use message schemas to filter and transform messages.
1010
---
@@ -13,34 +13,29 @@ ms.date: 08/03/2024
1313

1414
Use schema registry to store and synchronize message schemas across the cloud and edge. Dataflows and other edge services use message schemas to filter and transform messages as they're routed across your industrial edge scenario.
1515

16-
## Create schema registry resources in Azure
16+
Schemas are documents that describe data to enable processing and contextualization.
1717

18-
1. Create a storage account with hierarchical namespace enabled.
18+
Message schemas describe the format of a message and its contents.
1919

20-
```azurecli-interactive
21-
az storage account create -n <STORAGE_ACCOUNT_NAME> -g <RESOURCE_GROUP> --enable-hierarchical-namespace --sku Standard_LRS
22-
```
20+
## Prerequisites
2321

24-
1. Create a schema registry resource.
22+
* An Azure IoT Operations instance deployed to a cluster along with a schema registry. For more information, see [Deployment details](../deploy-iot-ops/overview-deploy.md).
2523

26-
```azurecli-interactive
27-
az iot ops schema registry create -n <SCHEMA_REGISTRY_NAME> --sa-resource-id <STORAGE_ACCOUNT_RESOURCE_ID> --registry-namespace <SCHEMA_REGISTRY_NAME> -g <RESOURCE_GROUP>
28-
```
24+
## Upload message schemas in the operations experience
2925

30-
## Install schema registry on your cluster
26+
The operations experience uses schemas when you define dataflow endpoints.
3127

32-
1. Install schema registry as part of Azure IoT Operations by using the `--sr-resource-id` parameter in the `az iot ops init` command. For example:
28+
1. Save your message schema locally as a JSON file.
3329

34-
```azurecli
35-
az iot ops init --cluster <CLUSTER_NAME> -g <RESOURCE_GROUP> --sr-resource-id <SCHEMA_REGISTRY_RESOURCE_ID> -n <INSTANCE_NAME> --add-insecure-listener true
36-
```
30+
1. In the [operations experience](https://iotoperations.azure.com), select your site and Azure IoT Operations instance.
3731

38-
1. Verify that schema registry pods are running by using the `kubectl get pods` command.
32+
1. Select **Dataflows** > **Create dataflow**.
3933

40-
```bash
41-
kubectl get pods -n azure-iot-operations
42-
```
34+
1. Select **Source** > **MQTT**.
4335

44-
## Upload message schemas in the operations experience
36+
1. Select **Upload**.
37+
38+
:::image type="content" source="./media/howto-schema-registry/upload-schema.png" alt-text="Screenshot that shows uploading a message schema in the operations experience portal.":::
39+
40+
1. Browse to your message schema JSON file and select **Open**.
4541

46-
TODO
98.9 KB
Loading

articles/iot-operations/connect-to-cloud/overview-dataflow.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,13 +59,13 @@ The configuration is specified by using Kubernetes CRDs. Based on this configura
5959

6060
By using dataflows, you can efficiently manage your data paths. You can ensure that data is accurately sent, transformed, and enriched to meet your operational needs.
6161

62-
## Support for schema registry
62+
## Schema registry
6363

6464
Schema registry, a feature provided by Azure Device Registry Preview, is a synchronized repository in the cloud and at the edge. The schema registry stores the definitions of messages coming from edge assets, and then exposes an API to access those schemas at the edge. Southbound connectors like the OPC UA connector can create message schemas and add them to the schema registry or customers can upload schemas to the operations experience web UI.
6565

6666
Dataflows uses messages schemas at both the source and destination points. For sources, message schemas can work as filters to identify the specific messages that you want to capture for a dataflow. For destinations, message schemas help to transform the message into the format expected by the destination endpoint.
6767

68-
For more information, see [Define message schemas](./howto-schema-registry.md).
68+
For more information, see [Create message schemas](./howto-schema-registry.md).
6969

7070
## Related content
7171

0 commit comments

Comments
 (0)