Skip to content

Commit 6f65064

Browse files
Merge pull request #269371 from PatAltimore/patricka-blob-container
Remove Windows container details
2 parents 3c5b0cb + 8b9fc7e commit 6f65064

File tree

1 file changed

+15
-23
lines changed

1 file changed

+15
-23
lines changed

articles/iot-edge/how-to-deploy-blob.md

Lines changed: 15 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
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.
44
author: PatAltimore
55
ms.author: patricka
6-
ms.date: 02/14/2024
6+
ms.date: 03/18/2024
77
ms.topic: conceptual
88
ms.service: iot-edge
99
ms.reviewer: arduppal
@@ -91,16 +91,12 @@ A deployment manifest is a JSON document that describes which modules to deploy,
9191

9292
- 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.
9393

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)
10197

10298
> [!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.
104100
>
105101
> * 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.
106102
@@ -138,7 +134,7 @@ A deployment manifest is a JSON document that describes which modules to deploy,
138134
139135
:::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.":::
140136

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).
142138

143139
6. Select **Add**.
144140

@@ -161,7 +157,7 @@ After you create the deployment, you return to the **Devices** page of your IoT
161157
1. Select the IoT Edge device that you targeted with the deployment to open its details.
162158
1. In the device details, verify that the blob storage module is listed as both **Specified in deployment** and **Reported by device**.
163159

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.
165161

166162
## Deploy from Visual Studio Code
167163

@@ -215,16 +211,12 @@ Azure IoT Edge provides templates in Visual Studio Code to help you develop edge
215211

216212
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.
217213

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)
225217

226218
> [!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.
228220
>
229221
> * 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.
230222

@@ -255,7 +247,7 @@ Azure IoT Edge provides templates in Visual Studio Code to help you develop edge
255247

256248
:::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.":::
257249

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).
259251

260252
1. Save the *deployment.template.json* file.
261253

@@ -304,7 +296,7 @@ In addition, a blob storage module also requires the HTTPS_PROXY setting in the
304296

305297
1. Select **Update**, then **Review + Create**.
306298

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**.
308300

309301
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.
310302

0 commit comments

Comments
 (0)