Skip to content

[bug] fix microVM actors with one character container names - #2801

Merged
Haven Xia (HavenXia) merged 1 commit into
agent-substrate:mainfrom
BenTheElder:microvm-short-container-names
Oct 19, 2026
Merged

Haven Xia (HavenXia) merged 1 commit into
agent-substrate:mainfrom
BenTheElder:microvm-short-container-names

Conversation

@BenTheElder

Copy link
Copy Markdown
Collaborator

MicroVM actors with a one character container name never started: We used the name as the kata container ID, and kata rejects IDs shorter than two characters. gVisor and Kubernetes allow these names.

https://github.com/kata-containers/kata-containers/blob/4.1.0/src/libs/kata-sys-util/src/validate.rs#L17-L22

The kata ID is now c_<name>. It only depends on the name, since a restored guest keeps the IDs it booted with.
This won't hit any limits, and it can't conflict with container names.
It also fixes a collision risk for container named durable + durable dir volumes (doesn't exist for gvisor).

I had an e2e test, but it seems unlikely we'll regress this and not worth the compute on every PR.

AI-assisted. Tested on kind (micro-VM and gVisor) and I reviewed the changes.

Breaking change: Like other pre-GA changes, you'll lose old snapshots. This should be small enough to land pre-GA.

Fixes #2800

It's a good idea to open an issue first for discussion.

  • Tests pass
  • Appropriate changes to documentation are included in the PR

kata rejects container IDs shorter than two characters, so derive the kata ID from the name instead of using the name as is

this also stops the durable, csi and system-info volume shares from hiding the rootfs of a container with the same name
@HavenXia
Haven Xia (HavenXia) added this pull request to the merge queue Oct 19, 2026
Merged via the queue into agent-substrate:main with commit 5ddc9a8 Oct 19, 2026
15 checks passed
@BenTheElder
Benjamin Elder (BenTheElder) deleted the microvm-short-container-names branch October 19, 2026 17:48
@bowei Bowei Du (bowei) added the kind/bug Something isn't working / bugfixes label Oct 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/microVM breaking-change PRs with breaking changes kind/bug Something isn't working / bugfixes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[bug] single character container names break microvm actors

3 participants