Service Unit

API Group: environments.blanketops.dev

Version: v1alpha1

Scope: Namespaced

---

Description

ServiceUnit defines the runtime workload contract for a delivery artifact.

It specifies artifact source, scaling boundaries, port exposure, application role, and stack classification.

• ServiceUnit abstracts workload identity from deployment strategy.
• ServiceUnit does not reconcile manifests directly.
• ServiceUnit defines workload shape.

---

Spec

spec

Field	Type	Required	Description
contract	object	Yes	Workload definition contract

---

spec.contract

Field	Type	Required	Description
type	string	Yes	Artifact origin type (static or build)
image	string	Cond.	Container image reference (required if type=static)
buildRef	object	Cond.	Reference to Build (required if type=build)
containerPort	integer	Yes	Primary container TCP port
size	integer	Yes	Desired replica count baseline
route	object	No	Reference to the Route exposing this ServiceUnit
appType	string	Yes	Application role classification (web, worker, etc.)
stackType	string	Yes	Technology stack classification (nodejs, python, etc.)

---

spec.contract.buildRef

Field	Type	Required	Description
name	string	Yes	Name of referenced Build CR
namespace	string	No	Namespace of the referenced Build CR, if not this one's

---

spec.contract.route

Field	Type	Required	Description
name	string	Yes	Name of referenced Route CR

---

Status

Field	Type	Description
phase	string	Current lifecycle phase
message	string	Human-readable status detail
observedGeneration	integer	Last reconciled generation
resolvedImage	string	Resolved image reference in runtime
buildStatus	object	Resolution status of the referenced Build, if type=build
runtime	string	Runtime substrate this ServiceUnit was projected onto
workloadRef	object	Reference to the materialized workload (apiVersion, kind, name, namespace)
conditions	[]Condition	Standard Kubernetes condition array

---

status.phase Values

Value	Meaning
Pending	ServiceUnit registered but not yet projected
Resolved	Artifact reference successfully resolved
Ready	Successfully projected into a Deployment
Failed	Resolution or projection failed

---

Examples

Static Artifact

apiVersion: environments.blanketops.dev/v1alpha1
kind: ServiceUnit
metadata:
  name: for-kaniko-app-api
  namespace: dev
spec:
  contract:
    type: static
    image: docker.io/example/for-kaniko-app:master
    containerPort: 8080
    size: 2
    appType: web
    stackType: nodejs

Build-Derived Artifact

apiVersion: environments.blanketops.dev/v1alpha1
kind: ServiceUnit
metadata:
  name: for-buildah-app-worker
  namespace: dev
spec:
  contract:
    type: build
    buildRef:
      name: for-buildah-app
    containerPort: 9000
    size: 1
    appType: worker
    stackType: python

Invariants

• If type=static, image must be specified and buildRef must not be set.
• If type=build, buildRef must reference an existing Build and image must not be set.
• containerPort must be a valid TCP port.
• size must be greater than zero.
• ServiceUnit does not create Deployment resources automatically.
• ServiceUnit must be referenced by a Deployment to be projected into runtime