{"id":21273275,"url":"https://github.com/sclorg/s2i-perl-container","last_synced_at":"2025-04-07T09:20:09.709Z","repository":{"id":29200757,"uuid":"32732062","full_name":"sclorg/s2i-perl-container","owner":"sclorg","description":"Perl container images based on Red Hat Software Collections and intended for OpenShift and general usage, that provide a platform for building and running Perl applications. Users can choose between Red Hat Enterprise Linux, Fedora, and CentOS based images.","archived":false,"fork":false,"pushed_at":"2025-03-25T12:33:46.000Z","size":560,"stargazers_count":16,"open_issues_count":7,"forks_count":56,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-31T07:09:16.593Z","etag":null,"topics":["centos","container","dockerfile","fedora","openshift","perl","rhel","s2i","source-to-image"],"latest_commit_sha":null,"homepage":"http://softwarecollections.org","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sclorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-03-23T12:53:15.000Z","updated_at":"2025-02-18T15:32:04.000Z","dependencies_parsed_at":"2023-12-15T11:23:57.821Z","dependency_job_id":"59d8a636-bd49-4051-9294-f9e023d68908","html_url":"https://github.com/sclorg/s2i-perl-container","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fs2i-perl-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fs2i-perl-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fs2i-perl-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fs2i-perl-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sclorg","download_url":"https://codeload.github.com/sclorg/s2i-perl-container/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247622983,"owners_count":20968575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["centos","container","dockerfile","fedora","openshift","perl","rhel","s2i","source-to-image"],"created_at":"2024-11-21T09:13:16.949Z","updated_at":"2025-04-07T09:20:09.671Z","avatar_url":"https://github.com/sclorg.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Perl container images\n=====================\n\n[![Build and push images to Quay.io registry](https://github.com/sclorg/s2i-perl-container/actions/workflows/build-and-push.yml/badge.svg)](https://github.com/sclorg/s2i-perl-container/actions/workflows/build-and-push.yml)\n\nImages available on Quay are:\n* CentOS Stream 9 [perl-5.32](https://quay.io/repository/sclorg/perl-532-c9s)\n* CentOS Stream 10 [perl-5.40](https://quay.io/repository/sclorg/perl-540-c10s)\n* Fedora [perl-5.32](https://quay.io/repository/fedora/perl-532)\n* Fedora [perl-5.34](https://quay.io/repository/fedora/perl-534)\n* Fedora [perl-5.36](https://quay.io/repository/fedora/perl-536)\n* Fedora [perl-5.38](https://quay.io/repository/fedora/perl-538)\n* Fedora [perl-5.40](https://quay.io/repository/fedora/perl-540)\n\nThis repository contains the source for building various versions of\nthe Perl application as a reproducible container image using\n[source-to-image](https://github.com/openshift/source-to-image).\nUsers can choose between RHEL and CentOS based builder images.\nThe resulting image can be run using [podman](https://github.com/containers/libpod).\n\nFor more information about using these images with OpenShift, please see the\nofficial [OpenShift Origin documentation](https://docs.okd.io/latest/using_images/s2i_images/perl.html).\n\nFor more information about contributing, see\n[the Contribution Guidelines](https://github.com/sclorg/welcome/blob/master/contribution.md).\nFor more information about concepts used in these container images, see the\n[Landing page](https://github.com/sclorg/welcome).\n\n\nVersions\n--------\nPerl versions currently provided:\n* [perl-5.26](5.26)\n* [perl-5.30](5.30)\n* [perl-5.32](5.32)\n* [perl-5.34](5.34)\n* [perl-5.36](5.36)\n* [perl-5.38](5.38)\n* [perl-5.40](5.40)\n\nRHEL versions currently supported:\n* RHEL8\n* RHEL9\n* RHEL10\n\nCentOS versions currently supported:\n* CentOS Stream 9\n* CentOS Stream 10\n\n\nInstallation\n------------\nTo build a Perl image, choose either the CentOS Stream or RHEL based image:\n\n*  **RHEL based image**\n\n    These images are available in the [Red Hat Container Catalog](https://access.redhat.com/containers/#/registry.access.redhat.com/rhel8/perl-532).\n    To download it run:\n\n    ```\n    $ podman pull registry.access.redhat.com/rhel8/perl-532\n    ```\n\n    To build a RHEL based Perl image, you need to run the build on a properly\n    subscribed RHEL machine.\n\n    ```\n    $ git clone --recursive https://github.com/sclorg/s2i-perl-container.git\n    $ cd s2i-perl-container\n    $ make build TARGET=rhel8 VERSIONS=5.32\n    ```\n\n*  **CentOS Stream based image**\n\n    This image is available on DockerHub. To download the perl-5.32 image, run:\n\n    ```\n    $ podman pull quay.io/sclorg/perl-532\n    ```\n\n    To build the perl-5.32 image from scratch run:\n\n    ```\n    $ git clone --recursive https://github.com/sclorg/s2i-perl-container.git\n    $ cd s2i-perl-container\n    $ make build TARGET=c9s VERSIONS=5.32\n    ```\n\nNote: while the installation steps are calling `podman`, you can replace any such calls by `docker` with the same arguments.\n\n**Notice: By omitting the `VERSIONS` parameter, the build/test action will be performed\non all provided versions of Perl.**\n\n\nUsage\n-----\n\nFor information about usage of the Dockerfile for Perl 5.30,\nsee [usage documentation](5.30/README.md).\n\nFor information about usage of the Dockerfile for Perl 5.32 - mod_fcgid version,\nsee [usage documentation](5.32/README.md).\n\nFor information about usage of the Dockerfile for Perl 5.34 - mod_fcgid version,\nsee [usage documentation](5.34/README.md).\n\nFor information about usage of the Dockerfile for Perl 5.36 - mod_fcgid version,\nsee [usage documentation](5.36/README.md).\n\nFor information about usage of the Dockerfile for Perl 5.38 - mod_fcgid version,\nsee [usage documentation](5.38/README.md).\n\nFor information about usage of the Dockerfile for Perl 5.40 - mod_fcgid version,\nsee [usage documentation](5.40/README.md).\n\nTest\n----\nThis repository also provides a [S2I](https://github.com/openshift/source-to-image) test framework,\nwhich launches tests to check functionality of a simple Perl application built on top of the s2i-perl image.\n\nUsers can choose between testing a Perl test application based on a RHEL or CentOS image.\n\n*  **RHEL based image**\n\n    To test a RHEL8-based image, you need to run the test on a properly\n    subscribed RHEL machine.\n\n    ```\n    $ cd s2i-perl-container\n    $ make test TARGET=rhel8 VERSIONS=5.32\n    ```\n\n*  **CentOS Stream based image**\n\n    ```\n    $ cd s2i-perl-container\n    $ make test TARGET=c9s VERSIONS=5.32\n    ```\n\n**Notice: By omitting the `VERSIONS` parameter, the build/test action will be performed\non all of the provided versions of Perl.**\n\n\nRepository organization\n-----------------------\n* **`\u003cperl-version\u003e`**\n\n    * **Dockerfile.c9s**\n\n        CentOS Stream based Dockerfile.\n\n    * **Dockerfile.c10s**\n\n        CentOS Stream based Dockerfile.\n\n    * **Dockerfile.rhel8**\n\n        RHEL based Dockerfile. In order to perform build or test actions on this\n        Dockerfile you need to run the action on a properly subscribed RHEL machine.\n\n    * **`s2i/bin/`**\n\n        This folder contains scripts that are run by [S2I](https://github.com/openshift/source-to-image):\n\n        *   **assemble**\n\n            Used to install the sources into a location where the application\n            will be run and prepare the application for deployment (eg. installing\n            modules, etc.).\n            In order to install application dependencies, the application must contain a\n            `cpanfile` file, in which the user specifies the modules and their versions.\n            An example of a [cpanfile](https://github.com/sclorg/s2i-perl-container/blob/master/5.30/test/sample-test-app/cpanfile) is available within our test application.\n\n            All files with `.cgi` and `.pl` extension are handled by mod_perl.\n            If exactly one file with `.psgi` extension exists in the top-level\n            directory, the mod_perl will be autoconfigured to execute the PSGI\n            application for any request URI path with Plack's mod_perl adaptor.\n\n        *   **run**\n\n            This script is responsible for running the application, using the\n            Apache web server.\n\n        *   **usage***\n\n            This script prints the usage of this image.\n\n    * **`contrib/`**\n\n        This folder contains a file with commonly used modules.\n\n    * **`test/`**\n\n        This folder contains the [S2I](https://github.com/openshift/source-to-image)\n        test framework.\n\n        * **`sample-test-app/`**\n\n            A simple Perl application used for testing purposes by the [S2I](https://github.com/openshift/source-to-image) test framework.\n\n        * **run**\n\n            This script runs the [S2I](https://github.com/openshift/source-to-image) test framework.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsclorg%2Fs2i-perl-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsclorg%2Fs2i-perl-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsclorg%2Fs2i-perl-container/lists"}