Changes

Jump to navigation Jump to search

Docker design concept (view source)

Revision as of 14:26, 22 November 2022

9,336 bytes added ,  14:26, 22 November 2022
no edit summary
Line 1: Line 1:  
{{WIP box}}
 
{{WIP box}}
 +
{{Note box|Various configuration entries may be deprecated}}
 +
 
__TOC__
 
__TOC__
 
[[File:Docker_design_conceptv0.1.png]]
 
[[File:Docker_design_conceptv0.1.png]]
Line 9: Line 11:  
===Design principles===
 
===Design principles===
 
* This design concept only addresses demonized containers and not interactive containers.
 
* This design concept only addresses demonized containers and not interactive containers.
−
* Transparent user experience* No integration with Server Manager (Yet)
+
* This design only addresses containers that hold application(s) for end users. Not for sys admins.
 +
* Transparent 'Click to run' user experience
 +
* No integration with Server Manager (Yet).
 
* Full integration in SME Sever templating system and SME Server db databases
 
* Full integration in SME Sever templating system and SME Server db databases
 
* Pre-build images are not available yet
 
* Pre-build images are not available yet
 
* No build-in pre-checks regarding starting a container and server capacity
 
* No build-in pre-checks regarding starting a container and server capacity
 +
* The design is intended for a single SME Server host, not a cluster or a farm.
 
* May not effect or compromise default SME Server functionality, stability and security
 
* May not effect or compromise default SME Server functionality, stability and security
    +
 +
==Resources==
 +
Possible resources and tools that can be used:
 +
 +
===Eixo::Docker perl library===
 +
a CPAN perl library for managing images and containers
 +
http://search.cpan.org/~alambike/Eixo-Docker-1.103/lib/Eixo/Docker.pod
 +
 +
https://github.com/alambike/eixo-docker
 +
 +
The Eixo library interacts with Docker API via a TCP socket. By default Docker starts without a TCP socket attached, so we have to add it to the Docker service arguments in /etc/sysconfig/docker. The default port via which the Docker API communicates is 4243 but it can be any port. Below is an example /etc/sysconfig/docker file:
 +
# /etc/sysconfig/docker
 +
#
 +
# Other arguments to pass to the docker daemon process
 +
# These will be parsed by the sysv initscript and appended
 +
# to the arguments list passed to docker -d
 +
 +
other_args="-g /home/e-smith/files/docker -H 127.0.0.1:4243 -d"
    
==Options==
 
==Options==
Line 29: Line 52:     
===B. Docker options===
 
===B. Docker options===
 +
* TBA
 +
* Docker cluster?? (Multiple SME Servers load balancing docker containers)
       
===C. Image options===
 
===C. Image options===
 +
* Linked containers
 +
 +
To inspect an image and with what (networking) options it was constructed, one can inspect the image by:
 +
docker inspect [imagename]
       
==SME Databases==
 
==SME Databases==
 +
===Container options===
 +
Container options can be passed to the container at 'boot' time. These options can include the following aspects:
 +
* network (ports, port mapping)
 +
* 'cpu' (load)
 +
* memory allocated (size)
 +
* Storage (mount paths, both inside container and (remote) host)
 +
* Domain names (FQDN (sub)domains, Web server Aliases)
 +
* Links to other containers (container wordpress automatically starts container MySQL)
 +
 +
Unlike containers, images themselves do not carry this information, but only the exposed (open) ports.
 +
 +
Hence the usage of SME Server db system to store preferred options per container.
 +
 +
 +
Syntax:
 +
db docker_containers [name]
 +
Key:
 +
docker_containers [name]=service
 +
Types:
 +
{|class="wikitable"
 +
|-
 +
|status
 +
|enabled / disabled
 +
|-
 +
|TCPPort
 +
|n , n
 +
|-
 +
|UDPPort
 +
|n , n
 +
|-
 +
|PortMapping
 +
|native / custom
 +
|-
 +
|PortMappingPorts
 +
|n:n , n:n
 +
|-
 +
|access
 +
|private / public
 +
|-
 +
|network
 +
|bridge / host
 +
|-
 +
|MountPath
 +
|path , path
 +
|-
 +
|Interlinked
 +
|[alias]
 +
|-
 +
|InterLinkPriority
 +
|n
 +
|-
 +
|MaxMemory
 +
|n
 +
|-
 +
|SubDomain
 +
|enabled / disabled
 +
|-
 +
|SubDomainName
 +
|name
 +
|-
 +
|WebAlias
 +
|name
 +
|-
 +
|DataMount
 +
|container / host
 +
|-
 +
|DataMountWrite
 +
|yes / no
 +
|-
 +
|DataMountPath
 +
|path
 +
|}
 +
 +
 +
 +
