containerd api/v1.12.0

Welcome to the api/v1.12.0 release of containerd!

The 13th release for the containerd 1.x API aligns with the containerd 2.4 release.

Highlights

Image Storage

• Include media type in content create events (#13833)

Runtime

• Add UpdateSandbox RPC to propagate sandbox controller updates to the shim (#14105)
• Allow specifying parent checkpoint directory when checkpointing with runc (#13699)

Deprecations

• Deprecate containerd.io/runtime-allow-mounts shim annotation in favor of MountCapabilities bootstrap extension (#14002)
• Deprecate task API address and version fields in runc options and move to CreateTaskRequest (#13360)

Please try out the release binaries and report any issues at https://github.com/containerd/containerd/issues.

Contributors

• Derek McGowan
• Maksym Pavlenko
• Wei Fu
• Jordan Liggitt
• Samuel Karp
• Kohei Tokunaga
• Philip Laine
• Sebastiaan van Stijn
• Sergey Kanzhelev

Changes

24 commits

• sandbox: wire Controller.Update through to the shim (#14105)
  • 2ea4ddb32f sandbox: add UpdateSandbox RPC and forward Controller.Update to the shim
• Prepare api/v1.12.0-rc.0 release (#14047)
  • d767f44b52 Prepare api/v1.12.0-rc.0 release
• Shim mount handler protocol (#14002)
  • a72247425b api: add shim mount capabilities
• chore(api): update github.com/sirupsen/logrus v1.10.2 (#14037)
  • a28910b14f chore(api): update github.com/sirupsen/logrus v1.10.2
• Prepare release notes for api/v1.12.0-beta.0 (#13899)
  • 0ff04dc3f7 Prepare release notes for api/v1.12.0-beta.0
• Include media type in content create event (#13833)
  • a452c2e230 Include media type in content create event
• build(deps): bump golang.org/x/net from 0.51.0 to 0.55.0 in /api (#13819)
  • 52c5f1f64e build(deps): bump golang.org/x/net from 0.51.0 to 0.55.0 in /api
• build(deps): bump github.com/containerd/ttrpc to v1.2.9 (#13740)
  • 658a1c78b5 build(deps): bump github.com/containerd/ttrpc to v1.2.9
• Add parent path to runc checkpoint options (#13699)
  • ea0ed51e21 shim: allow specifying runc’s —parent-path during checkpointing
• Update typeurl/v2 to v2.3.0 to drop gogo dependency (#13490)
  • ce39143249 Update typeurl/v2 to v2.3.0 to drop gogo dependency
• do not hide linitng errors (#13423)
  • 7f10e9eb5f do not hide linitng errors
• Fix sandbox task API endpoints for non-runc runtimes (#13360)
  • ac01ae5c27 protos: include task API address to CreateTaskRequest

Dependency Changes

• github.com/containerd/ttrpc v1.2.5 -> v1.2.9
• github.com/containerd/typeurl/v2 v2.1.1 -> v2.3.0
• github.com/sirupsen/logrus v1.9.3 -> v1.10.2
• golang.org/x/net v0.48.0 -> v0.55.0
• golang.org/x/sys v0.39.0 -> v0.46.0
• golang.org/x/text v0.32.0 -> v0.37.0
• google.golang.org/genproto/googleapis/rpc ff82c1b0f217 -> a57be14db171
• google.golang.org/grpc v1.79.3 -> v1.81.1
• google.golang.org/protobuf v1.36.10 -> v1.36.11

Previous release can be found at api/v1.11.0

---

Source containerd/containerd · api/v1.12.0 · 2026-09-16 · upstream release

Mirrored verbatim for indexing. All rights belong to the upstream project.