stafli/stafli.system.minimal repository overview

⁠Stafli Minimal System

Stafli Minimal System builds are based on Debian⁠ and CentOS⁠, and developed as scripts for Docker⁠.
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 the official images as a starting point for the following distributions:

• Debian, from the official repository⁠
  • Debian 9 (stretch)⁠
  • Debian 8 (jessie)⁠
  • Debian 7 (wheezy)⁠
• CentOS, from the official repository⁠
  • CentOS 7 (centos7)⁠
  • CentOS 6 (centos6)⁠
  • CentOS 5 (centos5)⁠
• Ubuntu LTS, from the official repository⁠
  • Ubuntu 16.04 (xenial)⁠
  • Ubuntu 14.04 (trusty)⁠
  • Ubuntu 12.04 (precise)⁠
• Alpine, from the official repository⁠
  • Alpine 3.7 (alpine37)⁠
  • Alpine 3.6 (alpine36)⁠
  • Alpine 3.5 (alpine35)⁠
  • Alpine 3.4 (alpine34)⁠

⁠Services

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

• Minimal 1.0.x, built on Upstream distros with pre-installed useful packages, configured locales and timezones

⁠Images

These are the resulting images⁠ upon building:

• Stable:
  • stafli/stafli.system.minimal:minimal10_debian9
  • stafli/stafli.system.minimal:minimal10_centos7
  • stafli/stafli.system.minimal:minimal10_ubuntu16
  • stafli/stafli.system.minimal:minimal10_alpine37
• Old Stable:
  • stafli/stafli.system.minimal:minimal10_debian8
  • stafli/stafli.system.minimal:minimal10_centos6
  • stafli/stafli.system.minimal:minimal10_ubuntu14
  • stafli/stafli.system.minimal:minimal10_alpine36
• Old Old Stable:
  • stafli/stafli.system.minimal:minimal10_debian7
  • stafli/stafli.system.minimal:minimal10_centos5
  • stafli/stafli.system.minimal:minimal10_ubuntu12
  • stafli/stafli.system.minimal:minimal10_alpine35
  • stafli/stafli.system.minimal:minimal10_alpine34

⁠Containers

These containers can be created from the images:

• Stable:
  • stafli_system_minimal10_debian9_xxx
  • stafli_system_minimal10_centos7_xxx
  • stafli_system_minimal10_ubuntu16_xxx
  • stafli_system_minimal10_alpine37_xxx
• Old Stable:
  • stafli_system_minimal10_debian8_xxx
  • stafli_system_minimal10_centos6_xxx
  • stafli_system_minimal10_ubuntu14_xxx
  • stafli_system_minimal10_alpine36_xxx
• Old Old Stable:
  • stafli_system_minimal10_debian7_xxx
  • stafli_system_minimal10_centos5_xxx
  • stafli_system_minimal10_ubuntu12_xxx
  • stafli_system_minimal10_alpine35_xxx
  • stafli_system_minimal10_alpine34_xxx

⁠Usage

⁠From Docker Hub repository (manual)

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

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.system.minimal:minimal10_debian8

docker run -ti stafli/stafli.system.minimal:minimal10_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.system.minimal.git
2. Navigate to the project directory through the terminal:
   cd stafli.system.minimal
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.system.minimal.git;
cd stafli.system.minimal;

# 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 Minimal System
Copyright (C) 2016-2017 Stafli
Luís Pedro Algarvio
This project 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/⁠.