Repository navigation
docs: document Podman support on Linux - #924
Merged
Merged
Conversation
Keploy records and tests applications that run in rootful Podman on Linux, from v3.8.60, and nothing in the docs said so. - Platform requirements gets a Podman section: rootful Podman and why; building images and starting every other container with sudo podman; the rootful podman.socket keploy uses or the API service it starts; what podman compose needs (docker-compose as its provider, Podman 4.7+, systemd for healthchecks) and that podman-compose isn't supported; podman-remote and macOS/Windows refused; and that it is the keploy install.sh installs, as an open-source keploy refuses Podman and says where to get it. - Installation gets a Podman tab beside Docker on Linux, with the record and test commands and the compose form; the older concepts installation page points to it. - The CLI reference mentions it, and common errors covers the refusals, a keploy older than v3.8.60 that records nothing without an error, Podman's error under podman-compose, compose on a host without systemd, and an image left in the rootless store. Signed-off-by: slayerjain <shubhamkjain@outlook.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Keploy records and tests apps that run in Podman on Linux from v3.8.60, but the docs only mentioned Docker. This adds Podman where a user would look for it.
sudo podman, since keploy uses the rootful Podman;podman.socketif it's enabled, and otherwise starts Podman's API service for the run;podman composeneeds docker-compose as its provider, Podman 4.7+, and systemd for healthchecks; podman-compose isn't supported;install.shinstalls. A keploy built from the open-source repository refuses Podman and says where to get it.podman composeform. The older concepts installation page now links there.Tested:
podman runrecord, auto-replay and replay on mocks are covered by Keploy's automated tests, with Podman 5.4.2.podman composewas checked by hand, with Podman 5.8.7 and docker-compose as its provider. Podman 4.7–4.9 hasn't been run with Keploy; the docs give 4.7 as the floor (wherepodman composeappeared) and say Keploy is tested with Podman 5.