Add Azure IoT Edge install script and README

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 13:40:42 +02:00
commit 52be7f8750
3 changed files with 167 additions and 0 deletions
@@ -0,0 +1,86 @@
+# VM Install Script – Azure IoT Edge
+
+`install.sh` installeert op een Debian- of Ubuntu-VM:
+
+1. de Microsoft package repository
+2. `moby-engine` (Docker), met `log-driver: local`
+3. `aziot-edge`, gekoppeld aan de IoT Hub met jouw Device ID en Shared Access Key
+
+## Benodigd
+
+- Een VM met Debian (bijv. 12) of Ubuntu (bijv. 22.04 / 24.04)
+- Een gebruiker met `sudo`-rechten en internettoegang
+- De **Device ID** en **Shared Access Key** van het IoT Edge-device
+  (Azure Portal → IoT Hub → Devices → jouw device)
+
+## Stap 1 – Script naar de VM kopiëren
+
+Vanaf je Windows-pc (PowerShell):
+
+```powershell
+scp .\install.sh gebruiker@<VM-IP>:~/
+```
+
+Of maak het bestand direct op de VM aan met `nano install.sh` en plak de inhoud.
+
+## Stap 2 – Uitvoerbaar maken
+
+Log in op de VM (`ssh gebruiker@<VM-IP>`) en voer uit:
+
+```bash
+chmod +x install.sh
+```
+
+> **Let op (Windows line endings):** als je de foutmelding
+> `/usr/bin/env: 'bash\r': No such file or directory` krijgt, is het bestand
+> opgeslagen met Windows-regeleinden. Los dit op met:
+>
+> ```bash
+> sed -i 's/\r$//' install.sh
+> ```
+
+## Stap 3 – Script draaien
+
+```bash
+sudo ./install.sh <DEVICE_ID> <SHARED_ACCESS_KEY>
+```
+
+Voorbeeld:
+
+```bash
+sudo ./install.sh mijn-edge-device-01 'abc123...='
+```
+
+Zet de key tussen **enkele aanhalingstekens**, omdat keys vaak tekens als `=`, `+` of `/` bevatten.
+
+### Andere IoT Hub gebruiken
+
+Standaard wordt `iot-shared-v6odheqozqccs-prod.azure-devices.net` gebruikt. Een andere hub geef je zo op:
+
+```bash
+sudo IOT_HUB_HOSTNAME=mijn-hub.azure-devices.net ./install.sh <DEVICE_ID> <SHARED_ACCESS_KEY>
+```
+
+## Stap 4 – Controleren
+
+```bash
+sudo iotedge system status   # services moeten 'Running' zijn
+sudo iotedge check           # uitgebreide controle van configuratie en verbinding
+sudo iotedge list            # draaiende modules (edgeAgent, edgeHub, ...)
+```
+
+Het kan een paar minuten duren voordat `edgeAgent` en `edgeHub` verschijnen.
+
+## Opnieuw draaien
+
+Het script kan veilig opnieuw gedraaid worden, bijvoorbeeld met een andere Device ID.
+De bestaande `/etc/aziot/config.toml` wordt dan overschreven.
+
+## Problemen oplossen
+
+| Probleem | Oplossing |
+|---|---|
+| `Dit script moet als root draaien` | Start het script met `sudo`. |
+| `Kon packages-microsoft-prod.deb niet downloaden` | Je OS-versie wordt (nog) niet door Microsoft ondersteund, of er is geen internet. |
+| `iotedge check` geeft verbindingsfouten | Controleer Device ID, key, hostname en of uitgaande poorten 443/5671/8883 open zijn. |
+| Logs bekijken | `sudo iotedge system logs` |