Skip to content

Commit 58e84f5

Browse files
committed
Updates to versions in article
1 parent 9e9214d commit 58e84f5

File tree

1 file changed

+4
-58
lines changed

1 file changed

+4
-58
lines changed

articles/iot-edge/how-to-vs-code-develop-module.md

Lines changed: 4 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -260,60 +260,6 @@ For example:
260260
261261
::: zone-end
262262
263-
### Set IoT Edge runtime version
264-
265-
The IoT Edge extension defaults to the latest stable version of the IoT Edge runtime when it creates your deployment assets.
266-
267-
::: zone pivot="iotedge-dev-ext"
268-
269-
1. Select **View** > **Command Palette**.
270-
1. In the command palette, enter and run the command **Azure IoT Edge: Set default IoT Edge runtime version**.
271-
1. Choose the runtime version that your IoT Edge devices are running from the list.
272-
273-
Currently, the extension doesn't include a selection for the latest runtime versions. If you want to set the runtime version higher than 1.2, open *deployment.debug.template.json* deployment manifest file. Change the runtime version for the system runtime module images *edgeAgent* and *edgeHub*. For example, if you want to use the IoT Edge runtime version 1.4, change the following lines in the deployment manifest file:
274-
275-
```json
276-
...
277-
"systemModules": {
278-
"edgeAgent": {
279-
...
280-
"image": "mcr.microsoft.com/azureiotedge-agent:1.4",
281-
...
282-
}
283-
"edgeHub": {
284-
...
285-
"image": "mcr.microsoft.com/azureiotedge-hub:1.4",
286-
...
287-
}
288-
}
289-
```
290-
291-
1. After you select a new runtime version, your deployment manifest is dynamically updated to reflect the change to the runtime module images.
292-
293-
::: zone-end
294-
295-
::: zone pivot="iotedge-dev-cli"
296-
297-
1. In Visual Studio Code, open *deployment.debug.template.json* deployment manifest file. The [deployment manifest](module-deployment-monitoring.md#deployment-manifest) is a JSON document that describes the modules to be configured on the targeted IoT Edge device.
298-
1. Change the runtime version for the system runtime module images *edgeAgent* and *edgeHub*. For example, if you want to use the IoT Edge runtime version 1.4, change the following lines in the deployment manifest file:
299-
300-
```json
301-
...
302-
"systemModules": {
303-
"edgeAgent": {
304-
...
305-
"image": "mcr.microsoft.com/azureiotedge-agent:1.4",
306-
...
307-
"edgeHub": {
308-
...
309-
"image": "mcr.microsoft.com/azureiotedge-hub:1.4",
310-
...
311-
```
312-
313-
You might have to change your `.env` file for the variable `RUNTIME_TAG`, instead of changing the manifest.
314-
315-
::: zone-end
316-
317263
## Add more modules
318264
319265
To add more modules to your solution, change to the *modules* directory and add them there.
@@ -573,7 +519,7 @@ In each module folder, there are several Docker files for different container ty
573519
When you debug modules using this method, your modules are running on top of the IoT Edge runtime. The IoT Edge device and your Visual Studio Code can be on the same machine, or more typically, Visual Studio Code is on the development machine and the IoT Edge runtime and modules are running on another physical machine. In order to debug from Visual Studio Code, you must:
574520

575521
- Set up your IoT Edge device, build your IoT Edge modules with the **.debug** Dockerfile, and then deploy to the IoT Edge device.
576-
- Update the `launch.json` so that Visual Studio Code can attach to the process in the container on the remote machine. You can find this file in the `.vscode` folder in your workspace and updates each time you add a new module that supports debugging.
522+
- Update `launch.json` so that Visual Studio Code can attach to the process in a container on the remote machine. You can find this file in the `.vscode` folder in your workspace, and it updates each time you add a new module that supports debugging.
577523
- Use Remote SSH debugging to attach to the container on the remote machine.
578524

579525
### Build and deploy your module to an IoT Edge device
@@ -632,12 +578,12 @@ In Visual Studio Code, open the *deployment.debug.template.json* deployment mani
632578
633579
1. In the Visual Studio Code command palette, run the command **Azure IoT Edge: Build and Push IoT Edge solution**.
634580
1. Select the `deployment.debug.template.json` file for your solution.
635-
1. In the **Azure IoT Hub Devices** section of the Visual Studio Code Explorer view, right-click the IoT Edge device name for deployment and then choose **Create Deployment for Single Device**.
581+
1. In the **Azure IoT Hub** > **Devices** section of the Visual Studio Code Explorer view, right-click the IoT Edge device name for deployment and then choose **Create Deployment for Single Device**.
636582
> [!TIP]
637583
> To confirm that the device you've chosen is an IoT Edge device, select it to expand the list of modules and verify the presence of **$edgeHub** and **$edgeAgent**. Every IoT Edge device includes these two modules.
638584
1. Navigate to your solution's **config** folder, select the `deployment.debug.amd64.json` file, and then select **Select Edge Deployment Manifest**.
639585
640-
You can check your container status by running the `docker ps` command in the terminal. If your Visual Studio Code and IoT Edge runtime are running on the same machine, you can also check the status in the Visual Studio Code Docker view.
586+
You can check your container status from your device or virtual machine by running the `docker ps` command in a terminal. You should see your container listed after running the command. If your Visual Studio Code and IoT Edge runtime are running on the same machine, you can also check the status in the Visual Studio Code Docker view.
641587
642588
> [!IMPORTANT]
643589
> If you're using a private registry like Azure Container Registry (ACR) for your images, you may need to authenticate to push images. Use `docker login <ACR login server>` or `az acr login --name <ACR name>` to authenticate.
@@ -811,7 +757,7 @@ The Docker and Moby engines support SSH connections to containers allowing you t
811757
1. In Visual Studio Code, set breakpoints in your custom module.
812758
1. When a breakpoint is hit, you can inspect variables, step through code, and debug your module.
813759
814-
:::image type="content" source="media/how-to-vs-code-develop-module/vs-code-breakpoint.png" alt-text="Screenshot of Visual Studio Code attached to a Docker container on a remote device paused at a breakpoint.":::
760+
:::image type="content" source="media/how-to-vs-code-develop-module/vs-code-breakpoint.png" alt-text="Screenshot of Visual Studio Code attached to a Docker container on a remote device paused at a breakpoint." lightbox="media/how-to-vs-code-develop-module/vs-code-breakpoint.png":::
815761
> [!NOTE]
816762
> The preceding example shows how to debug IoT Edge modules on remote containers. The example adds a remote Docker context and changes to the Docker privileges on the remote device. After you finish debugging your modules, set your Docker context to *default* and remove privileges from your user account.
817763

0 commit comments

Comments
 (0)