The Azure IoT Edge Dev Tool greatly simplifies your Azure IoT Edge development process. It has everything you need to get started and helps with your day-to-day Edge development.
Перейти к файлу
Ray Fang bc695307b7 Support new schema of deployment.json with backward compatibility (#222)
* Support modulesContent

* Extract get_desired_property method

* Add test cases for get_desired_property method
2018-08-03 09:03:21 -07:00
.vscode VS Code debugging of iotedgedev (python 3.6 only for now) (#166) 2018-05-07 16:04:32 -07:00
assets Add quickstart video (#161) 2018-04-18 16:17:00 -07:00
docker Lots of Upgrades (#152) 2018-04-17 16:22:12 -07:00
iotedgedev Support new schema of deployment.json with backward compatibility (#222) 2018-08-03 09:03:21 -07:00
scripts Decouple push from build command (#124) 2018-03-22 07:56:34 -07:00
tests Support new schema of deployment.json with backward compatibility (#222) 2018-08-03 09:03:21 -07:00
.env.tmp Add --template param to solution creation (#194) 2018-07-19 10:51:47 -07:00
.gitignore added vscode to .gitignore (#169) 2018-06-26 13:35:50 -07:00
.travis.yml Configure travis for unit tests (#195) 2018-06-29 11:12:00 -07:00
CODE_OF_CONDUCT.md update license file, update code of conduct (#172) 2018-05-15 09:10:17 -07:00
CONTRIBUTING.md add Contributing.md content and fix link (#182) 2018-06-07 10:52:00 -07:00
HISTORY.rst Init Commit 2017-12-29 16:39:34 -08:00
LICENSE update license file, update code of conduct (#172) 2018-05-15 09:10:17 -07:00
MANIFEST.in Simplified API, azure setup from EnvVars (#49) 2018-03-09 12:54:00 -08:00
Makefile Init Commit 2017-12-29 16:39:34 -08:00
README.md Update README.md 2018-07-26 14:08:44 -07:00
package-lock.json Lots of Upgrades (#152) 2018-04-17 16:22:12 -07:00
package.json Lots of Upgrades (#152) 2018-04-17 16:22:12 -07:00
pytest.ini Configure travis for unit tests (#195) 2018-06-29 11:12:00 -07:00
requirements.txt Add --template param to solution creation (#194) 2018-07-19 10:51:47 -07:00
requirements_dev.txt Update Readme file with missing dependencies 2018-01-22 11:40:43 -08:00
requirements_nodeps.txt Lightweight Az CLI via pip install method. (#29) 2018-02-28 14:28:43 +01:00
requirements_travis.txt Configure travis for unit tests (#195) 2018-06-29 11:12:00 -07:00
setup.cfg Support new schema of deployment.json with backward compatibility (#222) 2018-08-03 09:03:21 -07:00
setup.py Add --template param to solution creation (#194) 2018-07-19 10:51:47 -07:00
tox.ini Simplified API, azure setup from EnvVars (#49) 2018-03-09 12:54:00 -08:00
travis_pypi_setup.py Update to Tool and simplify pypi package name (#149) 2018-04-08 21:45:01 +09:00

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

Build Status

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:

Azure IoT Edge Dev Tool: Quickstart

The only thing you need to install is Docker. All of the other dev dependencies are included in the container.

  1. Install Docker

    • Open Docker Settings and setup a Shared Drive that you'll use to store your IoT Edge Solution files.
  2. 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
    
  3. 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.

  4. Build & Push IoT Edge Modules

    iotedgedev push

    You can also combine build, push and deploy with iotedgedev push --deploy

  5. Deploy Modules to IoT Edge Device

    iotedgedev deploy

  6. Start the IoT Edge Runtime

    iotedgedev start

  7. 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.