bc695307b7
* Support modulesContent * Extract get_desired_property method * Add test cases for get_desired_property method |
||
---|---|---|
.vscode | ||
assets | ||
docker | ||
iotedgedev | ||
scripts | ||
tests | ||
.env.tmp | ||
.gitignore | ||
.travis.yml | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
HISTORY.rst | ||
LICENSE | ||
MANIFEST.in | ||
Makefile | ||
README.md | ||
package-lock.json | ||
package.json | ||
pytest.ini | ||
requirements.txt | ||
requirements_dev.txt | ||
requirements_nodeps.txt | ||
requirements_travis.txt | ||
setup.cfg | ||
setup.py | ||
tox.ini | ||
travis_pypi_setup.py |
README.md
Azure IoT Edge Dev Tool
IOTEDGEDEV DOES NOT WORK WITH IOT EDGE GA BITS.
ETA: Mid-August
PLEASE WATCH THIS REPO FOR NOTIFICATIONS
The Azure IoT Edge Dev Tool greatly simplifies Azure IoT Edge development down to simple commands driven by Environment Variables.
- It gets you started with IoT Edge development with the IoT Edge Dev Container and IoT Edge Solution Scaffolding that contains a sample module and all the required configuration files.
- It speeds up your inner-loop dev (dev, debug, test) by reducing multi-step build & deploy processes into one-line CLI commands and well as drive your outer-loop CI/CD pipeline. You can use all the same commands in both stages of your development life-cycle.
Overview
For the absolute fastest way to get started with IoT Edge Dev, please see the Quickstart section below.
For a more detailed overview of IoT Edge Dev Tool including setup and commands, please see the Wiki.
Quickstart
This quickstart will run a container, create a solution, setup Azure resources, build and deploy modules to your device, setup and start the Edge Runtime and then monitor messages flowing into IoT Hub.
Here's a 3 minute video walk-through of this Quickstart:
The only thing you need to install is Docker. All of the other dev dependencies are included in the container.
-
Install Docker
- Open Docker Settings and setup a Shared Drive that you'll use to store your IoT Edge Solution files.
-
Run the Azure IoT Edge Dev Container
Before you run the container, you will need to create a local folder to store your IoT Edge solution files.
Windows
mkdir c:\temp\iotedge docker run -ti -v /var/run/docker.sock:/var/run/docker.sock -v c:/temp/iotedge:/home/iotedge microsoft/iotedgedev
Linux
sudo mkdir /home/iotedge docker run -ti -v /var/run/docker.sock:/var/run/docker.sock -v /home/iotedge:/home/iotedge microsoft/iotedgedev
-
Initialize Edge Solution and Setup Azure Resources
iotedgedev init
'iotedgedev init' will run both 'iotedgedev solution .' and 'iotedgedev azure', which will create a solution and setup your Azure resource in a single comamnd.
-
Build & Push IoT Edge Modules
iotedgedev push
You can also combine build, push and deploy with
iotedgedev push --deploy
-
Deploy Modules to IoT Edge Device
iotedgedev deploy
-
Start the IoT Edge Runtime
iotedgedev start
-
Monitor Messages sent from IoT Edge to IoT Hub
iotedgedev monitor
Resources
Please refer to the Wiki for details on setup, usage, and troubleshooting.
Please refer to the Contributing file for details on contributing changes.