===Image options===
 +
Syntax:
 +
db docker_images
 +
Key:
 +
docker_images [name]=service
       
==SME Template/fragments==
 
==SME Template/fragments==
 +
* TBA
       
==Start/Stop events==
 
==Start/Stop events==
 +
* Manual on console
 +
* Time based by cron
 +
* Triggered by an event
 +
 +
==Create a SME docker Base image==
 +
 +
WIP --[[User:Stephdl|Stephdl]] ([[User talk:Stephdl|talk]]) 15:56, 15 September 2014 (MDT)<br />
 +
 +
'''Install docker to your sme, be aware that you have to do it on a SME9 64 bit'''
 +
original script : https://github.com/docker/docker/blob/master/contrib/mkimage-yum.sh
 +
 +
Create your repository file and save it to /root/repo_file
 +
 +
#------------------------------------------------------------
 +
#       !!DO NOT MODIFY THIS FILE!!
 +
#
 +
# Manual changes will be lost when this file is regenerated.
 +
#
 +
# Please read the developer's guide, which is available
 +
# at http://www.contribs.org/development/
 +
#
 +
# Copyright (C) 1999-2006 Mitel Networks Corporation
 +
#------------------------------------------------------------
 +
 +
[base]
 +
enabled=1
 +
mirrorlist=http://mirrorlist.centos.org/?release=6&arch=x86_64&repo=os
 +
name=CentOS - os
 +
gpgcheck=0
 +
enablegroups=1
 +
exclude=initscripts libgsf
 +
 +
[centosplus]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=centosplus
 +
name=CentOS - centosplus
 +
gpgcheck=0
 +
enablegroups=0
 +
 +
[contrib]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=contrib
 +
name=CentOS - contrib
 +
gpgcheck=0
 +
enablegroups=0
 +
 +
[extras]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras
 +
name=CentOS - extras
 +
gpgcheck=0
 +
enablegroups=0
 +
 +
[fasttrack]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=fasttrack
 +
name=CentOS - fasttrack
 +
gpgcheck=0
 +
enablegroups=0
 +
 +
[smeaddons]
 +
enabled=1
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smeaddons-9
 +
name=SME Server - addons
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[smecontribs]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smecontribs-9
 +
name=SME Server - contribs
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[smedev]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smedev-9
 +
name=SME Server - dev
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[smeextras]
 +
enabled=1
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smeextras-9
 +
name=SME Server - extras
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[smeos]
 +
enabled=1
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smeos-9
 +
name=SME Server - os
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[smetest]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smetest-9
 +
name=SME Server - test
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[smeupdates]
 +
enabled=1
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smeupdates-9
 +
name=SME Server - updates
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[smeupdates-testing]
 +
enabled=0
 +
mirrorlist=http://mirrorlist.contribs.org/mirrorlist/smeupdates-testing-9
 +
name=SME Server - updates testing
 +
gpgcheck=0
 +
enablegroups=1
 +
 +
[updates]
 +
enabled=1
 +
mirrorlist=http://mirrorlist.centos.org/?release=6&arch=x86_64&repo=updates
 +
name=CentOS - updates
 +
gpgcheck=0
 +
enablegroups=1
 +
exclude=initscripts libgsf
 +
 +
 +
* first create a file and record the content
 +
 +
vim /root/docker_images
 +
 +
#!/usr/bin/env bash
 +
#
 +
# Create a base CentOS Docker image.
 +
#
 +
# This script is useful on systems with yum installed (e.g., building
 +
# a CentOS image on CentOS). See contrib/mkimage-rinse.sh for a way
 +
# to build CentOS images on other systems.
 +
usage() {
 +
cat <<EOOPTS
 +
$(basename $0) [OPTIONS] <name>
 +
OPTIONS:
 +
-y <yumconf> The path to the yum config to install packages from. The
 +
default is /etc/yum.conf.
 +
EOOPTS
 +
exit 1
 +
}
 +
# option defaults
 +
yum_config=/etc/yum.conf
 +
while getopts ":y:h" opt; do
 +
case $opt in
 +
y)
 +
yum_config=$OPTARG
 +
;;
 +
h)
 +
usage
 +
