stafli/stafli.log.rsyslog repository overview

⁠Stafli Rsyslog Log Server

Stafli Rsyslog Log Server builds based on Debian⁠ and CentOS⁠, and developed as scripts for Docker⁠.
Continues on Stafli Init Supervisor⁠ builds.
This project is part of the Stafli Application Stack⁠.

Requires Docker Compose⁠ 1.6.x or higher due to the version 2⁠ 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 repository⁠ in the Docker Hub registry.

⁠Distributions

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

• Debian, from the official repository⁠
  • Debian 8 (jessie)⁠
  • Debian 7 (wheezy)⁠
• CentOS, from the official repository⁠
  • CentOS 7 (centos7)⁠
  • CentOS 6 (centos6)⁠

⁠Services

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

• Rsyslog 8.4.x (debian8), built on Stafli Init Supervisor⁠ and additional Rsyslog⁠ packages
• Rsyslog 8.24.x (centos7), built on Stafli Init Supervisor⁠ and additional Rsyslog⁠ packages
• Rsyslog 5.8.x (debian7 and centos6), built on Stafli Init Supervisor⁠ and additional Rsyslog⁠ packages

⁠Images

These are the resulting images⁠ upon building:

• Stable:
  • stafli/stafli.log.rsyslog:rsyslog84_debian8
  • stafli/stafli.log.rsyslog:rsyslog824_centos7
• Old Stable:
  • stafli/stafli.log.rsyslog:rsyslog58_debian7
  • stafli/stafli.log.rsyslog:rsyslog58_centos6

⁠Containers

These containers can be created from the images:

• Stable:
  • stafli_log_rsyslog84_debian8_xxx
  • stafli_log_rsyslog824_centos7_xxx
• Old Stable:
  • stafli_log_rsyslog58_debian7_xxx
  • stafli_log_rsyslog58_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.log.rsyslog:rsyslog84_debian8

docker run -ti stafli/stafli.log.rsyslog:rsyslog84_debian8 /bin/bash

⁠From GitHub repository (automated)

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

1. Download the repository zip file⁠ and unpack it or clone the repository using:
   git clone https://github.com/stafli-org/stafli.log.rsyslog.git
2. Navigate to the project directory through the terminal:
   cd stafli.log.rsyslog
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.log.rsyslog.git;
cd stafli.log.rsyslog;

# 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 Rsyslog Log 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/⁠.