This project is deprecated in favor of the Azure IoT Edge deployment for virtual machines. Those instructions can be found here: https://docs.microsoft.com/en-us/azure/iot-edge/how-to-install-iot-edge-ubuntuvm?view=iotedge-2020-11
To use that deployment with IoT Central - follow the instructions for including the Device Connection String and then after the deployment succeeds you can edit the Azure IoT Edge configuration file (/etc/iotedge/config.yaml for Edge 1.x, and /etc/aziot/config.toml for Edge 2.x) to use the "DPS provisioning with symmetric key attestation" section instead of the "Manual provisioning with an IoT Hub connection string" section.
ARM template to deploy a VM with IoT Edge pre-installed and configured for an IoT Central edge module (via cloud-init)
The ARM template visualized for exploration
This template can be used to quickly provide an IoT Edge device to host your module. When you don't have access to a network or a host device to use on your network you can use an Azure VM to simulate a host Edge device. This template will deploy an Azure VM with the latest IoT Edge runtime pre-installed and pre-configured for DPS Symmetric Key Provisioning for your IoT Central Edge deployment. Simply provide your IoT Central Application Scope Id
, Device Id
, and Device Key
. You can obtain these from your IoT Central Application to use in the template.
az deployment group create \
--subscription "<SUBSCRIPTION_NAME>" \
--name edgeModuleVM \
--resource-group "<RESOURCE_GROUP_NAME>" \
--template-file edgeDeploy.json \
--parameters dnsLabelPrefix="edgeModuleDeploy" \
--parameters adminUsername="<AZURE_USER>" \
--parameters scopeId="<IOT_CENTRAL_APP_SCOPE_ID>" \
--parameters deviceId="<IOT_CENTRAL_DEVICE_ID>" \
--parameters deviceKey="<IOT_CENTRAL_DEVICE_KEY" \
--parameters authenticationType="sshPublicKey" \
--parameters adminPasswordOrKey="$(< ~/.ssh/id_rsa.pub)"
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.