Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sclorg/varnish-container

Varnish HTTP Cache container images based on Red Hat Software Collections and intended for OpenShift and general usage. Users can choose between Red Hat Enterprise Linux, Fedora, and CentOS based images.
https://github.com/sclorg/varnish-container

centos container docker dockerfile fedora openshift rhel s2i source-to-image

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/sclorg/varnish-container
Owner: sclorg
License: apache-2.0
Created: 2016-05-12T15:33:53.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-08-21T12:34:20.000Z (4 months ago)
Last Synced: 2024-08-21T17:03:00.727Z (4 months ago)
Topics: centos, container, docker, dockerfile, fedora, openshift, rhel, s2i, source-to-image
Language: Shell
Homepage: http://softwarecollections.org
Size: 228 KB
Stars: 7
Watchers: 9
Forks: 25
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

Varnish HTTP accelerator container images
=========================================

[![Build and push images to Quay.io registry](https://github.com/sclorg/varnish-container/actions/workflows/build-and-push.yml/badge.svg)](https://github.com/sclorg/varnish-container/actions/workflows/build-and-push.yml)

Images available on Quay are:
* CentOS Stream 9 [varnish-6](https://quay.io/repository/sclorg/varnish-6-c9s)
* CentOS Stream 10 [varnish-6](https://quay.io/repository/sclorg/varnish-7-c10s)
* Fedora [varnish-7](https://quay.io/repository/fedora/varnish-7)

This repository contains Dockerfiles for Varnish HTTP accelerator images.
Users can choose between RHEL, CentOS, CentOS Stream 8, CentOS Stream 9 and Fedora based images.

Versions
---------------
Varnish versions currently provided are:
* [varnish-6](./6)
* [varnish-7](./7)

RHEL versions currently supported are:
* RHEL8
* RHEL9

CentOS versions currently supported are:
* CentOS Stream 9
* CentOS Stream 10

For more information about contributing, see
[the Contribution Guidelines](https://github.com/sclorg/welcome/blob/master/contribution.md).
For more information about concepts used in these container images, see the
[Landing page](https://github.com/sclorg/welcome).

Installation
---------------
To build a Varnish image, choose either the CentOS Stream or RHEL based image:
* **RHEL based image**

These images are available in the [Red Hat Container Catalog](https://catalog.redhat.com/software/containers/rhel8/varnish-6/5ba0ae68bed8bd6ee8198613?container-tabs=overview).
To download it run:

```
$ podman pull registry.redhat.io/rhel8/varnish-6
```

To build a RHEL based Varnish image, you need to run the build on a properly
subscribed RHEL machine.

```
$ git clone --recursive https://github.com/sclorg/varnish-container.git
$ cd varnish-container
$ git submodule update --init
$ make build TARGET=rhel8 VERSIONS=6
```
* **CentOS Stream based image**

This image is available on Quay.io. To download it run:

```
$ podman pull quay.io/sclorg/varnish-6-c9s
```

To build a CentOS Varnish image from scratch run:

```
$ git clone --recursive https://github.com/sclorg/varnish-container.git
$ cd varnish-container
$ git submodule update --init
$ make build TARGET=c9s VERSIONS=6

* **Fedora based image**

You need to build the Fedora variant locally:

```
$ git clone --recursive https://github.com/sclorg/varnish-container.git
$ cd varnish-container
$ git submodule update --init
$ make build TARGET=fedora VERSIONS=7
```

Note: while the installation steps are calling `podman`, you can replace any such calls by `docker` with the same arguments.

**Notice: By omitting the `VERSIONS` parameter, the build/test action will be performed
on all provided versions of Varnish.**

Contributing
------------

In this repository [distgen](https://github.com/devexp-db/distgen/) is used for generating image source files. If you'd like update a Dockerfile, please make changes in specs/multispec.yml and/or Dockerfile.template (or other distgen file) and run `make generate`.

Usage
-----
For information about usage of Dockerfile for Varnish 6,
see [usage documentation](https://github.com/sclorg/varnish-container/6).

For information about usage of Dockerfile for Varnish 7,
see [usage documentation](https://github.com/sclorg/varnish-container/7).

Test
----
This repository also provides a [S2I](https://github.com/openshift/source-to-image) test framework,
which launches tests to check functionality of a simple Varnish application built on top of the Varnish image.

Users can choose between testing a Varnish test application based on a RHEL or CentOS image.

* **RHEL based image**

To test a RHEL8 based Varnish image, you need to run the test on a properly
subscribed RHEL machine.

```
$ cd varnish-container
$ git submodule update --init
$ make test TARGET=rhel8 VERSIONS=6
```

* **CentOS Stream based image**

```
$ cd varnish-container
$ git submodule update --init
$ make test TARGET=c9s VERSIONS=6
```

* **Fedora based image**

```
$ cd varnish-container
$ git submodule update --init
$ make test TARGET=fedora VERSIONS=7
```

**Notice: By omitting the `VERSIONS` parameter, the build/test action will be performed
on all provided versions of Varnish.**