stafli/stafli.proxy.httpd

Stafli HTTPd Proxy Server

Stafli HTTPd Proxy Server builds based on https://www.debian.org and [] and developed as scripts for []
Continues on https://github.com/stafli-org/stafli.init.supervisor builds.
This project is part of the https://github.com/stafli-org.

Requires https://docs.docker.com/compose 1.6.x or higher due to the https://docs.docker.com/compose/compose-file/#versioning format of the docker-compose.yml files.

There are docker-compose.yml files per distribution, as well as docker-compose.override.yml and .env files, which may be used to override configuration. An optional Makefile is provided to help with loading these with ease and perform commands in batch.

Scripts are also provided for each distribution to help test and deploy the installation procedures in non-Docker environments.

The images are automatically built at a https://hub.docker.com/r/stafli/stafli.proxy.httpd in the Docker Hub registry.

Distributions

The services use custom images as a starting point for the following distributions:

• Debian, from the https://hub.docker.com/_/debian
  • Debian 8 (jessie)
  • Debian 7 (wheezy)
• CentOS, from the https://hub.docker.com/_/centos
  • CentOS 7 (centos7)
  • CentOS 6 (centos6)

Services

These are the services described by the dockerfile and docker-compose files:

• HTTPd 2.4.x (debian8 and centos7), built on https://github.com/stafli-org/stafli.init.supervisor and additional https://httpd.apache.org packages
• HTTPd 2.2.x (debian7 and centos6), built on https://github.com/stafli-org/stafli.init.supervisor and additional https://httpd.apache.org packages

Images

These are the https://hub.docker.com/r/stafli/stafli.proxy.httpd/tags upon building:

• Stable:
  • stafli/stafli.proxy.httpd:httpd24_debian8 https://images.microbadger.com/badges/image/stafli/stafli.proxy.httpd:httpd24_debian8.svg](https://microbadger.com/images/stafli/stafli.proxy.httpd:httpd24_debian8 "Get your own image badge on microbadger.com")
  • stafli/stafli.proxy.httpd:httpd24_centos7 https://images.microbadger.com/badges/image/stafli/stafli.proxy.httpd:httpd24_centos7.svg](https://microbadger.com/images/stafli/stafli.proxy.httpd:httpd24_centos7 "Get your own image badge on microbadger.com")
• Old Stable:
  • stafli/stafli.proxy.httpd:httpd22_debian7 https://images.microbadger.com/badges/image/stafli/stafli.proxy.httpd:httpd22_debian7.svg](https://microbadger.com/images/stafli/stafli.proxy.httpd:httpd22_debian7 "Get your own image badge on microbadger.com")
  • stafli/stafli.proxy.httpd:httpd22_centos6 https://images.microbadger.com/badges/image/stafli/stafli.proxy.httpd:httpd22_centos6.svg](https://microbadger.com/images/stafli/stafli.proxy.httpd:httpd22_centos6 "Get your own image badge on microbadger.com")

Containers

These containers can be created from the images:

• Stable:
  • stafli_proxy_httpd24_debian8_xxx
  • stafli_proxy_httpd24_centos7_xxx
• Old Stable:
  • stafli_proxy_httpd22_debian7_xxx
  • stafli_proxy_httpd22_centos6_xxx

Usage

From Docker Hub repository (manual)

Note: this method will not allow you to use the docker-compose files nor the Makefile.

1. To pull the images, try typing:
   docker pull <image_url>
2. You can start a new container interactively by typing:
   docker run -ti <image_url> /bin/bash

Where <image_url> is the full image url (lookup the image list above).

Example:

docker pull stafli/stafli.proxy.httpd:httpd24_debian8

docker run -ti stafli/stafli.proxy.httpd:httpd24_debian8 /bin/bash

From GitHub repository (automated)

Note: this method allows using docker-compose and the Makefile.

1. Download the repository https://github.com/stafli-org/stafli.proxy.httpd/archive/master.zip and unpack it or clone the repository using:
   git clone https://github.com/stafli-org/stafli.proxy.httpd.git
2. Navigate to the project directory through the terminal:
   cd stafli.proxy.httpd
3. Type in the desired operation through the terminal:
   make <operation> DISTRO=<distro>

Where is the distribution/directory and is the desired docker-compose operation.

Example:

git clone https://github.com/stafli-org/stafli.proxy.httpd.git;
cd stafli.proxy.httpd;

# Example #1: quick start, with build
make up DISTRO=debian8;

# Example #2: quick start, with pull
make img-pull DISTRO=debian8;
make up DISTRO=debian8;

# Example #3: manual steps, with build
make img-build DISTRO=debian8;
make con-create DISTRO=debian8;
make con-start DISTRO=debian8;
make con-ls DISTRO=debian8;

Type make in the terminal to discover all the possible commands.

Credits

Stafli HTTPd Proxy Server
Copyright (C) 2016-2017 Stafli
Luís Pedro Algarvio
This file is part of the Stafli Application Stack.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.