Backend.AI App Proxy Coordinator
Purpose
The App Proxy Coordinator manages routing information for App Proxy Workers, coordinates worker instances, and handles service port mappings for compute session services (Jupyter, SSH, TensorBoard, etc.).
Key Responsibilities
1. Worker Management
- Register and track App Proxy Worker instances
- Monitor worker health and availability
- Distribute routing information to workers
- Handle worker failover
2. Route Management
- Manage service port mappings (session → service → port)
- Update routing tables dynamically
- Propagate route changes to workers
- Handle route conflicts and resolution
3. Service Discovery
- Maintain service registry
- Provide route lookup for workers
- Update routes when sessions change
- Clean up routes for terminated sessions
Entry Points
App Proxy Coordinator has 1 entry point to receive and process requests.
1. REST API
Framework: aiohttp (async HTTP server)
Port: 6030 (default)
Primary Purpose:
- Worker management (registration, monitoring)
- Routing information management (session-to-service port mapping)
Key Features:
- HTTP/HTTPS-based communication
- Centralized service routing information management
- Real-time route updates
- Persistent routing information storage in PostgreSQL
Processing Flow:
Worker Registration Flow
Worker → POST /workers/register → Coordinator
↓
Register worker in DB
↓
Return worker ID and routes
Route Creation Flow
Manager → POST /routes → Coordinator
↓
Store route in DB
↓
Notify all workers
↓
Workers update local routing table
Integrated Architecture:
┌──────────────┐
│ Manager │
│ │
└──────┬───────┘
│ Route Management (REST)
▼
┌─────────────────────────────────────┐
│ App Proxy Coordinator (Port 6030) │
│ - Worker registration │
│ - Route management │
│ - Service port mapping │
│ - Route propagation │
└─────────┬───────────────────────────┘
│
▼ Worker Registration & Route Updates
┌─────┴─────┬─────────┬─────────┐
▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│Worker 1│ │Worker 2│ │Worker 3│ │Worker N│
└────────┘ └────────┘ └────────┘ └────────┘
Metadata
Release files for backend.ai-appproxy-coordinator 26.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| backend_ai_appproxy_coordinator-26.9.0.tar.gz | 88.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| backend_ai_appproxy_coordinator-26.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 208.4 kB
Release files / backend_ai_appproxy_coordinator-26.9.0.tar.gz
| Download URL | backend_ai_appproxy_coordinator-26.9.0.tar.gz |
|---|---|
| Size | 88.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0741cb4d06faa7d7cae40e876d676c2be1909dab0daed2000152f2a98f2e2b0e
|
|
BLAKE2b-256 checksum How to use checksums |
b855753c19aaefe9648295313809f4e601cd99e82d1bd46bcfbcf502709d3404
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / backend_ai_appproxy_coordinator-26.9.0-py3-none-any.whl
| Download URL | backend_ai_appproxy_coordinator-26.9.0-py3-none-any.whl |
|---|---|
| Size | 119.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
81ce7469dc6f3be4a1c84dd07c852fb8a8616fd23dd9a8f70fb3d3ec6aa60ecf
|
|
BLAKE2b-256 checksum How to use checksums |
3c3c5682cecc4a36888204d5bee0ac85934ab5eaa3701d2d02709b0225bef66d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
