Public | Automated Build

Last pushed: 2 months ago
Short Description
General-purpose system distros based on Debian and CentOS, developed as scripts for Docker
Full Description

Docker General Purpose System Distro

General-purpose system distro builds based on Debian and CentOS, and developed as scripts for Docker.

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 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:

Services

These are the services described by the dockerfile and dockercompose files:

  • Minimal, built with common software
  • Standard, built on Minimal service and included daemon packages
  • Devel, built on Standard service and additional development packages

Images

These are the resulting images upon building:

  • Minimal service:
    • solict/general-purpose-system-distro:debian8_minimal
    • solict/general-purpose-system-distro:debian7_minimal
    • solict/general-purpose-system-distro:centos7_minimal
    • solict/general-purpose-system-distro:centos6_minimal
  • Standard service:
    • solict/general-purpose-system-distro:debian8_standard
    • solict/general-purpose-system-distro:debian7_standard
    • solict/general-purpose-system-distro:centos7_standard
    • solict/general-purpose-system-distro:centos6_standard
  • Devel service:
    • solict/general-purpose-system-distro:debian8_devel
    • solict/general-purpose-system-distro:debian7_devel
    • solict/general-purpose-system-distro:centos7_devel
    • solict/general-purpose-system-distro:centos6_devel

Containers

These containers can be created from the images:

  • Minimal service:
    • debian8_minimal_xxx
    • debian7_minimal_xxx
    • centos7_minimal_xxx
    • centos6_minimal_xxx
  • Standard service:
    • debian8_standard_xxx
    • debian7_standard_xxx
    • centos7_standard_xxx
    • centos6_standard_xxx
  • Devel service:
    • debian8_devel_xxx
    • debian7_devel_xxx
    • centos7_devel_xxx
    • centos6_devel_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 solict/general-purpose-system-distro:debian8_minimal

docker run -ti solict/general-purpose-system-distro:debian8_minimal /bin/bash

From GitHub repository (automated)

  1. Download the repository zip file and unpack it or clone the repository using:
    git clone https://github.com/solict/docker-general-purpose-system-distro.git
  2. Navigate to the project directory through the terminal:
    cd docker-general-purpose-system-distro
  3. Type in the desired operation through the terminal:
    make <operation> DISTRO=<distro>

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

Example:

git clone https://github.com/solict/docker-general-purpose-system-distro.git
cd docker-general-purpose-system-distro
make build DISTRO=debian8
make netup DISTRO=debian8
make create DISTRO=debian8
make start DISTRO=debian8
make ps DISTRO=debian8
make stop DISTRO=debian8
make rm DISTRO=debian8
make netdown DISTRO=debian8

Credits

Docker General Purpose System Distro
Copyright (C) 2016 SOL-ICT
Luís Pedro Algarvio

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/.

Docker Pull Command
Owner
solict