Azure IoT Edge with Azure Container Registry
You will likely want to run the Azure IoT Edge Runtime from your own Azure Container Registry (ACR). While this will be officially supported eventually, right now it is not, but there is a workaround. It isn’t officially supported out of the box because the runtime deploys the “edgeHub” container under-the-covers from Docker Hub and there’s no obvious way to override that. I’ve been working with the Azure IoT team over the last couple of days to unblock a customer who has network restrictions that prevent them from running the Edge from anything other than the West Europe Azure Region. Here’s everything that we had to do to get it running. Hopefully this helps you out while the Azure team gets this officially implemented.
Azure IoT Edge Configuration
The first thing you are going to want to do is go to the azure-iot-edge-config repository and learn about the two types of Edge configuration: Runtime and Module configuration. Come back to this post after you have absorbed that info.
Setup Azure Resources
1. Create IoT Hub & Edge Device 2. Create Azure Container Registry
Azure Container Registry Setup
You are first going to pull the Azure IoT Edge containers down to your local machine, tag them and then push them to your own ACR.
Pull Containers
Open a command prompt and execute the following statements to pull the Azure IoT Edge runtime modules down to your machine.
docker pull microsoft/azureiotedge-agent:1.0-previewdocker pull microsoft/azureiotedge-hub:1.0-previewdocker pull microsoft/azureiotedge-simulated-temperature-sensor:1.0-preview
```markdown
### Tag Containers
Tag each of the images with ACR URI:
> Replace 'myregistry\` with the name of your registry
```bash
docker tag microsoft/azureiotedge-agent:1.0-preview myregistry.azurecr.io/azureiotedge-agent:1.0-previewdocker tag microsoft/azureiotedge-hub:1.0-preview myregistry.azurecr.io/azureiotedge-hub:1.0-previewdocker tag microsoft/azureiotedge-simulated-temperature-sensor:1.0-preview myregistry.azurecr.io/azureiotedge-simulated-temperature-sensor:1.0-preview
```markdown
### Push Containers
You will now push your newly tagged images to your ACR. But first you need to login to your ACR.
```bash
docker login myregistry.azurecr.io -u xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -p password
```python
> You can get the ACR credentials from the Azure Portal, under Access Keys
Now push those images to your ACR.
```bash
docker push myregistry.azurecr.io/azureiotedge-agent:1.0-previewdocker push myregistry.azurecr.io/azureiotedge-hub:1.0-previewdocker push myregistry.azurecr.io/azureiotedge-simulated-temperature-sensor:1.0-preview
```csharp
You will now see your images under the ‘Repositories’ section of your ACR.
### Modify Config
You now need to change two config files: **Runtime** and **Module** Configuration.
#### Runtime Configuration
When you run `iotedgectl setup` you can pass it a custom config file, which will contain your ACR credentials. See [azure-iot-edge-config](https://github.com/jongio/azure-iot-edge-config) for more information about IoT Edge configuration requirements.
Here’s how to get your config file setup:
1\. Copy [this file (runtimeconfig.json)](https://github.com/jongio/azure-iot-edge-config/blob/master/config/runtimeconfig.json) to your local machine.2\. Open file and replace all the tokens \[\[enter …\]\] with your values for your ACR URI, password, username, connection string and hostname.3\. Save the file.
Now when you setup the Edge Runtime you pass it a `--config-file` parameter to your new config file.
```bash
iotedgectl setup --config-file config.json
```python
Then run start, and you’ll see it pull from your ACR instead of Docker Hub
```bash
iotedgectl start
```text
View the docker logs and you should see this message, which is normal. It says it is waiting for a module config, which we will do next.
```bash
docker logs edgeAgent -f
```text```bash
2017-11-23 04:26:57 [ERR] - Error refreshing edge agent configuration from twin.Microsoft.Azure.Devices.Edge.Agent.Core.ConfigSources.ConfigEmptyException: This device has an empty configuration for the edge agent. Please set a deployment manifest. at Microsoft.Azure.Devices.Edge.Agent.IoTHub.EdgeAgentConnection.UpdateDeploymentConfig() in /opt/vsts/work/1/s/edge-agent/src/Microsoft.Azure.Devices.Edge.Agent.IoTHub/EdgeAgentConnection.cs:line 138 at Microsoft.Azure.Devices.Edge.Agent.IoTHub.EdgeAgentConnection.<RefreshTwinAsync>d__14.MoveNext() in /opt/vsts/work/1/s/edge-agent/src/Microsoft.Azure.Devices.Edge.Agent.IoTHub/EdgeAgentConnection.cs:line 912017-11-23 04:26:58 [INF] - Updated reported properties
```markdown
#### Module Configuration
Now we need to apply a custom configuration to the module twin config in the cloud. See [azure-iot-edge-config](https://github.com/jongio/azure-iot-edge-config) for more information about IoT Edge configuration requirements.
0\. Install [Python 2.7+](https://www.python.org/downloads/)1\. Copy [this file (moduleconfig.json)](https://github.com/jongio/azure-iot-edge-config/blob/master/config/moduleconfig.json) to your local machine.2\. Change all of the \[\[enter ACR URI\]\] tags with your ACR URI.3\. Save the file4\. Clone this repo [azure-iot-rest](https://github.com/jongio/azure-iot-rest)
```bash
git clone https://github.com/jongio/azure-iot-rest.git
```csharp
5\. Open command and navigate to `data-plane\devices` and execute the following to apply your new configuration file:
```bash
python device-conf.py --name [iothubname] --key [iothubkey] --device-id [deviceid] --config-file [path to module config]
```text
You will see this output:
If you go back to your docker logs:
```bash
docker logs edgeAgent -fYou will now see the runtime pull that new module configuration file and run all the appropriate containers from your ACR.
And you can verify that the events are being received by using Device Explorer or the CLI monitor-events method described on this post.
That should do it!
Trust me, this experience will get better, but for now this is what we have to deal with.
Please comment or reach out if you have any issues.
Thanks, Jon