Skip to content

Commit 2ee0d01

Browse files
committed
Added missing items deleted with main merge
1 parent d081f9d commit 2ee0d01

File tree

9 files changed

+32
-45
lines changed

9 files changed

+32
-45
lines changed
-31.3 KB
Loading
-4.84 KB
Loading
-10.4 KB
Loading
-9.49 KB
Loading
-17.6 KB
Loading
Binary file not shown.
5.11 KB
Loading

articles/iot-edge/quickstart-linux.md

Lines changed: 16 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ In this quickstart you learn how to:
2323
* Install and start the IoT Edge runtime on a virtual device.
2424
* Remotely deploy a module to an IoT Edge device.
2525

26-
![Diagram - Quickstart architecture for device and cloud](./media/quickstart-linux/install-edge-full.png)
26+
:::image type="content" source="./media/quickstart-linux/install-edge-full.png" alt-text="Diagram of Quickstart architecture for device and cloud.":::
2727

2828
This quickstart walks you through creating a Linux virtual machine that's configured to be an IoT Edge device. Then, you deploy a module from the Azure portal to your device. The module used in this quickstart is a simulated sensor that generates temperature, humidity, and pressure data. The other Azure IoT Edge tutorials build upon the work you do here by deploying additional modules that analyze the simulated data for business insights.
2929

@@ -47,7 +47,7 @@ Cloud resources:
4747

4848
Start the quickstart by creating an IoT hub with Azure CLI.
4949

50-
![Diagram - Create an IoT hub in the cloud](./media/quickstart-linux/create-iot-hub.png)
50+
:::image type="content" source="./media/quickstart-linux/create-iot-hub.png" alt-text="Diagram of how to create an IoT hub in the cloud.":::
5151

5252
The free level of IoT Hub works for this quickstart. If you've used IoT Hub in the past and already have a hub created, you can use that IoT hub.
5353

@@ -63,7 +63,7 @@ The following code creates a free **F1** hub in the resource group **IoTEdgeReso
6363

6464
Register an IoT Edge device with your newly created IoT hub.
6565

66-
![Diagram - Register a device with an IoT Hub identity](./media/quickstart-linux/register-device.png)
66+
:::image type="content" source="./media/quickstart-linux/register-device.png" alt-text="Diagram of how to register a device with an IoT Hub identity.":::
6767

6868
Create a device identity for your IoT Edge device so that it can communicate with your IoT hub. The device identity lives in the cloud, and you use a unique device connection string to associate a physical device to a device identity.
6969

