@toa.io/operations 1.0.0-alpha.253 → 1.0.0-alpha.256

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [1.0.0-alpha.256](https://github.com/toa-io/toa/compare/v1.0.0-alpha.255...v1.0.0-alpha.256) (2026-08-23)
+
+
+### Features
+
+* deploy a single mono image with toa deploy --mono ([a7f14f9](https://github.com/toa-io/toa/commit/a7f14f9877a280e9c74d16c195028b35d74fb15a))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/operations",
-  "version": "1.0.0-alpha.253",
+  "version": "1.0.0-alpha.256",
   "description": "Toa Deployment",
   "homepage": "https://toa.io",
   "author": {
@@ -16,7 +16,7 @@
     "url": "https://github.com/toa-io/toa/issues"
   },
   "engines": {
-    "node": ">= 20.0.0"
+    "node": ">= 24.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -27,12 +27,12 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/filesystem": "1.0.0-alpha.225",
-    "@toa.io/generic": "1.0.0-alpha.225",
-    "@toa.io/norm": "1.0.0-alpha.253",
-    "@toa.io/yaml": "1.0.0-alpha.246",
+    "@toa.io/filesystem": "1.0.0-alpha.254",
+    "@toa.io/generic": "1.0.0-alpha.254",
+    "@toa.io/norm": "1.0.0-alpha.256",
+    "@toa.io/yaml": "1.0.0-alpha.254",
     "execa": "5.1.1",
     "fs-extra": "11.1.1"
   },
-  "gitHead": "ca97991a1c8a6e770a51e0899b0c5dbeacbb89ed"
+  "gitHead": "a8990df97f971060686bd70a965f78e98070a983"
 }

package/src/deployment/.deployment/describe.js

@@ -1,8 +1,10 @@
 'use strict'
 
 const desc = require('./.describe')
+const { addVariables } = require('./.describe/variables')
+const { addMounts } = require('./.describe/mounts')
 
-const describe = (context, compositions, dependency) => {
+const describe = (context, compositions, dependency, image) => {
   const { services } = dependency
 
   dependency.variables.global ??= []
@@ -17,9 +19,24 @@ const describe = (context, compositions, dependency) => {
     }
   )
 
-  const components = desc.components(compositions)
   const credentials = context.registry?.credentials
 
+  if (image !== undefined) {
+    const mono = unit(context, dependency)
+
+    mono.image = image.reference
+
+    return {
+      compositions: [],
+      components: mono.components,
+      services: [],
+      credentials,
+      mono
+    }
+  }
+
+  const components = desc.components(compositions)
+
   desc.compositions(compositions, dependency)
   desc.services(services, dependency.variables, dependency.probe)
 
@@ -31,4 +48,39 @@ const describe = (context, compositions, dependency) => {
   }
 }
 
+function unit (context, dependency) {
+  const components = (context.components ?? []).map((component) => component.locator.label)
+
+  const mono = {
+    replicas: context.mono?.replicas,
+    resources: context.mono?.resources,
+    components,
+    variables: []
+  }
+
+  addVariables(mono, dependency.variables ?? {})
+  addMounts(mono, dependency.mounts)
+
+  for (const service of dependency.services ?? []) {
+    if (service.variables !== undefined)
+      for (const variable of service.variables)
+        if (!mono.variables.some((item) => item.name === variable.name))
+          mono.variables.push(variable)
+
+    if (service.port !== undefined)
+      mono.port = service.port
+
+    if (service.ingress !== undefined)
+      mono.ingress = service.ingress
+
+    if (service.probe !== undefined && service.probe !== false)
+      mono.probe = service.probe
+  }
+
+  if (mono.probe === undefined && dependency.probe !== undefined && dependency.probe !== false)
+    mono.probe = dependency.probe
+
+  return mono
+}
+
 exports.describe = describe

package/src/deployment/chart/templates/mono.yaml

@@ -0,0 +1,168 @@
+{{- if .Values.mono }}
+{{- with .Values.mono }}
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: mono
+spec:
+  replicas: {{ .replicas | default 2 }}
+  progressDeadlineSeconds: 900
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxUnavailable: 0
+      maxSurge: 50%
+  selector:
+    matchLabels:
+      toa.io/composition: mono
+  template:
+    metadata:
+      labels:
+        toa.io/composition: mono
+        {{- range .components }}
+        {{ . }}: "1"
+        {{- end }}
+    spec:
+      containers:
+        - name: mono
+          image: {{ .image }}
+          {{- if .port }}
+          ports:
+            - containerPort: {{ .port }}
+          {{- else if .probe }}
+          ports:
+            - containerPort: {{ .probe.port }}
+          {{- end }}
+          {{- if .resources }}
+          resources:
+            {{- if or .resources.cpu .resources.memory }}
+            requests:
+              {{- if .resources.cpu }}
+              cpu: {{ index .resources.cpu 0 }}
+              {{- end }}
+              {{- if .resources.memory }}
+              memory: {{ index .resources.memory 0 }}
+              {{- end }}
+            limits:
+              {{- if .resources.cpu }}
+              cpu: {{ index .resources.cpu 1 }}
+              {{- end }}
+              {{- if .resources.memory }}
+              memory: {{ index .resources.memory 1 }}
+              {{- end }}
+            {{- end }}
+          {{- end }}
+          {{- if .variables }}
+          env:
+            {{- range .variables }}
+            {{- include "env.var" . | indent 12 }}
+            {{- end }}
+          {{- end }}
+          {{- if .probe }}
+          startupProbe:
+            httpGet:
+              path: {{ .probe.path }}
+              port: {{ .probe.port }}
+            {{- if .probe.delay }}
+            initialDelaySeconds: {{ .probe.delay }}
+            {{- end }}
+            periodSeconds: 2
+            timeoutSeconds: 3
+            failureThreshold: 150
+          readinessProbe:
+            httpGet:
+              path: {{ .probe.path }}
+              port: {{ .probe.port }}
+            periodSeconds: 10
+            timeoutSeconds: 3
+            failureThreshold: 3
+          {{- end }}
+          {{- if .mounts }}
+          volumeMounts:
+            {{- range .mounts }}
+            - name: {{ .name }}
+              mountPath: {{ .path }}
+            {{- end }}
+          {{- end }}
+          lifecycle:
+            preStop:
+              exec:
+                command: [sleep, "5"]
+      terminationGracePeriodSeconds: 45
+      {{- if $.Values.credentials }}
+      imagePullSecrets:
+        - name: {{ $.Values.credentials }}
+      {{- end }}
+      {{- if .mounts }}
+      volumes:
+        {{- range .mounts }}
+        - name: {{ .name }}
+          persistentVolumeClaim:
+            claimName: {{ .claim }}
+        {{- end }}
+      {{- end }}
+      topologySpreadConstraints:
+        - maxSkew: 1
+          topologyKey: kubernetes.io/hostname
+          whenUnsatisfiable: ScheduleAnyway
+          labelSelector:
+            matchLabels:
+              toa.io/composition: mono
+{{- if .port }}
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: mono
+spec:
+  type: ClusterIP
+  selector:
+    toa.io/composition: mono
+  ports:
+    - name: port-{{ .port }}
+      protocol: TCP
+      port: {{ .port }}
+      targetPort: {{ .port }}
+{{- end }}
+{{- if .ingress }}
+---
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: mono
+  {{- if .ingress.annotations }}
+  annotations:
+{{ toYaml .ingress.annotations | indent 4 }}
+  {{- end }}
+spec:
+  {{- if .ingress.class }}
+  ingressClassName: {{ .ingress.class }}
+  {{- end }}
+  rules:
+    {{- range .ingress.hosts }}
+    - host: {{ . }}
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: mono
+                port:
+                  number: {{ $.Values.mono.port | default 8000 }}
+    {{- end }}
+    {{- if .ingress.default }}
+    - http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: mono
+                port:
+                  number: {{ $.Values.mono.port | default 8000 }}
+    {{- end }}
+{{- end }}
+---
+{{- end }}
+{{- end }}

package/src/deployment/deployment.js

@@ -13,11 +13,11 @@ class Deployment {
   #process
   #target
 
-  constructor (context, compositions, dependencies, process) {
+  constructor (context, compositions, dependencies, process, image) {
     const dependency = merge(dependencies)
 
     this.#chart = declare(context, dependency)
-    this.#values = describe(context, compositions, dependency)
+    this.#values = describe(context, compositions, dependency, image)
     this.#process = process
   }
 
@@ -69,6 +69,9 @@ class Deployment {
     addVariables(this.#values.compositions, variables, used)
     addVariables(this.#values.services, variables, used)
 
+    if (this.#values.mono !== undefined)
+      addVariables([this.#values.mono], variables, used)
+
     return variables
   }
 }

package/src/deployment/factory.js

@@ -11,24 +11,42 @@ const { Service } = require('./service')
 
 class Factory {
   #context
+  #root
+  #mono
   #compositions
   #dependencies
   #registry
   #process
+  #image
 
-  constructor (context) {
+  constructor (context, options = {}) {
     this.#context = context
+    this.#root = options.root
+    this.#mono = options.mono === true
     this.#process = new Process()
 
     const imagesFactory = new ImagesFactory(context.name, context.runtime, context.registry)
 
     this.#registry = new Registry(context.name, context.registry, imagesFactory, this.#process)
-    this.#compositions = context.compositions.map((composition) => this.#composition(composition))
     this.#dependencies = this.#getDependencies()
+    this.#compositions = []
+
+    if (this.#mono)
+      this.#image = this.#registry.mono({
+        components: context.components
+      }, this.#root)
+    else
+      this.#compositions = context.compositions.map((composition) => this.#composition(composition))
   }
 
   operator () {
-    const deployment = new Deployment(this.#context, this.#compositions, this.#dependencies, this.#process)
+    const deployment = new Deployment(
+      this.#context,
+      this.#compositions,
+      this.#dependencies,
+      this.#process,
+      this.#image
+    )
 
     return new Operator(deployment, this.#registry)
   }
@@ -70,7 +88,8 @@ class Factory {
     const dependency = module.deployment(instances, annotation)
 
     /** @type {toa.deployment.Service[]} */
-    const services = dependency.services?.map((service) => this.#service(path, service))
+    const services = dependency.services?.map((service) =>
+      this.#mono ? service : this.#service(path, service))
 
     return { ...dependency, services }
   }
@@ -86,10 +105,10 @@ class Factory {
     return new Service(service, image)
   }
 
-  static async create (path, environment) {
+  static async create (path, environment, options = {}) {
     const context = await load(path, environment)
 
-    return new Factory(context)
+    return new Factory(context, { ...options, root: path })
   }
 }
 

package/src/deployment/images/factory.js

@@ -2,6 +2,7 @@
 
 const { Composition } = require('./composition')
 const { Service } = require('./service')
+const { Mono } = require('./mono')
 
 class Factory {
   /** @type {string} */
@@ -45,6 +46,17 @@ class Factory {
 
     return instance
   }
+
+  /**
+   * @returns {Mono}
+   */
+  mono (composition, root) {
+    const instance = new Mono(this.#scope, this.#runtime, this.#registry, composition, root)
+
+    instance.tag()
+
+    return instance
+  }
 }
 
 exports.Factory = Factory

package/src/deployment/images/mono.Dockerfile

@@ -0,0 +1,18 @@
+FROM {{build.image}}
+
+{{build.arguments}}
+
+ENV NODE_ENV=production
+RUN if [ "{{runtime.registry}}" != "" ]; then npm set registry {{runtime.registry}}; fi
+RUN if [ "{{runtime.proxy}}" != "" ]; then npm set proxy {{runtime.proxy}}; fi
+
+WORKDIR /composition
+COPY --chown=node:node . /composition
+
+{{build.run}}
+
+RUN --mount=type=cache,target=/root/.npm \
+  for entry in components/*; do if [ -f "$entry/package.json" ]; then (cd $entry && npm i --omit=dev); fi; done
+
+USER node
+CMD toa mono .

package/src/deployment/images/mono.js

@@ -0,0 +1,82 @@
+'use strict'
+
+const { join } = require('node:path')
+const fs = require('fs-extra')
+const { createHash } = require('node:crypto')
+
+const { Image } = require('./image')
+
+class Mono extends Image {
+  dockerfile = join(__dirname, 'mono.Dockerfile')
+
+  #root
+  #image
+  #components
+
+  constructor (scope, runtime, registry, composition, root) {
+    super(scope, runtime, registry)
+
+    this.#root = root
+    this.#image = composition.image
+    this.#components = composition.components
+  }
+
+  get name () {
+    return 'mono'
+  }
+
+  get version () {
+    const hash = createHash('sha256')
+
+    for (const component of this.#components) {
+      hash.update(component.locator.id)
+      hash.update(component.version)
+    }
+
+    return hash.digest('hex').slice(0, 8)
+  }
+
+  get base () {
+    let image = this.#image
+
+    for (const component of this.#components) {
+      const value = component.build?.image
+
+      if (image !== null && image !== value)
+        throw new Error('Mono deployment requires different base images for its components. Specify base image for the composition in the context.')
+
+      image = value
+    }
+
+    return image
+  }
+
+  get run () {
+    const commands = []
+
+    for (const component of this.#components) {
+      const run = component.build?.run
+
+      if (run !== undefined)
+        commands.push(run)
+    }
+
+    return commands.join('\n')
+  }
+
+  async prepare (root) {
+    const context = await super.prepare(root)
+
+    await fs.copy(join(this.#root, CONTEXT), join(context, CONTEXT))
+    await fs.ensureDir(join(context, 'components'))
+
+    for (const component of this.#components)
+      await fs.copy(component.path, join(context, 'components', component.locator.label))
+
+    return context
+  }
+}
+
+const CONTEXT = 'context.toa.yaml'
+
+exports.Mono = Mono

package/src/deployment/registry.js

@@ -35,6 +35,10 @@ class Registry {
     return this.#create('service', path, service)
   }
 
+  mono (composition, root) {
+    return this.#create('mono', composition, root)
+  }
+
   async prepare (root) {
     const path = await workspace.create('images', root)
 
@@ -61,7 +65,7 @@ class Registry {
   }
 
   /**
-   * @param {'composition' | 'service'} type
+   * @param {'composition' | 'service' | 'mono'} type
    * @param {...any} args
    * @returns {toa.deployment.images.Image}
    */