Skip to content

Commit e76eee7

Browse files
Merge pull request #300907 from PatAltimore/patricka-freshness
Freshness review
2 parents df35928 + 74d710f commit e76eee7

File tree

1 file changed

+23
-23
lines changed

1 file changed

+23
-23
lines changed

articles/iot-edge/configure-connect-verify-gpu.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Configure your environment to connect and verify your GPU to proces
44
author: PatAltimore
55

66
ms.author: patricka
7-
ms.date: 05/29/2024
7+
ms.date: 06/05/2025
88
ms.topic: tutorial
99
ms.service: azure-iot-edge
1010
services: iot-edge
@@ -14,9 +14,9 @@ services: iot-edge
1414

1515
[!INCLUDE [iot-edge-version-all-supported](includes/iot-edge-version-all-supported.md)]
1616

17-
This tutorial shows you how to build a GPU-enabled virtual machine (VM). From the VM, you'll see how to run an IoT Edge device that allocates work from one of its modules to your GPU.
17+
This tutorial shows you how to build a GPU-enabled virtual machine (VM). From the VM, you run an IoT Edge device that allocates work from one of its modules to your GPU.
1818

19-
We'll use the Azure portal, the Azure Cloud Shell, and your VM's command line to:
19+
Use the Azure portal, the Azure Cloud Shell, and your VM's command line to:
2020
* Build a GPU-capable VM
2121
* Install the [NVIDIA driver extension](/azure/virtual-machines/extensions/hpccompute-gpu-linux) on the VM
2222
* Configure a module on an IoT Edge device to allocate work to a GPU
@@ -29,50 +29,50 @@ We'll use the Azure portal, the Azure Cloud Shell, and your VM's command line to
2929

3030
* Azure IoT Edge device
3131

32-
If you don't already have an IoT Edge device and need to quickly create one, run the following command. Use the [Azure Cloud Shell](../cloud-shell/overview.md) located in the Azure portal. Create a new device name for `<DEVICE-NAME>` and replace the IoT `<IOT-HUB-NAME>` with your own.
32+
If you don't have an IoT Edge device and want to quickly create one, run the following command. Use the [Azure Cloud Shell](../cloud-shell/overview.md) in the Azure portal. Create a new device name for `<DEVICE-NAME>` and replace `<YOUR-IOT-HUB-NAME>` with your IoT hub name.
3333

3434
```azurecli
3535
az iot hub device-identity create --device-id <YOUR-DEVICE-NAME> --edge-enabled --hub-name <YOUR-IOT-HUB-NAME>
3636
```
3737

38-
For more information on creating an IoT Edge device, see [Quickstart: Deploy your first IoT Edge module to a virtual Linux device](quickstart-linux.md). Later in this tutorial, we'll add an NVIDIA module to our IoT Edge device.
38+
For more information about creating an IoT Edge device, see [Quickstart: Deploy your first IoT Edge module to a virtual Linux device](quickstart-linux.md). Later in this article, you'll add an NVIDIA module to your IoT Edge device.
3939

4040
## Create a GPU-optimized virtual machine
4141

