Skip to content

Latest commit

 

History

History
79 lines (49 loc) · 3.92 KB

manual-dev-machine-setup.md

File metadata and controls

79 lines (49 loc) · 3.92 KB
Raw

Here is what you need to do to get Azure IoT Edge Dev Tool (aka iotedgedev) running on your dev machine manually instead of using the IoT Edge Dev Container.

If you are using a separate Edge device, like a Raspberry Pi, you do not need to run all of these steps on your IoT Edge device, you can install and setup Edge runtime directly on the device. See the Edge Device Setup wiki page for more information on setting up your Edge device.

Note: See the "Test Coverage" wiki page to see what the IoT Edge Dev Tool has been tested with.

  1. Install Python 2.7+ or Python 3.6+ and pip (Python 3.6 is recommended)

    • Windows: Install from Python's website
    • Linux: sudo apt install python-pip or sudo apt install python3-pip
    • macOS: The OpenSSL used by the system built-in Python is old and vulnerable. Please use Python installed with Homebrew

  2. Install Azure CLI 2.0

  3. Install Azure CLI IoT extension

    • New Install: az extension add --name azure-iot
    • Update Install: az extension update --name azure-iot

  4. (Python < 3.5 only) Install Node.js and the iothub-explorer package

    • uamqp, which is needed by Azure CLI IoT extension for monitoring messages, is not supported in Python < 3.5. For Python < 3.5 users, please install Node.js and the iothub-explorer Node.js package: npm i -g iothub-explorer

  5. (Raspberry Pi only) Install extra system dependencies

    sudo apt-get install python2.7-dev libffi-dev libssl-dev -y

  6. (Linux only) Install Docker Compose

    pip install -U docker-compose

  7. Install iotedgedev

    You do not need to do this if you're going to be developing on iotedgedev

    You do not need to run this on the Edge device. See the Edge Device Setup page for more information on setting up your Edge device.

    You can also run under a Python Virtual Environment. See the Python Virtual Environment Setup instructions page for details on how to set that up.

    There is a known dependency conflict between iotedgedev and now-deprecated azure-iot-edge-runtime-ctl. Please make sure you have uninstalled azure-iot-edge-runtime-ctl before installing iotedgedev: pip uninstall azure-iot-edge-runtime-ctl, or use a clean virtual environment.

    pip install -U iotedgedev

  8. Install module dependencies

  9. Follow the Usage Wiki to learn the usage of IoT Edge Dev Tool