schema registry init

Author: kgremban

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

@@ -0,0 +1,46 @@
+---
+title: Create message schemas
+description: Learn how to install schema registry on your cluster and create message schemas to use with dataflows.
+author: kgremban
+ms.author: kgremban
+ms.topic: how-to
+ms.date: 08/03/2024
+
+#CustomerIntent: As an operator, I want to understand how I can use message schemas to filter and transform messages.
+---
+
+# Create message schemas
+
+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.
+
+## Create schema registry resources in Azure
+
+1. Create a storage account with hierarchical namespace enabled.
+
+   ```azurecli-interactive
+   az storage account create -n <STORAGE_ACCOUNT_NAME> -g <RESOURCE_GROUP> --enable-hierarchical-namespace --sku Standard_LRS
+   ```
+
+1. Create a schema registry resource.
+
+   ```azurecli-interactive
+   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>
+   ```
+
+## Install schema registry on your cluster
+
+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:
+
+   ```azurecli
+   az iot ops init --cluster <CLUSTER_NAME> -g <RESOURCE_GROUP> --sr-resource-id <SCHEMA_REGISTRY_RESOURCE_ID> -n <INSTANCE_NAME> --add-insecure-listener true
+   ```
+
+1. Verify that schema registry pods are running by using the `kubectl get pods` command.
+
+   ```bash
+   kubectl get pods -n azure-iot-operations
+   ```
+
+## Upload message schemas in the operations experience
+
+TODO

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

@@ -59,6 +59,14 @@ The configuration is specified by using Kubernetes CRDs. Based on this configura
 
 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.
 
+## Support for schema registry
+
+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.
+
+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.
+
+For more information, see [Define message schemas](./howto-schema-registry.md). 
+
 ## Related content
 
 - [Quickstart: Send asset telemetry to the cloud by using a dataflow](../get-started-end-to-end-sample/quickstart-upload-telemetry-to-cloud.md)

articles/iot-operations/toc.yml

@@ -95,6 +95,8 @@ items:
           href: connect-to-cloud/concept-dataflow-conversions.md
         - name: Enrich data
           href: connect-to-cloud/concept-dataflow-enrich.md
+      - name: Create message schemas
+        href: connect-to-cloud/howto-schema-registry.md
       - name: Manage dataflow profile
         href: connect-to-cloud/howto-configure-dataflow-profile.md
     - name: Manage layered network