@@ -83,13 +83,13 @@ Since IoT Edge devices behave and can be managed differently than typical IoT de
8383
az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
8484
```
8585

86-
![View connection string from CLI output](./media/quickstart/retrieve-connection-string.png)
86+
:::image type="content" source="./media/quickstart/retrieve-connection-string.png" alt-text="Screenshot of the connection string from CLI output." lightbox="./media/quickstart/retrieve-connection-string.png":::
8787

8888
## Configure your IoT Edge device
8989

9090
Create a virtual machine with the Azure IoT Edge runtime on it.
9191

92-
![Diagram - Start the runtime on device](./media/quickstart-linux/start-runtime.png)
92+
:::image type="content" source="./media/quickstart-linux/start-runtime.png" alt-text="Diagram of how to start the runtime on a device.":::
9393

9494
The IoT Edge runtime is deployed on all IoT Edge devices. It has three components. The *IoT Edge security daemon* starts each time an IoT Edge device boots and bootstraps the device by starting the IoT Edge agent. The *IoT Edge agent* facilitates deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub. The *IoT Edge hub* manages communications between modules on the IoT Edge device, and between the device and IoT Hub.
9595

@@ -141,7 +141,7 @@ This template takes the following parameters:
141141

142142
Once the deployment is complete, you should receive JSON-formatted output in the CLI that contains the SSH information to connect to the virtual machine. Copy the value of the **public SSH** entry of the **outputs** section:
143143

144-
![Retrieve public ssh value from output](./media/quickstart-linux/outputs-public-ssh.png)
144+
:::image type="content" source="./media/quickstart-linux/outputs-public-ssh.png" alt-text="How to retrieve public ssh value from output." lightbox="./media/quickstart-linux/outputs-public-ssh.png":::
145145

146146
### View the IoT Edge runtime status
147147

@@ -180,11 +180,7 @@ Your IoT Edge device is now configured. It's ready to run cloud-deployed modules
180180

181181
Manage your Azure IoT Edge device from the cloud to deploy a module that will send telemetry data to IoT Hub.
182182

183-
![Diagram - deploy module from cloud to device](./media/quickstart-linux/deploy-module.png)
184-
185-
<!-- [!INCLUDE [iot-edge-deploy-module](../../includes/iot-edge-deploy-module.md)]
186-
187-
Include content included below to support versioned steps in Linux quickstart. Can update include file once Windows quickstart supports v1.2 -->
183+
:::image type="content" source="./media/quickstart-linux/deploy-module.png" alt-text="Diagram of how to deploy a module from cloud to device.":::
188184

189185
One of the key capabilities of Azure IoT Edge is deploying code to your IoT Edge devices from the cloud. *IoT Edge modules* are executable packages implemented as containers. In this section, you'll deploy a pre-built module from the [IoT Edge Modules section of Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/apps/category/internet-of-things?page=1&subcategories=iot-edge-modules) directly from Azure IoT Hub.
190186

@@ -202,42 +198,42 @@ Follow these steps to start the **Set Modules** wizard to deploy your first modu
202198

203199
1. On the upper bar, select **Set Modules**.
204200

205-
![Screenshot that shows selecting Set Modules.](./media/quickstart/select-set-modules.png)
201+
:::image type="content" source="./media/quickstart-linux/select-set-modules.png" alt-text="Screenshot that shows location of the Set Modules tab.":::
206202

207203
### Modules
208204

209205
The first step of the wizard is to choose which modules you want to run on your device.
210206

211207
Under **IoT Edge Modules**, open the **Add** drop-down menu, and then select **Marketplace Module**.
212208

213-
![Screenshot that shows the Add drop-down menu.](./media/quickstart/add-marketplace-module.png)
209+
:::image type="content" source="./media/quickstart-linux/add-marketplace-module.png" alt-text="Screenshot that shows the Add drop-down menu.":::
214210

215211
In **IoT Edge Module Marketplace**, search for and select the `Simulated Temperature Sensor` module. The module is added to the IoT Edge Modules section with the desired **running** status.
216212

217213
Select **Next: Routes** to continue to the next step of the wizard.
218214

219-
![Screenshot that shows continuing to the next step after the module is added.](./media/quickstart/view-temperature-sensor-next-routes.png)
215+
:::image type="content" source="./media/quickstart-linux/view-temperature-sensor-next-routes.png" alt-text="Screenshot that shows continuing to the next step after the module is added.":::
220216

221217
### Routes
222218

223219
A route named *SimulatedTemperatureSensorToIoTHub* was created automatically when you added the module from Azure Marketplace. This route sends all messages from the simulated temperature module to IoT Hub.
224220

225-
![Screenshot that shows removing the default route then moving to the next step.](./media/quickstart/delete-route-next-review-create.png)
221+
:::image type="content" source="./media/quickstart-linux/route-next-review-create.png" alt-text="Screenshot that shows the new temperature sensor route and shows the location of the Next: Review + create button.":::
226222

227223
Select **Next: Review + create**.
228224

229225
### Review and create
230226

231-
Review the JSON file, and then select **Create**. The JSON file defines all of the modules that you deploy to your IoT Edge device. You'll see the **SimulatedTemperatureSensor** module and the two runtime modules, **edgeAgent** and **edgeHub**.
227+
Review the JSON file, and then select **Create**. The JSON file defines all of the modules that you deploy to your IoT Edge device.
232228

233229
>[!Note]
234230
>When you submit a new deployment to an IoT Edge device, nothing is pushed to your device. Instead, the device queries IoT Hub regularly for any new instructions. If the device finds an updated deployment manifest, it uses the information about the new deployment to pull the module images from the cloud then starts running the modules locally. This process can take a few minutes.
235231
236232
After you create the module deployment details, the wizard returns you to the device details page. View the deployment status on the **Modules** tab.
237233

238-
You should see three modules: **$edgeAgent**, **$edgeHub**, and **SimulatedTemperatureSensor**. If one or more of the modules has **YES** under **SPECIFIED IN DEPLOYMENT** but not under **REPORTED BY DEVICE**, your IoT Edge device is still starting them. Wait a few minutes, and then refresh the page.
234+
You should see three modules: **$edgeAgent**, **$edgeHub**, and **SimulatedTemperatureSensor**. If one or more of the modules has **Yes** under **Specified in Deployment** but not under **Reported by Device**, your IoT Edge device is still starting them. Wait a few minutes, and then refresh the page.
239235

240-
![Screenshot that shows Simulated Temperature Sensor in the list of deployed modules.](./media/quickstart/view-deployed-modules.png)
236+
:::image type="content" source="./media/quickstart-linux/view-deployed-modules.png" alt-text="Screenshot that shows the SimulatedTemperatureSensor in the list of deployed modules." lightbox="./media/quickstart-linux/view-deployed-modules.png":::
241237

242238
## View generated data
243239

@@ -251,7 +247,7 @@ Open the command prompt on your IoT Edge device again, or use the SSH connection
251247
sudo iotedge list
252248
```
253249

254-
![View three modules on your device](./media/quickstart-linux/iotedge-list-2-version-1.4.png)
250+
:::image type="content" source="./media/quickstart-linux/iotedge-list-2-version-1.4.png" alt-text="Screenshot that shows three modules on your device." lightbox="./media/quickstart-linux/iotedge-list-2-version-1.4.png":::
255251

256252
View the messages being sent from the temperature sensor module:
257253

@@ -262,7 +258,7 @@ View the messages being sent from the temperature sensor module:
262258
>[!TIP]
263259
>IoT Edge commands are case-sensitive when referring to module names.
264260
265-
![View the data from your module](./media/quickstart-linux/iotedge-logs.png)
261+
:::image type="content" source="./media/quickstart-linux/iotedge-logs.png" alt-text="Screenshot that shows data from your module in the output console." lightbox="./media/quickstart-linux/iotedge-logs.png":::
266262

267263
You can also watch the messages arrive at your IoT hub by using the [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit).
268264

0 commit comments

Comments
 (0)