Skip to content

Commit 9b5a66a

Browse files
committed
Add OCI artifact media type requirements callout for WASM deploy doc
The operations experience discovers graph artifacts by their OCI config media type, not the layer media type. This callout explicitly documents the required media types and warns about CI/CD pipelines that may strip artifact metadata during registry transfers.
1 parent 8c0c726 commit 9b5a66a

1 file changed

Lines changed: 14 additions & 2 deletions

File tree

articles/iot-operations/develop-edge-apps/howto-deploy-wasm-graph-definitions.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: dominicbetts
55
ms.author: dobett
66
ms.service: azure-iot-operations
77
ms.topic: how-to
8-
ms.date: 02/25/2026
8+
ms.date: 03/24/2026
99
ai-usage: ai-assisted
1010

1111
---
@@ -139,7 +139,19 @@ oras pull ghcr.io/azure-samples/explore-iot-operations/filter:1.0.0
139139

140140
## Push modules to your registry
141141

142-
Once you have the sample modules and graphs, push them to your container registry. Replace `<YOUR_ACR_NAME>` with the name of your Azure Container Registry. To ensure the graphs and modules are visible in the operations experience web UI, add the `--config` and `--artifact-type` flags as shown in the following example:
142+
Once you have the sample modules and graphs, push them to your container registry. Replace `<YOUR_ACR_NAME>` with the name of your Azure Container Registry.
143+
144+
> [!IMPORTANT]
145+
> The operations experience discovers artifacts by their OCI **config** media type, not the layer media type. When you push artifacts to a registry, you must set the correct media types or the artifacts won't appear in the operations experience UI:
146+
>
147+
> | Artifact type | Required OCI config media type | Required layer media type |
148+
> |---|---|---|
149+
> | Graph definition | `application/vnd.microsoft.aio.graph.v1+yaml` | `application/yaml` |
150+
> | WASM module | `application/vnd.module.wasm.content.layer.v1+wasm` | `application/wasm` |
151+
>
152+
> If you use a CI/CD pipeline or other tooling to copy artifacts between registries, verify that it preserves these media types. Some tools strip or replace artifact metadata during transfer, which causes the artifacts to silently disappear from the operations experience.
153+
154+
To ensure the graphs and modules are visible in the operations experience web UI, add the `--config` and `--artifact-type` flags as shown in the following example:
143155

144156
```bash
145157
# Log in to your ACR

0 commit comments

Comments
 (0)