v0.1.207

tinysystems/http-module

Container Image

europe-west2-docker.pkg.dev/tinyplatform/tinysystems/http-module-v0:0.1.207

Components 3 available

http_auth_parse

Extracts Basic Auth credentials from HTTP headers. In port receives: context + headers array. Out port always emits: {context, found, user, password}. If Authorization header with 'Basic' scheme found, decodes base64 and sets found=true with user/password. Otherwise found=false.

http_request

Outbound HTTP request maker. Request port receives: context, method, timeout, URL, headers, contentType, body. Blocks until HTTP response received. On success (status < 400): emits context + response on Response port. On failure or status >= 400: returns error, or if enableErrorPort=true in settings, emits on Error port instead.

http_server

HTTP request handler. Start port receives configuration and starts the server (blocks until stopped). Each incoming HTTP request emits on Request port. Wire Request to processing logic, then wire result to Response port with statusCode, contentType, headers, body.

Release Notes

Tiny Systems HTTP Module

HTTP server and client components for building web-facing automations.

Components

Component	Description
HTTP Server	Embedded HTTP server with configurable routes and TLS support
HTTP Client	Make outbound HTTP requests with full header and body control
Basic Auth Parser	Parse and validate HTTP Basic Authentication headers
OpenAPI Request	Make HTTP calls driven by an OpenAPI/Swagger specification

Installation

helm repo add tinysystems https://tiny-systems.github.io/module/
helm install http-module tinysystems/tinysystems-operator \
  --set controllerManager.manager.image.repository=ghcr.io/tiny-systems/http-module

Run locally

go run cmd/main.go run --name=http-module --namespace=tinysystems --version=1.0.0

Part of Tiny Systems

This module is part of the Tiny Systems platform -- a visual flow-based automation engine running on Kubernetes.

License

This module's source code is MIT-licensed. It depends on the Tiny Systems Module SDK (BSL 1.1). See LICENSE for details.

Required Permissions

This module requires elevated Kubernetes RBAC permissions.

API Group	Resources	Verbs
`core`	pods	get
`core`	services	getlistupdate
`networking.k8s.io`	ingresses	getlistupdate

Install with Tiny Systems Cloud

Connect your Kubernetes cluster to Tiny Systems platform for managed installation, updates, and monitoring.

or install manually

Install with Helm

Prerequisites

Helm 3.x installed (https://helm.sh/docs/intro/install/)
kubectl configured with cluster access
Kubernetes cluster running (1.19+)

Permission Warnings

Requires get access to pods in API group: core
Requires get, list, update access to services in API group: core
Requires get, list, update access to ingresses in API group: networking.k8s.io

Configuration

Namespace *

Kubernetes namespace where the module will be installed

Release Name *

Helm release name (must be unique within the namespace)

Enable HTTP features (Ingress)

Enable if your module needs to receive HTTP traffic from outside the cluster

Helm Installation Command

# Add Tiny Systems Helm repository
helm repo add tinysystems https://tiny-systems.github.io/module/
helm repo update

# Install CRDs (required once per namespace)
helm upgrade --install tinysystems-crd tinysystems/tinysystems-crd \
  --namespace tinysystems \
  --create-namespace

# Install OpenTelemetry collector (required once per namespace)
helm upgrade --install tinysystems-otel-collector tinysystems/tinysystems-otel-collector \
  --namespace tinysystems

# Install the module
helm upgrade --install tinysystems-http-module-v0 tinysystems/tinysystems-operator \
  --namespace tinysystems \
  --create-namespace \
  --set controllerManager.manager.image.repository=europe-west2-docker.pkg.dev/tinyplatform/tinysystems/http-module-v0 \
  --set controllerManager.manager.image.tag=0.1.207 \
  --set fullnameOverride=tinysystems-http-module-v0 \
  --set managerIngress.ingress.enabled=true \
  --set 'rbac.extraRules[0].apiGroups={}' \
  --set 'rbac.extraRules[0].resources={pods}' \
  --set 'rbac.extraRules[0].verbs={get}' \
  --set 'rbac.extraRules[1].apiGroups={}' \
  --set 'rbac.extraRules[1].resources={services}' \
  --set 'rbac.extraRules[1].verbs={get,list,update}' \
  --set 'rbac.extraRules[2].apiGroups={networking.k8s.io}' \
  --set 'rbac.extraRules[2].resources={ingresses}' \
  --set 'rbac.extraRules[2].verbs={get,list,update}'

View Documentation