|
| 1 | +--- |
| 2 | +title: OCI Runtime Spec v1.3 |
| 3 | +author: |
| 4 | + name: Open Container Initiative |
| 5 | + tag: oci |
| 6 | +tags: blog |
| 7 | +date: 2025-11-04 |
| 8 | +--- |
| 9 | + |
| 10 | +We are delighted to announce the release of the [OCI Runtime Spec](https://github.com/opencontainers/runtime-spec) v1.3.0. |
| 11 | +This release contains [24 pull requests](https://github.com/opencontainers/runtime-spec/milestone/18?closed=1) that were merged since the 1.2.1 release. |
| 12 | +We appreciate everybody who contributed to this release. |
| 13 | + |
| 14 | +# What is the OCI Runtime Spec? |
| 15 | + |
| 16 | +The OCI Runtime Spec defines the behavior and the configuration interface of low-level container runtimes such as [runc](https://github.com/opencontainers/runc). |
| 17 | +The spec is also implemented by [crun](https://github.com/containers/crun), [youki](https://github.com/containers/youki), [gVisor](https://gvisor.dev/), |
| 18 | +[Kata Containers](https://katacontainers.io/), and others. |
| 19 | +These low-level container runtimes are usually called from high-level container runtimes such as [containerd](https://containerd.io/) and [CRI-O](https://cri-o.io/). |
| 20 | + |
| 21 | +# Additions |
| 22 | + |
| 23 | +## [config-vm: add hwConfig object (#1209)](https://github.com/opencontainers/runtime-spec/pull/1209) |
| 24 | + |
| 25 | +The `vm.hwConfig` object is added to describe hardware configuration that should be passed to a VM-based container runtime. |
| 26 | +e.g., number of vCPUs, amount of memory, and the device tree. |
| 27 | + |
| 28 | +## [config-linux: add intelRdt.schemata field (#1230)](https://github.com/opencontainers/runtime-spec/pull/1230) |
| 29 | + |
| 30 | +The `linux.intelRdt.schemata` field is added to address the complexity of separate schema fields and to resolve the issue of supporting currently uncovered |
| 31 | +[Intel Resource Director Technology (RDT)](https://intel.github.io/cri-resource-manager/stable/docs/policy/rdt.html) features, such as |
| 32 | +- L2 cache allocation |
| 33 | +- Code and Data Prioritization (CDP). |
| 34 | + |
| 35 | +## [config-linux: add netDevices object (#1271)](https://github.com/opencontainers/runtime-spec/pull/1271) |
| 36 | + |
| 37 | +The `linux.netDevices` field is added to provide a declarative way to specify which host network devices should be moved into a container's network namespace. |
| 38 | + |
| 39 | +## [config-linux: add memoryPolicy object (#1282)](https://github.com/opencontainers/runtime-spec/pull/1282) |
| 40 | + |
| 41 | +The `linux.memoryPolicy` object is added to specify [NUMA policies](https://man7.org/linux/man-pages/man2/set_mempolicy.2.html). |
| 42 | + |
| 43 | +## [config-freebsd: add the spec for FreeBSD (#1286)](https://github.com/opencontainers/runtime-spec/pull/1286) |
| 44 | + |
| 45 | +The `freebsd` object is added to implement containers using [FreeBSD jails](https://docs.freebsd.org/en/books/handbook/jails/). |
| 46 | + |
| 47 | +The following implementations are known: |
| 48 | +- [runj](https://github.com/samuelkarp/runj) |
| 49 | +- [ocijail](https://github.com/dfr/ocijail) |
| 50 | + |
| 51 | +## [config-linux: add intelRdt.enableMonitoring field (#1287)](https://github.com/opencontainers/runtime-spec/pull/1287) |
| 52 | + |
| 53 | +The `linux.intelRdt.enableMonitoring` field is added to enable [resctrl](https://docs.kernel.org/filesystems/resctrl.html) monitoring features. |
| 54 | +This fields replaces the `enableCMT` and `enableMBM` fields, available in the spec versions v1.1.0 through v1.2.1. |
| 55 | +Their semantics were loosely defined and there were no known implementations, so this change should not affect any existing implementations. |
| 56 | + |
| 57 | +# Other changes |
| 58 | + |
| 59 | +See [here](https://github.com/opencontainers/runtime-spec/pull/1302) for the list of the full changes. |
| 60 | + |
| 61 | +# What's next? |
| 62 | + |
| 63 | +See the [GitHub issues](https://github.com/opencontainers/runtime-spec/issues) and |
| 64 | +the [pull requests](https://github.com/opencontainers/runtime-spec/pulls) |
| 65 | +for the proposals toward the future releases. |
| 66 | +e.g., |
| 67 | +- [Add Landlock LSM support (#1241)](https://github.com/opencontainers/runtime-spec/pull/1241) |
| 68 | +- [Add vTPM specification (#1293)](https://github.com/opencontainers/runtime-spec/pull/1293) |
| 69 | + |
| 70 | +You are always welcome to submit your own proposals too. |
0 commit comments