podman/test/python/docker/compat
rcmadhankumar bf7dcd5619 Fix: Remove appending rw as the default mount option
The backstory for this is that runc 1.2 (opencontainers/runc#3967)
fixed a long-standing bug in our mount flag handling (a bug that crun
still has). Before runc 1.2, when dealing with locked mount flags that
user namespaced containers cannot clear, trying to explicitly clearing
locked flags (like rw clearing MS_RDONLY) would silently ignore the rw
flag in most cases and would result in a read-only mount. This is
obviously not what the user expects.

What runc 1.2 did is that it made it so that passing clearing flags
like rw would always result in an attempt to clear the flag (which was
not the case before), and would (in all cases) explicitly return an
error if we try to clear locking flags. (This also let us finally fix a
bunch of other long-standing issues with locked mount flags causing
seemingly spurious errors).

The problem is that podman sets rw on all mounts by default (even if
the user doesn't specify anything). This is actually a no-op in
runc 1.1 and crun because of a bug in how clearing flags were handled
(rw is the absence of MS_RDONLY but until runc 1.2 we didn't correctly
track clearing flags like that, meaning that rw would literally be
handled as if it were not set at all by users) but in runc 1.2 leads to
unfortunate breakages and a subtle change in behaviour (before, a ro
mount being bind-mounted into a container would also be ro -- though
due to the above bug even setting rw explicitly would result in ro in
most cases -- but with runc 1.2 the mount will always be rw even if
the user didn't explicitly request it which most users would find
surprising). By the way, this "always set rw" behaviour is a departure
from Docker and it is not necesssary.

Signed-off-by: rcmadhankumar <madhankumar.chellamuthu@suse.com>
2025-04-23 17:18:03 +05:30
..
README.md Refactor python tests to run against python3.9 2021-03-01 13:15:59 -07:00
__init__.py Refactor python tests to run against python3.9 2021-03-01 13:15:59 -07:00
common.py Fix language. Mostly spelling a -> an 2022-11-20 19:41:06 +01:00
constant.py tests: add docker api compatibility test 2024-02-28 19:45:03 +01:00
test_containers.py Fix: Remove appending rw as the default mount option 2025-04-23 17:18:03 +05:30
test_images.py Add sha256: to images history id for docker compatibility 2023-04-26 14:38:07 -04:00
test_system.py Refactor docker-py compatibility tests 2022-03-01 09:06:52 -07:00

README.md

Docker regression test

Python test suite to validate Podman endpoints using docker library (aka docker-py). See Docker SDK for Python.

Running Tests

To run the tests locally in your sandbox (Fedora 32,33):

# dnf install python3-docker

Run the entire test suite

All commands are run from the root of the repository.

# python3 -m unittest discover -s test/python/docker

Passing the -v option to your test script will instruct unittest.main() to enable a higher level of verbosity, and produce detailed output:

# python3 -m unittest -v discover -s test/python/docker

Run a specific test class

# python3 -m unittest -v test.python.docker.compat.test_images.TestImages

Run a specific test within the test class

# python3 -m unittest test.python.docker.compat.test_images.TestImages.test_tag_valid_image