From Fedora Project Wiki

Description

A simple validation test case for Podman on Fedora IoT Edition.

Setup

This testcase can be run on either an image or installation, on hardware or in virtualization.

How to test

Boot image or Installation and log in locally or SSH into booted image. For this test, use a regular user account to ensure rootless podman is working.

Check if podman is installed

 rpm -q podman

Check to see if you can pull an image from the registry

podman pull registry.fedoraproject.org/fedora:latest

Note when testing aarch64 you may need to include '--override-arch arm64' due to this bug

Run hello-world to test.

podman run -it registry.fedoraproject.org/fedora:latest echo Hello-World

Create a container from a Containerfile

For this test you can use a Containerfile of your own or use this basic example below:

cat << EOF >> Containerfile
FROM registry.fedoraproject.org/fedora:latest
RUN /usr/bin/dnf install -y httpd
EXPOSE 80
CMD ["-D", "FOREGROUND"]
ENTRYPOINT ["/usr/sbin/httpd"]
EOF

Build an image

podman build -t fedora-httpd $(pwd)

Verify the image

podman images

Run the container

podman run -d -p 1080:80 localhost/fedora-httpd

Verify the container is running

podman container ls

Test apache is working, this should display the Test page html.

curl http://localhost:1080

Open the firewall to accept connections on port 80 and forward to port 1080

 sudo firewall-cmd --add-forward-port=port=80:proto=tcp:toport=1080 --permanent
 sudo firewall-cmd --reload

Open a web browser on another computer and enter the IP address to test the page is visible.

Results

  1. Latest image pulled successfully from the Registry
  2. podman is installed
  3. Hello World is displayed
  4. Custom container created, httpd test page visible on a browser or using curl.