Function Runner Design

Mon, 01 Jan 0001 00:00:00 +0000

Architectural Context

The Function Runner is one of several function execution mechanisms in Porch. The Task Handler uses a Function Runtime interface that can be implemented by:

Task Handler (in Porch)
 ↓
 Function Runtime
 ↓
 ┌─────┴─────┬──────────┐
 ↓ ↓ ↓
Builtin gRPC Multi
Runtime Runtime Runtime
 ↓ ↓ ↓
In-Process Function Chains
Go Code Runner Runtimes
 (External)
 ↓
 ┌─────────┴─────────┬──────────┐
 ↓ ↓ ↓
 Pod Executable Multi
 Evaluator Evaluator Evaluator
 ↓ ↓ ↓
 Function Cached Fallback
 Pods Binaries Chain

Function Runtime implementations:

Function Runner Interactions

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Function Runner is a separate gRPC service that interacts with multiple systems: the Task Handler (via gRPC), Kubernetes API (for pod management), container registries (for image metadata), and wrapper servers (for function execution). It operates independently from the Porch server, enabling isolated function execution.

High-Level Architecture

┌─────────────────────────────────────────────────────────┐
│ Function Runner Service │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │
│ │ Task Handler │ ───> │ gRPC │ ───> │ Eval │ │
│ │ (in Porch) │ │ Server │ │uators│ │
│ └──────────────┘ └──────────────┘ └──────┘ │
│ ↑ │ │ │
│ │ ↓ ↓ │
│ │ ┌──────────────┐ ┌──────┐ │
│ └──────────────│ Kubernetes │ │Image │ │
│ │ API │ │Cache │ │
│ └──────────────┘ └──────┘ │
│ │ │ │
│ ↓ ↓ │
│ ┌──────────────┐ ┌─────────┐ │
│ │ Function Pods│ │Registry │ │
│ │ + Services │ │ APIs │ │
│ └──────────────┘ └─────────┘ │
└─────────────────────────────────────────────────────────┘

Task Handler Integration