Flatcar icon indicating copy to clipboard operation
Flatcar copied to clipboard

[RFE] Create test coverage and documentation for Podman

Open miao0miao opened this issue 9 months ago • 4 comments

Current situation

We have a supported Podman sysext extension but no test coverage for it nor documentation https://www.flatcar.org/docs/latest/provisioning/sysext/#flatcar-release-extensions-official

miao0miao avatar Feb 28 '25 11:02 miao0miao

As part of our docs we should note that /etc/sub?id is created automatically for all users and groups created by ignition. You should not attempt to modify these files further using ignition as there is a conflict and you wind up with the first line of your sub?id files mangled as the core user is forced into, overwriting whatever is on the first line.

bexelbie avatar Mar 12 '25 09:03 bexelbie

As part of our docs we should note that /etc/sub?id is created automatically for all users and groups created by ignition. You should not attempt to modify these files further using ignition as there is a conflict and you wind up with the first line of your sub?id files mangled as the core user is forced into, overwriting whatever is on the first line.

Before we can confirm this in docs though, we have to get /etc/sub[ug]id working. See: https://github.com/flatcar/Flatcar/issues/1733

bexelbie avatar Apr 25 '25 08:04 bexelbie

Before getting into testing, @yufi16 will have a look to provide initial documentation. This is some ideas of elements to cover following elements:

  • really small intro to Podman
  • how to run Podman (with and without rootless mode (subuid / subgid settings)
  • how to run Podman without Docker / Containerd
  • a more advanced example to use ZFS + Podman: https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md#storage-table

Note: Incus documentation can be used as inspiration (https://www.flatcar.org/docs/latest/container-runtimes/incus/), the goal here is not to rewrite Podman documentation.

tormath1 avatar Jul 25 '25 07:07 tormath1

Looking into this, thank you @tormath1

yufi16 avatar Dec 09 '25 15:12 yufi16