Python Azure Iot Edge Modules

Python Azure IoT Edge modules

Designs, implements, and validates Python-based Azure IoT Edge modules for telemetry processing, local inference, protocol translation, command orchestration, and edge-to-cloud integration.

When to invoke

• "quiero crear un modulo Python para IoT Edge"
• "como despliego modulos edge con manifest"
• "necesito filtrar/agregar telemetria antes de subirla"
• "como manejo desconexiones y reintentos en edge"
• "Validate this Python IoT Edge module for production readiness."

Prerequisites and context

Before recommending runtime behavior or deployment decisions, review current Azure IoT Edge documentation:

• https://learn.microsoft.com/azure/iot-edge/
• https://learn.microsoft.com/es-es/azure/iot-edge/

Before proposing Python implementation details, consult official Python sources:

• https://www.python.org/
• https://docs.python.org/3/
• https://docs.python.org/3/reference/
• https://docs.python.org/3/harness/github-copilot/
• references/python-official-best-practices.md

If documentation cannot be fetched, proceed with explicit assumptions and flag them clearly.

Procedure

1. Define the contract: module inputs, outputs, message schema, schema versioning, routes, priorities, and desired properties.
2. Specify runtime and packaging: Python version target, base image, container footprint, CVE hygiene, CPU and memory bounds, startup checks, and health checks.
3. Design reliability: retries with exponential backoff and jitter, graceful degradation, bounded local queueing, and idempotent replay handling.
4. Define security controls: no plaintext secrets, least-privilege behavior, secure transport, trusted certificate chain handling, and command traceability.
5. Describe deployment and operations: environment-specific manifests, pilot/staged/broad rollout, rollback criteria, SLOs, alerts, and observability.
6. Validate with a test matrix covering functional, chaos, performance, and rollback scenarios.

Module design areas

Reliability and security rules

Progressive disclosure and bundled resources

• references/python-edge-module-template.md: output structure for implementation proposals and reviews.
• references/python-official-best-practices.md: baseline Python quality criteria.

Related primitives

Edge module quality vocabulary

Keep designs production-focused, include error-handling, and check current release/version guidance before making runtime recommendations.

Output template

### Python Azure IoT Edge module result

**Status:** design ready | implementation plan | review findings | blocked
**Context and assumptions:** <runtime, device, connectivity, documentation assumptions>

## 1. Module design brief
- Purpose: <module purpose>
- Inputs: <module inputs>
- Outputs: <module outputs>
- Message schema/version: <schema and versioning policy>

## 2. Deployment model
- Image: <base image and tag policy>
- Manifest settings: <routes, env, desired properties>
- Resource limits: <CPU/memory>

## 3. Reliability and error handling
- Retries: <backoff and jitter>
- Offline behavior: <queue, bounds, drop policy>
- Idempotency: <replay handling>

## 4. Security and operations checklist
- <identity, secrets, cert chain, command audit, health, SLOs>

## 5. Test matrix
| Test | Method | Expected result |
| --- | --- | --- |
| Functional | <case> | <result> |
| Chaos | <disconnect/restart> | <result> |
| Performance | <load> | <result> |
| Rollback | <rollback condition> | <result> |

Quality gate

• Azure IoT Edge and Python official documentation were reviewed or assumptions were stated.
• Module inputs, outputs, message schema, routes, and desired properties are defined.
• Deployment model covers image, manifest, env settings, health probes, and restart behavior.
• Reliability strategy includes backoff with jitter, bounded buffering, and idempotency.
• No plaintext secrets are placed in Dockerfiles, source, or manifests.
• Rollout includes pilot, staged, broad, and rollback criteria.
• Test matrix covers functional, chaos, performance, and rollback tests.

References

• Azure IoT Edge
• Azure IoT Edge Spanish documentation
• Python
• Python 3 documentation
• Python language reference
• Python standard library