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│
└────────┘ └────────┘ └────────┘ └────────┘
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file backend_ai_appproxy_coordinator-26.8.2.tar.gz.
File metadata
- Download URL: backend_ai_appproxy_coordinator-26.8.2.tar.gz
- Upload date:
- Size: 88.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6cd6cb091ddbde900011aee68d1028c6ce318c50a7739a635d69d8e7524f07e5
|
|
| MD5 |
8baa9c6e9e34e1bb8a86841ad82d9163
|
|
| BLAKE2b-256 |
016fe56999b35ede805cadd621a66299abcb19ef31818084c49ba51391d20a7e
|
File details
Details for the file backend_ai_appproxy_coordinator-26.8.2-py3-none-any.whl.
File metadata
- Download URL: backend_ai_appproxy_coordinator-26.8.2-py3-none-any.whl
- Upload date:
- Size: 120.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7cd83667dffd1cc02585e602e33fd3234937286a700107d6a7ae51ee77007929
|
|
| MD5 |
8d02a2a0d250580eb906aec025186b66
|
|
| BLAKE2b-256 |
341f03ab64113d2ae9a860481da8e203126894f3e002c2690fcb7e77d07e8531
|
