Add PyTest suite for nginx-container.

Migration matrix is:
```
TEST_LIST_APP="\
test_s2i_usage -> test_container_basics.py(TestNginxContainer.test_run_s2i_usage)
test_docker_run_usage -> test_container_basics.py(TestNginxContainer.test_docker_run_usage)
test_scl_usage -> test_container_basics.py(TestNginxContainer.test_scl_usage)
test_application -> test_container_application.py(TestNginxApplicationContainer.test_application)
test_log_output -> test_container_example_apps.py(TestNginxLogContainer.test_log_output)
test_log_volume_output -> test_container_example_apps.py(TestNginxLogContainer.test_log_volume_output)
test_application_user ->  test_container_application.py(TestNginxApplicationContainer.test_application_user)
"
TEST_LIST_HOOK_APP="test_pre_init_script" -> test_container_example_apps.py(TestNginxExampleAppContainer.test_run_app_test)
TEST_LIST_PERL_APP="test_perl_directive" -> test_container_example_apps.py(TestNginxExamplePerlAppContainer.test_run_app_test)
TEST_LIST_MISC=run_dockerfiles_test -> test_container_basics.py(TestNginxContainer.test_dockerfiles)
```

Signed-off-by: Petr "Stone" Hracek <phracek@redhat.com>

Author: phracek

test/constants.py

@@ -1,5 +1,13 @@
+import os
+from pathlib import Path
+
 TAGS = {
     "rhel8": "-ubi8",
     "rhel9": "-ubi9",
     "rhel10": "-ubi10",
 }
+
+VERSION = os.getenv("VERSION")
+OS = os.getenv("OS").lower()
+IMAGE_NAME = os.getenv("IMAGE_NAME")
+TEST_DIR = Path(__file__).parent.absolute()

test/run-pytest

@@ -0,0 +1,17 @@
+#!/bin/bash
+#
+# IMAGE_NAME specifies a name of the candidate image used for testing.
+# The image has to be available before this script is executed.
+# SINGLE_VERSION specifies the major version of the MariaDB in format of X.Y
+# OS specifies RHEL version (e.g. OS=rhel8)
+#
+
+THISDIR=$(dirname ${BASH_SOURCE[0]})
+
+git show -s
+
+PYTHON_VERSION="3.12"
+if [[ ! -f "/usr/bin/python$PYTHON_VERSION" ]]; then
+  PYTHON_VERSION="3.13"
+fi
+cd "${THISDIR}" && "python${PYTHON_VERSION}" -m pytest -s -rA --showlocals -vv test_container*.py

test/test_container_application.py

@@ -0,0 +1,66 @@
+import pytest
+
+
+from pathlib import Path
+from container_ci_suite.container_lib import ContainerTestLib
+from container_ci_suite.engines.podman_wrapper import PodmanCLIWrapper
+from constants import TEST_DIR, IMAGE_NAME, VERSION
+
+test_app = TEST_DIR / "test-app"
+
+
+def build_s2i_app(app_path: Path) -> ContainerTestLib:
+    container_lib = ContainerTestLib(IMAGE_NAME)
+    app_name = app_path.name
+    s2i_app = container_lib.build_as_df(
+        app_path=app_path,
+        s2i_args="--pull-policy=never",
+        src_image=IMAGE_NAME,
+        dst_image=f"{IMAGE_NAME}-{app_name}"
+    )
+    return s2i_app
+
+
+class TestNginxApplicationContainer:
+
+    def setup_method(self):
+        self.app = ContainerTestLib(image_name=IMAGE_NAME, s2i_image=True)
+
+    def teardown_method(self):
+        self.app.cleanup()
+
+    @pytest.mark.parametrize(
+        "container_arg",
+        [
+            "",
+            "--user 12345"
+        ]
+    )
+    # test_application
+    def test_application(self, container_arg):
+        version = VERSION.replace("-micro", "")
+        cid_file_name = "test-app"
+        assert self.app.create_container(
+            cid_file_name=cid_file_name,
+            container_args=f"--user 10001 {container_arg}"
+        )
+        cip = self.app.get_cip(cid_file_name=cid_file_name)
+        assert cip
+        assert PodmanCLIWrapper.podman_run_command(
+            f"--rm {self.app.image_name} /bin/bash -c 'nginx -v'"
+        ).startswith(f"nginx version: nginx/{version}")
+        assert self.app.test_response(
+            url=f"http://{cip}", expected_output="NGINX is working"
+        )
+        assert self.app.test_response(
+            url=f"http://{cip}", expected_output="NGINX2 is working",
+            host="localhost2"
+        )
+        assert self.app.test_response(
+            url=f"http://{cip}", expected_output="NGINX2 is working",
+            page="/aliased/index2.html"
+        )
+        assert self.app.test_response(
+            url=f"http://{cip}", expected_code=404,
+            page="/nginx-cfg/default.conf"
+        )