42-
To create a GPU-optimized virtual machine (VM), choosing the right size is important. Not all VM sizes accommodate GPU processing. In addition, there are different VM sizes for different workloads. For more information, see [GPU optimized virtual machine sizes](/azure/virtual-machines/sizes-gpu) or try the [Virtual machines selector](https://azure.microsoft.com/pricing/vm-selector/).
42+
To create a GPU-optimized virtual machine (VM), choose the right size. Not all VM sizes support GPU processing, and different VM sizes work best for different workloads. For more information, see [GPU optimized virtual machine sizes](/azure/virtual-machines/sizes-gpu) or try the [Virtual machines selector](https://azure.microsoft.com/pricing/vm-selector/).
4343

44-
Let's create an IoT Edge VM with the [Azure Resource Manager (ARM)](../azure-resource-manager/management/overview.md) template in GitHub, then configure it to be GPU-optimized.
44+
Create an IoT Edge VM with the [Azure Resource Manager (ARM)](../azure-resource-manager/management/overview.md) template in GitHub, then configure it to be GPU-optimized.
4545

46-
1. Go to the IoT Edge VM deployment template in GitHub: [Azure/iotedge-vm-deploy](https://github.com/Azure/iotedge-vm-deploy).
46+
1. Go to the IoT Edge VM deployment template in GitHub at [Azure/iotedge-vm-deploy](https://github.com/Azure/iotedge-vm-deploy).
4747

48-
1. Select the **Deploy to Azure** button, which initiates the creation of a custom VM for you in the Azure portal.
48+
1. Select the **Deploy to Azure** button to start creating a custom VM in the Azure portal.
4949

50-
1. Fill out the **Custom deployment** fields with your Azure credentials and resources:
50+
1. Enter your Azure credentials and resource information in the **Custom deployment** fields:
5151

5252
| **Property** | **Description or sample value** |
5353
| :----------------------- | -------------------------------------- |
5454
| Subscription | Choose your Azure account subscription.|
5555
| Resource group | Add your Azure resource group. |
5656
| Region | `East US` <br> GPU VMs aren't available in all regions. |
5757
| Dns Label Prefix | Create a name for your VM. |
58-
| Admin Username | `adminUser` <br> Alternatively, create your own user name. |
58+
| Admin Username | `adminUser` <br> Or create your own user name. |
5959
| Device Connection String | Copy your connection string from your IoT Edge device, then paste here. |
6060
| VM size | `Standard_NV6` |
61-
| Authentication type | Choose either **password** or **SSH Public Key**, then create a password or key pair name if needed. |
61+
| Authentication type | Choose **password** or **SSH Public Key**, then create a password or key pair name if needed. |
6262

6363
> [!TIP]
6464
>
6565
> Check which GPU VMs are supported in each region: [Products available by region](https://azure.microsoft.com/global-infrastructure/services/?regions=us-central,us-east,us-east-2,us-north-central,us-south-central,us-west-central,us-west,us-west-2,us-west-3&products=virtual-machines).
6666
>
67-
> To check [which region your Azure subscription allows](../azure-resource-manager/troubleshooting/error-sku-not-available.md?tabs=azure-cli#solution), try this Azure command from the Azure portal. The `N` in `Standard_N` means it's a GPU-enabled VM.
67+
> To check [which region your Azure subscription allows](../azure-resource-manager/troubleshooting/error-sku-not-available.md?tabs=azure-cli#solution), try this Azure command in the Azure portal. The `N` in `Standard_N` means it's a GPU-enabled VM.
6868
> ```azurecli
6969
> az vm list-skus --location <YOUR-REGION> --size Standard_N --all --output table
7070
> ```
7171
72-
1. Select the **Review + create** button at the bottom, then the **Create** button. Deployment can take up one minute to complete.
72+
1. Select the **Review + create** button at the bottom, then select the **Create** button. Deployment can take up to one minute.
7373
7474
## Install the NVIDIA extension
75-
Now that we have a GPU-optimized VM, let's install the [NVIDIA extension](/azure/virtual-machines/extensions/hpccompute-gpu-linux) on the VM using the Azure portal.
75+
Now that you have a GPU-optimized VM, install the [NVIDIA extension](/azure/virtual-machines/extensions/hpccompute-gpu-linux) on the VM using the Azure portal.
7676
7777
1. Open your VM in the Azure portal and select **Extensions + applications** from the left menu.
7878
@@ -96,7 +96,7 @@ Now that we have a GPU-optimized VM, let's install the [NVIDIA extension](/azure
9696
sudo apt install nvidia-utils-515
9797
```
9898

99-
Here's a list of all `nvidia-smi` versions. If you run `nvidia-smi` without installing it first, this list will print in your console.
99+
Here's a list of all `nvidia-smi` versions. If you run `nvidia-smi` without installing it first, this list prints in your console.
100100

101101
:::image type="content" source="media/configure-connect-verify-gpu/nvidia-smi-versions.png" alt-text="Screenshot of all `nvidia-smi` versions.":::
102102

@@ -105,13 +105,13 @@ Now that we have a GPU-optimized VM, let's install the [NVIDIA extension](/azure
105105
```bash
106106
nvidia-smi
107107
```
108-
109-
A confirmation table will appear, similar to this table.
108+
109+
A confirmation table appears, similar to this table.
110110

111111
:::image type="content" source="media/configure-connect-verify-gpu/nvidia-driver-installed.png" alt-text="Screenshot of the NVIDIA driver table.":::
112112

113113
> [!NOTE]
114-
> The NVIDIA extension is a simplified way to install the NVIDIA drivers, but you may need more customization. For more information about custom installations on N-series VMs, see [Install NVIDIA GPU drivers on N-series VMs running Linux](/azure/virtual-machines/linux/n-series-driver-setup).
114+
> The NVIDIA extension is a simplified way to install the NVIDIA drivers, but you might need more customization. For more information about custom installations on N-series VMs, see [Install NVIDIA GPU drivers on N-series VMs running Linux](/azure/virtual-machines/linux/n-series-driver-setup).
115115
116116
## Enable a module with GPU acceleration
117117

@@ -184,19 +184,19 @@ Let's add an [NVIDIA DIGITS](https://docs.nvidia.com/deeplearning/digits/index.h
184184

185185
1. Select the **Environment Variables** tab.
186186

187-
1. Add the environment variable name `NVIDIA_VISIBLE_DEVICES` with the value `0`. This variable controls which GPUs are visible to the containerized application running on the edge device. The `NVIDIA_VISIBLE_DEVICES` environment variable can be set to a comma-separated list of device IDs, which correspond to the physical GPUs in the system. For example, if there are two GPUs in the system with device IDs 0 and 1, the variable can be set to "NVIDIA_VISIBLE_DEVICES=0,1" to make both GPUs visible to the container. In this article, since the VM only has one GPU, we will use the first (and only) one.
187+
1. Add the environment variable name `NVIDIA_VISIBLE_DEVICES` with the value `0`. This variable controls which GPUs are visible to the containerized application running on the edge device. The `NVIDIA_VISIBLE_DEVICES` environment variable can be set to a comma-separated list of device IDs, which correspond to the physical GPUs in the system. For example, if there are two GPUs in the system with device IDs 0 and 1, the variable can be set to "NVIDIA_VISIBLE_DEVICES=0,1" to make both GPUs visible to the container. In this article, since the VM only has one GPU, we'll use the first (and only) one.
188188

189189
| Name | Type | Value |
190190
| :--------------------- | ---- | ----- |
191191
| NVIDIA_VISIBLE_DEVICES | Text | 0 |
192192

193193
1. Select **Add**.
194194

195-
1. Select **Review + create**. Your deployment manifest properties will appear.
195+
1. Select **Review + create**. Your deployment manifest properties appear.
196196

197197
1. Select **Create** to create the module.
198198

199-
1. Select **Refresh** to update your module list. The module will take a couple of minutes to show *running* in the **Runtime status**, so keep refreshing the device.
199+
1. Select **Refresh** to update your module list. The module takes a couple of minutes to show *running* in the **Runtime status**, so keep refreshing the device.
200200

201201
1. From your device, run this command to confirm your new NVIDIA module exists and is running.
202202

@@ -214,7 +214,7 @@ Let's add an [NVIDIA DIGITS](https://docs.nvidia.com/deeplearning/digits/index.h
214214

215215
If you want to continue with other IoT Edge tutorials, you can use the device that you created for this tutorial. Otherwise, you can delete the Azure resources that you created to avoid charges.
216216

217-
If you created your virtual machine and IoT hub in a new resource group, you can delete that group, which will delete all the associated resources. Double check the contents of the resource group to make sure that there's nothing you want to keep. If you don't want to delete the whole group, you can delete individual resources (virtual machine, device, or GPU-module) instead.
217+
If you created your virtual machine and IoT hub in a new resource group, you can delete that group, which deletes all the associated resources. Double check the contents of the resource group to make sure that there's nothing you want to keep. If you don't want to delete the whole group, you can delete individual resources (virtual machine, device, or GPU-module) instead.
218218

219219
> [!IMPORTANT]
220220
> Deleting a resource group is irreversible.

0 commit comments

Comments
 (0)