Stafli Redis Cache System

Stafli Redis Cache System builds based on Debian and CentOS, and developed as scripts for Docker.
Continues on Stafli Supervisor Init 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:

• Redis 3.2.x, built on Stafli Supervisor Init and additional Redis packages

Images

These are the resulting images upon building:

• Stable:
  • stafli/stafli.cache.redis:redis32_debian8
  • stafli/stafli.cache.redis:redis32_centos7
• Old Stable:
  • stafli/stafli.cache.redis:redis32_debian7
  • stafli/stafli.cache.redis:redis32_centos6

Containers

These containers can be created from the images:

• Stable:
  • stafli_cache_redis32_debian8_xxx
  • stafli_cache_redis32_centos7_xxx
• Old Stable:
  • stafli_cache_redis32_debian7_xxx
  • stafli_cache_redis32_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 is the full image url (lookup the image list above).

Example:

docker pull stafli/stafli.cache.redis:redis32_debian8
docker run -ti stafli/stafli.cache.redis:redis32_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.cache.redis.git
2. Navigate to the project directory through the terminal:
   cd stafli.cache.redis
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.cache.redis.git;
cd stafli.cache.redis;
# 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 vol-create 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 Redis Cache System
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.