;;
 +
\?)
 +
echo "Invalid option: -$OPTARG"
 +
usage
 +
;;
 +
esac
 +
done
 +
shift $((OPTIND - 1))
 +
name=$1
 +
if [[ -z $name ]]; then
 +
usage
 +
fi
 +
#--------------------
 +
target=$(mktemp -d --tmpdir $(basename $0).XXXXXX)
 +
set -x
 +
mkdir -m 755 "$target"/dev
 +
mknod -m 600 "$target"/dev/console c 5 1
 +
mknod -m 600 "$target"/dev/initctl p
 +
mknod -m 666 "$target"/dev/full c 1 7
 +
mknod -m 666 "$target"/dev/null c 1 3
 +
mknod -m 666 "$target"/dev/ptmx c 5 2
 +
mknod -m 666 "$target"/dev/random c 1 8
 +
mknod -m 666 "$target"/dev/tty c 5 0
 +
mknod -m 666 "$target"/dev/tty0 c 4 0
 +
mknod -m 666 "$target"/dev/urandom c 1 9
 +
mknod -m 666 "$target"/dev/zero c 1 5
 +
#yum -c "$yum_config" --installroot="$target" --setopt=tsflags=nodocs \
 +
#--setopt=group_package_types=mandatory -y groupinstall Core
 +
 +
###here it is for testing purpose, you will build a pure centos base docker image (keep only one yum line of course)
 +
#yum -c "/root/repo_file" --installroot="$target" --setopt=tsflags=nodocs --setopt=group_package_types=mandatory -y groupinstall Core ###this line is to test and build a pure centos base in order to test
 +
###with the line below we take all from smeos, not really uptodate
 +
#yum -c "/root/repo_file" --installroot="$target" --setopt=tsflags=nodocs --setopt=group_package_types=mandatory -y install --disablerepo=* --enablerepo=smeos,smeextras e-smith\* smeserver\*
 +
###here we take rpm in the most uptodate version
 +
yum -c "/root/repo_file" --installroot="$target" --setopt=tsflags=nodocs --setopt=group_package_types=mandatory -y install e-smith\* smeserver\*
 +
 +
###a bit of clean
 +
yum -c "/root/repo_file" --installroot="$target" -y clean all
 +
 +
 +
 +
cat > "$target"/etc/sysconfig/network <<EOF
 +
NETWORKING=yes
 +
HOSTNAME=localhost.localdomain
 +
EOF
 +
 +
# effectively: febootstrap-minimize --keep-zoneinfo --keep-rpmdb
 +
# --keep-services "$target". Stolen from mkimage-rinse.sh
 +
# locales
 +
rm -rf "$target"/usr/{{lib,share}/locale,{lib,lib64}/gconv,bin/localedef,sbin/build-locale-archive}
 +
# docs
 +
rm -rf "$target"/usr/share/{man,doc,info,gnome/help}
 +
# cracklib
 +
rm -rf "$target"/usr/share/cracklib
 +
# i18n
 +
rm -rf "$target"/usr/share/i18n
 +
# sln
 +
rm -rf "$target"/sbin/sln
 +
# ldconfig
 +
rm -rf "$target"/etc/ld.so.cache
 +
rm -rf "$target"/var/cache/ldconfig/*
 +
 +
#version=
 +
 +
if [ -r "$target"/etc/redhat-release ]; then
 +
version="$(sed 's/^[^0-9\]*\([0-9.]\+\).*$/\1/' "$target"/etc/redhat-release)"
 +
fi
 +
 +
if [ -z "$version" ]; then
 +
echo >&2 "warning: cannot autodetect OS version, using '$name' as tag"
 +
version=$name
 +
fi
 +
 +
tar --numeric-owner -c -C "$target" . | docker import - $name:$version
 +
docker run -i -t $name:$version echo success
 +
rm -rf "$target"
 +
 +
 +
give the permissions to the file
 +
 +
chmod u+x /root/docker_images
 +
and launch the script
 +
/root/docker_images [name_of_your_image]
 +
you have to wait, the download depends of your bandwith, once done you could see 'success'
 +
 +
docker run -i -t sme9_real:6.5 echo success
 +
success
 +
 +
to launch your image
 +
 +
docker run -i -t  sme9_real:6.5 bash
 +
see
 +
docker images
 +
 +
after that you have an image but we need to reconfigure it
Retrieved from "https://wiki.koozali.org/Special:MobileDiff/25008...41802"

Navigation menu