Skip to content

From a product to running work

License. When a product requires licensing, a license file can authorize and register one or more products and supply their image references. A product can also be registered directly from a container image or development URL, so a license is an optional starting point rather than a parent resource that every product must have.

Product. A product is a Norsk application registered from a container image, development URL or license file. The Manager runs it to read its manifest and build launchable product templates; the registration also records its license posture. A product is not itself a production or runtime.

Product template. A product template is a named, configured, launchable use of one product. Updating one creates a new immutable revision. New launches use the latest revision, while an already-launched runtime remains pinned to the exact revision and artifact SHA it started with. Earlier revisions can be inspected but not edited.

Workdir asset. A workdir asset is a content-addressed file needed by a template or launch, such as configuration or supporting media. The Manager stores it by digest so a worker receives exactly the content the definition referred to.

Production template. A production template is a reusable definition of an entire production. It contains one or more ordered runtime definitions, each based on a product template and supplying its parameters, launch configuration and placement requirements. The production template can select a pool, but the concrete cloud, network and machine configuration remains with that pool’s tiers. It is often the thing an organization calls a show format. A product template configures one product; a production template composes configured products into a show.

Production. A production is one operator-managed instance of a show or workload. When launched from a production template, each runtime definition becomes a runtime owned by the new production. A production has a unique, immutable operator-supplied name and records both what the operator wants and what is actually happening. It may also be defined directly, without first saving a production template, and can start immediately or on a schedule.

Runtime. A runtime is one executable instance of a product, configured by its runtime definition, within exactly one production. It pins the exact product-template revision it was launched from, carries its placement requirements and has a managed lifecycle. The Manager places it on a suitable node. Operators change the production or its definitions rather than mutating the live runtime underneath the Manager.

The main relationships are:

Where that capacity comes from, and how a runtime is matched to it, is Capacity and placement.