test/test_container_basics.py

@@ -0,0 +1,56 @@
+import pytest
+
+from container_ci_suite.container_lib import ContainerTestLib
+from container_ci_suite.engines.podman_wrapper import PodmanCLIWrapper
+from container_ci_suite.dockerfile_processor import DockerfileProcessor
+
+from constants import TEST_DIR, IMAGE_NAME, VERSION
+
+
+class TestNginxContainer:
+
+    def setup_method(self):
+        self.app = ContainerTestLib(image_name=IMAGE_NAME, s2i_image=True)
+
+    def teardown_method(self):
+        self.app.cleanup()
+
+    def test_run_s2i_usage(self, app):
+        output = app.s2i_usage()
+        assert output != ""
+
+    def test_docker_run_usage(self):
+        assert PodmanCLIWrapper.call_podman_command(
+            cmd=f"run --rm {IMAGE_NAME} &>/dev/null",
+            return_output=False
+        ) == 0
+
+    def test_scl_usage(self):
+        version = VERSION.replace("-micro", "")
+        assert PodmanCLIWrapper.podman_run_command(
+            f"--rm {IMAGE_NAME} /bin/bash -c 'nginx -v'"
+        ).startswith(f"nginx version: nginx/{version}")
+
+    @pytest.mark.parametrize(
+        "dockerfile",
+        [
+            "Dockerfile",
+            "Dockerfile.s2i"
+        ]
+    )
+    def test_dockerfiles(self, app, dockerfile):
+        version = VERSION.replace("-micro", "")
+        dp = DockerfileProcessor(dockerfile_path=f"{TEST_DIR}/examples/{dockerfile}")
+        dp.update_env_in_dockerfile(version=version, what_to_replace="ENV NGINX_VERSION")
+        dp.update_variable_in_dockerfile(version=version, variable="NGINX_VERSION")
+        new_docker_file = dp.create_temp_dockerfile()
+
+        assert app.build_test_container(
+            dockerfile=new_docker_file, app_url="https://github.com/sclorg/nginx-container.git",
+            app_dir="nginx-container"
+        )
+        assert app.test_app_dockerfile()
+        cip = app.get_cip()
+        assert cip
+        assert app.test_response(url=cip, expected_code=200,
+                                 expected_output="NGINX is working")

test/test_container_example_apps.py

