You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-edge/how-to-deploy-blob.md
+15-23Lines changed: 15 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,9 @@
1
1
---
2
-
title: Deploy blob storage on module to your device - Azure IoT Edge
3
-
description: Deploy an Azure Blob Storage module to your IoT Edge device to store data at the edge.
2
+
title: Deploy blob storage on module to your device
3
+
description: Deploy and configure an Azure Blob Storage module to your IoT Edge device and store data at the edge.
4
4
author: PatAltimore
5
5
ms.author: patricka
6
-
ms.date: 02/14/2024
6
+
ms.date: 03/18/2024
7
7
ms.topic: conceptual
8
8
ms.service: iot-edge
9
9
ms.reviewer: arduppal
@@ -91,16 +91,12 @@ A deployment manifest is a JSON document that describes which modules to deploy,
91
91
92
92
- Replace `<mount>` according to your container operating system. Provide the name of a [volume](https://docs.docker.com/storage/volumes/) or the absolute path to an existing directory on your IoT Edge device where the blob module stores its data. The storage mount maps a location on your device that you provide to a set location in the module.
93
93
94
-
- For Linux containers, the format is **\<your storage path or volume>:/blobroot**. For example:
95
-
- use [volume mount](https://docs.docker.com/storage/volumes/): `my-volume:/blobroot`
96
-
- use [bind mount](https://docs.docker.com/storage/bind-mounts/): `/srv/containerdata:/blobroot`. Make sure to follow the steps to [grant directory access to the container user](how-to-store-data-blob.md#granting-directory-access-to-container-user-on-linux)
97
-
- For Windows containers, the format is **\<your storage path or volume>:C:/BlobRoot**. For example:
98
-
- use [volume mount](https://docs.docker.com/storage/volumes/): `my-volume:C:/BlobRoot`.
99
-
- use [bind mount](https://docs.docker.com/storage/bind-mounts/): `C:/ContainerData:C:/BlobRoot`.
100
-
- Instead of using your local drive, you can map your SMB network location, for more information, see [using SMB share as your local storage](how-to-store-data-blob.md#using-smb-share-as-your-local-storage)
94
+
For Linux containers, the format is **\<your storage path or volume>:/blobroot**. For example:
95
+
- Use [volume mount](https://docs.docker.com/storage/volumes/): `my-volume:/blobroot`
96
+
- Use [bind mount](https://docs.docker.com/storage/bind-mounts/): `/srv/containerdata:/blobroot`. Make sure to follow the steps to [grant directory access to the container user](how-to-store-data-blob.md#granting-directory-access-to-container-user-on-linux)
101
97
102
98
> [!IMPORTANT]
103
-
> * Do not change the second half of the storage mount value, which points to a specific location in the Blob Storage on IoT Edge module. The storage mount must always end with **:/blobroot** for Linux containers and **:C:/BlobRoot** for Windows containers.
99
+
> * Do not change the second half of the storage mount value, which points to a specific location in the Blob Storage on IoT Edge module. The storage mount must always end with **:/blobroot** for Linux containers.
104
100
>
105
101
> * IoT Edge does not remove volumes attached to module containers. This behavior is by design, as it allows persisting the data across container instances such as upgrade scenarios. However, if these volumes are left unused, then it may lead to disk space exhaustion and subsequent system errors. If you use docker volumes in your scenario, then we encourage you to use docker tools such as [docker volume prune](https://docs.docker.com/engine/reference/commandline/volume_prune/) and [docker volume rm](https://docs.docker.com/engine/reference/commandline/volume_rm/) to remove the unused volumes, especially for production scenarios.
106
102
@@ -138,7 +134,7 @@ A deployment manifest is a JSON document that describes which modules to deploy,
138
134
139
135
:::image type="content" source="./media/how-to-deploy-blob/addmodule-tab4.png" alt-text="Screenshot showing the Module Twin Settings tab of the Add IoT Edge Module page.":::
140
136
141
-
For information on configuring deviceToCloudUploadProperties and deviceAutoDeleteProperties after your module has been deployed, see [Edit the Module Twin](https://github.com/Microsoft/vscode-azure-iot-toolkit/wiki/Edit-Module-Twin). For more information about desired properties, see [Define or update desired properties](module-composition.md#define-or-update-desired-properties).
137
+
For information on configuring deviceToCloudUploadProperties and deviceAutoDeleteProperties after your module is deployed, see [Edit the Module Twin](https://github.com/Microsoft/vscode-azure-iot-toolkit/wiki/Edit-Module-Twin). For more information about desired properties, see [Define or update desired properties](module-composition.md#define-or-update-desired-properties).
142
138
143
139
6. Select **Add**.
144
140
@@ -161,7 +157,7 @@ After you create the deployment, you return to the **Devices** page of your IoT
161
157
1. Select the IoT Edge device that you targeted with the deployment to open its details.
162
158
1. In the device details, verify that the blob storage module is listed as both **Specified in deployment** and **Reported by device**.
163
159
164
-
It may take a few moments for the module to be started on the device and then reported back to IoT Hub. Refresh the page to see an updated status.
160
+
It might take a few moments for the module to be started on the device and then reported back to IoT Hub. Refresh the page to see an updated status.
165
161
166
162
## Deploy from Visual Studio Code
167
163
@@ -215,16 +211,12 @@ Azure IoT Edge provides templates in Visual Studio Code to help you develop edge
215
211
216
212
1. Replace `<mount>` according to your container operating system. Provide the name of a [volume](https://docs.docker.com/storage/volumes/) or the absolute path to a directory on your IoT Edge device where you want the blob module to store its data. The storage mount maps a location on your device that you provide to a set location in the module.
217
213
218
-
- For Linux containers, the format is **\<your storage path or volume>:/blobroot**. For example:
219
-
- use [volume mount](https://docs.docker.com/storage/volumes/): `my-volume:/blobroot`
220
-
- use [bind mount](https://docs.docker.com/storage/bind-mounts/): `/srv/containerdata:/blobroot`. Make sure to follow the steps to [grant directory access to the container user](how-to-store-data-blob.md#granting-directory-access-to-container-user-on-linux)
221
-
- For Windows containers, the format is **\<your storage path or volume>:C:/BlobRoot**. For example:
222
-
- Use [volume mount](https://docs.docker.com/storage/volumes/): `my-volume:C:/BlobRoot`.
223
-
- Use [bind mount](https://docs.docker.com/storage/bind-mounts/): `C:/ContainerData:C:/BlobRoot`.
224
-
- Instead of using your local drive, you can map your SMB network location. For more information, see [using SMB share as your local storage](how-to-store-data-blob.md#using-smb-share-as-your-local-storage).
214
+
For Linux containers, the format is **\<your storage path or volume>:/blobroot**. For example:
215
+
- Use [volume mount](https://docs.docker.com/storage/volumes/): `my-volume:/blobroot`
216
+
- Use [bind mount](https://docs.docker.com/storage/bind-mounts/): `/srv/containerdata:/blobroot`. Make sure to follow the steps to [grant directory access to the container user](how-to-store-data-blob.md#granting-directory-access-to-container-user-on-linux)
225
217
226
218
> [!IMPORTANT]
227
-
> * Do not change the second half of the storage mount value, which points to a specific location in the Blob Storage on IoT Edge module. The storage mount must always end with **:/blobroot** for Linux containers and **:C:/BlobRoot** for Windows containers.
219
+
> * Do not change the second half of the storage mount value, which points to a specific location in the Blob Storage on IoT Edge module. The storage mount must always end with **:/blobroot** for Linux containers.
228
220
>
229
221
> * IoT Edge does not remove volumes attached to module containers. This behavior is by design, as it allows persisting the data across container instances such as upgrade scenarios. However, if these volumes are left unused, then it may lead to disk space exhaustion and subsequent system errors. If you use docker volumes in your scenario, then we encourage you to use docker tools such as [docker volume prune](https://docs.docker.com/engine/reference/commandline/volume_prune/) and [docker volume rm](https://docs.docker.com/engine/reference/commandline/volume_rm/) to remove the unused volumes, especially for production scenarios.
230
222
@@ -255,7 +247,7 @@ Azure IoT Edge provides templates in Visual Studio Code to help you develop edge
255
247
256
248
:::image type="content" source="./media/how-to-deploy-blob/devicetocloud-deviceautodelete.png" alt-text="Screenshot showing how to set desired properties for azureblobstorageoniotedge in Visual Studio Code.":::
257
249
258
-
For information on configuring deviceToCloudUploadProperties and deviceAutoDeleteProperties after your module has been deployed, see [Edit the Module Twin](https://github.com/Microsoft/vscode-azure-iot-toolkit/wiki/Edit-Module-Twin). For more information about container create options, restart policy, and desired status, see [EdgeAgent desired properties](module-edgeagent-edgehub.md#edgeagent-desired-properties).
250
+
For information on configuring deviceToCloudUploadProperties and deviceAutoDeleteProperties after your module is deployed, see [Edit the Module Twin](https://github.com/Microsoft/vscode-azure-iot-toolkit/wiki/Edit-Module-Twin). For more information about container create options, restart policy, and desired status, see [EdgeAgent desired properties](module-edgeagent-edgehub.md#edgeagent-desired-properties).
259
251
260
252
1. Save the *deployment.template.json* file.
261
253
@@ -304,7 +296,7 @@ In addition, a blob storage module also requires the HTTPS_PROXY setting in the
304
296
305
297
1. Select **Update**, then **Review + Create**.
306
298
307
-
1.Note that the proxy is added to the module in deployment manifest and select **Create**.
299
+
1.See the proxy is added to the module in deployment manifest and select **Create**.
308
300
309
301
1. Verify the setting by selecting the module from the device details page, and on the lower part of the **IoT Edge Modules Details** page select the **Environment Variables** tab.
0 commit comments