v0.4.37

tinysystems/kubernetes-module

Container Image

europe-west2-docker.pkg.dev/tinyplatform/tinysystems/kubernetes-module-v0:0.4.37

Components 17 available

configmap_patch

Set or remove a key in a Kubernetes ConfigMap. On set: creates the ConfigMap if it doesn't exist, or upserts the key. On remove: deletes the key from the ConfigMap data.

daemonset_list

Lists Kubernetes DaemonSets with scheduling status and health information.

deployment_list

Lists Kubernetes Deployments with replica status, conditions, and health information.

deployment_scale

Scale a Kubernetes Deployment to a specified replica count.

deployment_update

Update a Kubernetes Deployment's images, environment variables, resources, replicas, and metadata.

event_watch

Watch Kubernetes Events for warnings and errors. Use to detect ImagePullBackOff, CrashLoopBackOff, scheduling failures, and other cluster issues.

pod_delete

Delete a Kubernetes Pod by name. Useful for forcing pod restart or cleanup.

pod_list

Lists Kubernetes Pods with container statuses, phases, and problem detection.

pod_logs_get

Get logs from a specific pod by exact name. Use pod_list to find pods first if needed.

pod_status_get

Get status of pods matching a label selector. Returns pod count, health summary, and individual pod details.

pod_update

Update a Kubernetes Pod's labels and annotations. Note: Pod spec cannot be modified after creation.

pod_watch

Watch Kubernetes Pods for status changes. Emits typed events with pod phase, container states, and problem detection.

service_list

Lists Kubernetes Services with ports, selectors, and endpoint information.

service_update

Update a Kubernetes Service's selector, ports, labels, or annotations.

statefulset_list

Lists Kubernetes StatefulSets with replica status, revisions, and health information.

workload_list

Lists Kubernetes workload resources (Deployments, StatefulSets, DaemonSets) with optional filtering by namespace and label selector. Returns resource details including name, namespace, kind, labels, replicas, and status.

workload_restart

Performs a rollout restart on a Deployment, StatefulSet, or DaemonSet by name. Triggers a rolling update by setting the restart annotation.

Release Notes

Tiny Systems Kubernetes Module

Kubernetes resource management components for cluster automation workflows.

Components

Component	Description
Pod Watcher	Watch pod events in real time
Pod Status	Get current status of a pod
Pod Logs	Stream or fetch pod log output
Pod List	List pods with label/field selectors
Pod Delete	Delete a pod by name
Pod Update	Update pod spec or metadata
Deployment List	List deployments in a namespace
Deployment Scale	Scale a deployment's replica count
Deployment Update	Update deployment spec or metadata
Workload List	List workloads across resource types
Workload Restart	Trigger a rolling restart of a workload
StatefulSet List	List statefulsets in a namespace
DaemonSet List	List daemonsets in a namespace
Service List	List services in a namespace
Service Update	Update service spec or metadata
ConfigMap Patch	Patch individual keys in a ConfigMap
Event Watcher	Watch Kubernetes events in real time

Installation

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

Run locally

go run cmd/main.go run --name=kubernetes-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
`*`	*	getlistwatch
`apps`	deployments	updatepatch
`core`	configmaps	createupdatepatch
`core`	pods/log	get

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

This module requires access to Kubernetes resources (pods, services, deployments, ingresses). Review RBAC permissions before installing.
Requires get, list, watch access to * in API group: *
Requires update, patch access to deployments in API group: apps
Requires create, update, patch access to configmaps in API group: core
Requires get access to pods/log in API group: core

Configuration

Namespace *

Kubernetes namespace where the module will be installed

Release Name *

Helm release name (must be unique within the namespace)

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-kubernetes-module-v0 tinysystems/tinysystems-operator \
  --namespace tinysystems \
  --create-namespace \
  --set controllerManager.manager.image.repository=europe-west2-docker.pkg.dev/tinyplatform/tinysystems/kubernetes-module-v0 \
  --set controllerManager.manager.image.tag=0.4.37 \
  --set fullnameOverride=tinysystems-kubernetes-module-v0 \
  --set managerIngress.ingress.enabled=false \
  --set rbac.enableKubernetesResourceAccess=true \
  --set 'rbac.extraRules[0].apiGroups={*}' \
  --set 'rbac.extraRules[0].resources={*}' \
  --set 'rbac.extraRules[0].verbs={get,list,watch}' \
  --set 'rbac.extraRules[1].apiGroups={apps}' \
  --set 'rbac.extraRules[1].resources={deployments}' \
  --set 'rbac.extraRules[1].verbs={update,patch}' \
  --set 'rbac.extraRules[2].apiGroups={}' \
  --set 'rbac.extraRules[2].resources={configmaps}' \
  --set 'rbac.extraRules[2].verbs={create,update,patch}' \
  --set 'rbac.extraRules[3].apiGroups={}' \
  --set 'rbac.extraRules[3].resources={pods/log}' \
  --set 'rbac.extraRules[3].verbs={get}'

View Documentation