@@ -0,0 +1,153 @@
+import pytest
+import re
+
+from pathlib import Path
+
+from container_ci_suite.container_lib import ContainerTestLib
+from container_ci_suite.engines.podman_wrapper import PodmanCLIWrapper
+from container_ci_suite.engines.container import ContainerImage
+
+from constants import TEST_DIR, IMAGE_NAME, VERSION
+
+test_app = TEST_DIR / "test-app"
+perl_test_app = TEST_DIR / "perl-test-app"
+start_hook_test_app = TEST_DIR / "start-hook-test-app"
+
+
+def build_s2i_app(app_path: Path) -> ContainerTestLib:
+    container_lib = ContainerTestLib(IMAGE_NAME)
+    app_name = app_path.name
+    s2i_app = container_lib.build_as_df(
+        app_path=app_path,
+        s2i_args="--pull-policy=never",
+        src_image=IMAGE_NAME,
+        dst_image=f"{IMAGE_NAME}-{app_name}"
+    )
+    s2i_app.set_new_image(image_name=f"{IMAGE_NAME}-{app_name}")
+    return s2i_app
+
+
+class TestNginxExampleAppContainer:
+
+    def setup_method(self):
+        self.s2i_app = build_s2i_app(start_hook_test_app)
+
+    def teardown_method(self):
+        self.s2i_app.cleanup()
+
+    def test_run_app_test(self, example_app_test):
+        version = VERSION.replace("-micro", "")
+        cid_file_name = example_app_test.app_name
+        assert self.s2i_app.create_container(cid_file_name=cid_file_name, container_args="--user 10001")
+        assert ContainerImage.wait_for_cid(cid_file_name=cid_file_name)
+        cid = self.s2i_app.get_cid(cid_file_name=cid_file_name)
+        assert cid
+        cip = self.s2i_app.get_cip(cid_file_name=cid_file_name)
+        assert cip
+        command = PodmanCLIWrapper.podman_get_file_content(
+            cid_file_name=cid, filename="/opt/app-root/etc/nginx.d/default.conf"
+        )
+        assert re.search("resolver", command)
+        assert not re.search("DNS_SERVER", command)
+        assert PodmanCLIWrapper.podman_run_command(
+            f"--rm {example_app_test.image_name} /bin/bash -c 'nginx -v'"
+        ).startswith(f"nginx version: nginx/{version}")
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", expected_output="NGINX is working"
+        )
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", expected_output="NGINX2 is working",
+            host="localhost2"
+        )
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", expected_code=404,
+            page="/nginx-cfg/default.conf"
+        )
+
+
+class TestNginxExamplePerlAppContainer:
+
+    def setup_method(self):
+        self.s2i_app = build_s2i_app(perl_test_app)
+
+    def teardown_method(self):
+        self.s2i_app.cleanup()
+
+    def test_run_app_test(self):
+        if VERSION.endswith("-micro"):
+            pytest.skip("Run the chosen tests (not for micro variant which lacks perl)")
+        cid_file_name = self.s2i_app.app_name
+        self.s2i_app.set_new_image(image_name=f"{IMAGE_NAME}-{cid_file_name}")
+        assert self.s2i_app.create_container(cid_file_name=cid_file_name, container_args="--user 10001")
+        cid = self.s2i_app.get_cid(cid_file_name=cid_file_name)
+        assert cid
+        cip = self.s2i_app.get_cip(cid_file_name=cid_file_name)
+        assert cip
+        perl_version = PodmanCLIWrapper.podman_exec_shell_command(cid_file_name=cid, cmd="perl -e 'print \"$^V\"'")
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", port=8080,
+            expected_output=f"X-Perl-Version: {perl_version}"
+        )
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", port=8080, page="/perl", expected_output="Perl location handler is working"
+        )
+
+class TestNginxLogContainer:
+
+    def setup_method(self):
+        self.s2i_app = build_s2i_app(test_app)
+
+    def teardown_method(self):
+        self.s2i_app.cleanup()
+
+    # test_log_output
+    def test_log_output(self, s2i_log_test):
+        cid_file_name = "test-app"
+        s2i_log_test.set_new_image(image_name=f"{IMAGE_NAME}-{cid_file_name}")
+        assert self.s2i_app.create_container(
+            cid_file_name=cid_file_name,
+            container_args="--user 10001"
+        )
+        cid = self.s2i_app.get_cid(cid_file_name=cid_file_name)
+        assert cid
+        cip = self.s2i_app.get_cip(cid_file_name=cid_file_name)
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", port=8080, expected_output="NGINX is working"
+        )
+        assert '"GET / HTTP/1.1" 200' in s2i_log_test.get_logs(cid_file_name=cid_file_name)
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", port=8080, page="/nothing-at-all", expected_code=404
+        )
+        logs = self.s2i_app.get_logs(cid_file_name=cid_file_name)
+        assert logs
+        assert re.search("open.*failed.*No such file or directory", logs)
+
+    # test_log_volume_output
+    def test_log_volume_output(self, s2i_log_test):
+        cid_file_name = "test-app"
+        s2i_log_test.set_new_image(image_name=f"{IMAGE_NAME}-{cid_file_name}")
+        assert self.s2i_app.create_container(
+            cid_file_name=cid_file_name,
+            container_args="-e NGINX_LOG_TO_VOLUME=y --user 10001"
+        )
+        cid = self.s2i_app.get_cid(cid_file_name=cid_file_name)
+        assert cid
+        cip = self.s2i_app.get_cip(cid_file_name=cid_file_name)
+        assert self.s2i_app.test_response(url=f"http://{cip}", port=8080, expected_output="NGINX is working")
+        assert '"GET / HTTP/1.1" 200' in PodmanCLIWrapper.podman_get_file_content(
+            cid_file_name=cid,
+            filename="/var/log/nginx/access.log"
+        )
+        assert self.s2i_app.test_response(
+            url=f"http://{cip}", port=8080, page="/nothing-at-all", expected_code=404
+        )
+        assert '"GET /nothing-at-all HTTP/1.1" 404' in PodmanCLIWrapper.podman_get_file_content(
+            cid_file_name=cid,
+            filename="/var/log/nginx/access.log"
+        )
+        logs_to_check = PodmanCLIWrapper.podman_get_file_content(
+            cid_file_name=cid,
+            filename="/var/log/nginx/error.log"
+        )
+        assert re.search("open.*failed.*No such file or directory", logs_to_check)
+