Docker: Difference between revisions

From Alpine Linux
m (Contaminating text with a double might.)
m (make addgroup command copy and pastable)
 
(30 intermediate revisions by 17 users not shown)
Line 1: Line 1:
Alpine makes a great docker container, because it is so small and optimized to be run in RAM.
It also might make a good controller for several docker containers with enough RAM.  I haven't tested this yet
Docker's setup is easy to use from command line.  Commands can be run from an interactive shell, or through a configuration file called a "Dockerfile".
docker.com has excellent walk-throughs on how to run, pull, setup a container, commit an image, and create a configuration file.  hub.docker.com is a freemium setup, where the first private repository is free.
== Installation ==
== Installation ==
Run <code>apk add docker</code> to install Docker on Alpine Linux.
The Docker package is in the 'Community' repository, so if the '''apk add''' fails with '''unsatisfiable constraints''', you need to edit the '''/etc/apk/repositories''' file to add (or uncomment) a line like:
<code>http://dl-cdn.alpinelinux.org/alpine/latest-stable/community</code>


then run <code>apk update</code> to index the repository.
The {{Pkg|docker}} package is in the ''community'' repository. See [[Repositories]] how to add a repository.


apk add docker


'''To start the Docker daemon at boot, run:'''
Connecting to the Docker daemon through its socket requires you to add yourself to the <code>docker</code> group.


<code>rc-update add docker boot</code>
addgroup ${USER} docker


To start the Docker daemon at boot, see [[OpenRC]].


'''Then to start the Docker daemon manually, run:'''
rc-update add docker default
service docker start


<code>service docker start</code>
=== Docker rootless ===


Docker rootless allows unprivileged users to run the docker daemon and docker containers in user namespaces. This is not the same as dockremap explained in the section below. With dockremap the daemon still runs as root.


{{Note|On older version of Alpine Linux with older version of docker you'll also need to disable some kernel security flags in order to build images:}}
This requires the {{Pkg|docker-rootless-extras}} package (available in ''community'') and enabling <code>cgroups v2</code>:
edit <code>/etc/rc.conf</code> and set <code>rc_cgroup_mode="unified"</code>. Then start the service on boot:


<code>sysctl -w kernel.grsecurity.chroot_deny_chmod=0</code>
rc-update add cgroups


<code>sysctl -w kernel.grsecurity.chroot_deny_mknod=0</code>
Additionally, the <code>/etc/subuid</code> and <code>/etc/subgid</code> files need to be set up as explained in [https://docs.docker.com/engine/security/rootless/ the official documentation].
 
For more information, have a look at the [https://github.com/docker/docker/issues/20303 corresponding Github issue].
 
Anyway, this weakening of security is not necessary to do with Alpine 3.4.x and Docker 1.12 as of August 2016 anymore.


=== Docker Compose ===
=== Docker Compose ===


'''To install docker-compose, first install pip:'''
{{Pkg|docker-cli-compose}} is in the ''community'' repository starting with Alpine Linux 3.15.


<code>apk add py-pip</code>
apk add docker-cli-compose
 
 
'''Since docker-compose version 1.24.0, you also need some dev dependencies:'''
 
<code>apk add python-dev libffi-dev openssl-dev gcc libc-dev make</code>
 
 
'''Then install docker-compose, run:'''
 
<code>pip install docker-compose</code>


== Isolate containers with a user namespace ==
== Isolate containers with a user namespace ==
Line 59: Line 39:
</pre>
</pre>


and add in '''/etc/docker/daemon.json'''
add to <code>/etc/docker/daemon.json</code>


<pre>
<pre>
Line 67: Line 47:
</pre>
</pre>


''You may also consider these options : '''
''You may also consider these options : ''
         "experimental": false,
         "experimental": false,
         "live-restore": true,
         "live-restore": true,
Line 74: Line 54:
         "no-new-privileges": false'''''
         "no-new-privileges": false'''''


You will find all possible configurations here[https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file].
You'll find all possible configurations [https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file here].


== Example: How to install docker from Arch ==
== Example: How to install docker from Arch ==
Line 82: Line 62:
== "WARNING: No {swap,memory} limit support" ==
== "WARNING: No {swap,memory} limit support" ==


You may, probably, encounter this message by executing <code>docker info</code>.
You might encounter this message when executing <code>docker info</code>.
To correct this situation we have to enable the <code>cgroup_enable=memory swapaccount=1</code>
To correct this situation, we have to enable the <code>cgroup_enable=memory swapaccount=1</code>


==== Alpine 3.8 ====
==== Alpine 3.8 ====
Well I'm not sure it was'nt the case before but for sure with Alpine 3.8 you must config cgroups properly
It may not have been the case before, but with Alpine 3.8, you must configure cgroups properly


'''''Warning''''': This seems ''not'' to work with Alpine 3.9 and Docker 18.06. Follow the instructions for grub or extlinux below instead.
{{Warning|This seems ''not'' to work with Alpine 3.9 and Docker 18.06. Follow the instructions for grub or extlinux below instead.}}


<pre>echo "cgroup /sys/fs/cgroup cgroup defaults 0 0" >> /etc/fstab</pre>
<pre>echo "cgroup /sys/fs/cgroup cgroup defaults 0 0" >> /etc/fstab</pre>
Line 107: Line 87:


=== Grub ===
=== Grub ===
Well; if you use Grub it is like any other linux and you just have to add the cgroup condition into <code>/etc/default/grub</code> than upgrade your grub
If you use Grub, add the cgroup condition into <code>/etc/default/grub</code>, then upgrade your grub
 
<pre>GRUB_CMDLINE_LINUX_DEFAULT="... e=memory swapaccount=1"</pre>


<pre>GRUB_CMDLINE_LINUX_DEFAULT="... cgroup_enable=memory swapaccount=1"</pre>


=== Extlinux ===
=== Extlinux ===
With Extlinux you also add the cgroup condition but inside <code>/etc/update-extlinux.conf</code>
With Extlinux, you add the cgroup condition, but inside of <code>/etc/update-extlinux.conf</code>


<pre>default_kernel_opts="... cgroup_enable=memory swapaccount=1"</pre>
<pre>default_kernel_opts="... cgroup_enable=memory swapaccount=1"</pre>


than update the config and reboot
then update the config and reboot


<code>update-extlinux</code>
<code>update-extlinux</code>


== '''How to use docker''' ==
== How to use docker ==
 
The best documentation for how to use Docker and create containers is at the main docker site.  Adding anything more to it here would be redundant.


'''http://docs.docker.com/'''
Check the [https://docs.docker.com/ official documentation] for details on general usage of docker, including creating and management of containers. Repeating these instructions here be redundant.


if you create an account at docker.com you can browse through other user's images and learn from the syntax in contributor's dockerfiles.
Public images can be browsed at the [https://hub.docker.com/ Docker Hub]. These should also serve as further reference on the Dockerfile format.


Official Docker image files are denoted by a blue ribon on the website.
Official Docker image files are denoted on the website by a special badge.


== See also ==
== See also ==
* [https://www.erianna.com/creating-a-alpine-linux-repository/ Creating & Hosting an Alpine Linux Package Repository for Docker Packages]
* [https://www.erianna.com/creating-a-alpine-linux-repository/ Creating and Hosting an Alpine Linux Package Repository for Docker Packages]
* [[Running Alpine in a Docker Container]]
* [[Running Alpine in a Docker Container]]


[[Category:Virtualization]]
[[Category:Virtualization]]

Latest revision as of 23:44, 28 August 2024

Installation

The docker package is in the community repository. See Repositories how to add a repository.

apk add docker

Connecting to the Docker daemon through its socket requires you to add yourself to the docker group.

addgroup ${USER} docker

To start the Docker daemon at boot, see OpenRC.

rc-update add docker default
service docker start

Docker rootless

Docker rootless allows unprivileged users to run the docker daemon and docker containers in user namespaces. This is not the same as dockremap explained in the section below. With dockremap the daemon still runs as root.

This requires the docker-rootless-extras package (available in community) and enabling cgroups v2: edit /etc/rc.conf and set rc_cgroup_mode="unified". Then start the service on boot:

rc-update add cgroups

Additionally, the /etc/subuid and /etc/subgid files need to be set up as explained in the official documentation.

Docker Compose

docker-cli-compose is in the community repository starting with Alpine Linux 3.15.

apk add docker-cli-compose

Isolate containers with a user namespace

adduser -SDHs /sbin/nologin dockremap
addgroup -S dockremap
echo dockremap:$(cat /etc/passwd|grep dockremap|cut -d: -f3):65536 >> /etc/subuid
echo dockremap:$(cat /etc/passwd|grep dockremap|cut -d: -f4):65536 >> /etc/subgid

add to /etc/docker/daemon.json

{  
        "userns-remap": "dockremap"
}

You may also consider these options :

       "experimental": false,
       "live-restore": true,
       "ipv6": false,
       "icc": false,
       "no-new-privileges": false

You'll find all possible configurations here.

Example: How to install docker from Arch

https://wiki.archlinux.org/index.php/Docker

"WARNING: No {swap,memory} limit support"

You might encounter this message when executing docker info. To correct this situation, we have to enable the cgroup_enable=memory swapaccount=1

Alpine 3.8

It may not have been the case before, but with Alpine 3.8, you must configure cgroups properly

Warning: This seems not to work with Alpine 3.9 and Docker 18.06. Follow the instructions for grub or extlinux below instead.


echo "cgroup /sys/fs/cgroup cgroup defaults 0 0" >> /etc/fstab
cat >> /etc/cgconfig.conf <<EOF
mount {
cpuacct = /cgroup/cpuacct;
memory = /cgroup/memory;
devices = /cgroup/devices;
freezer = /cgroup/freezer;
net_cls = /cgroup/net_cls;
blkio = /cgroup/blkio;
cpuset = /cgroup/cpuset;
cpu = /cgroup/cpu;
}
EOF

Grub

If you use Grub, add the cgroup condition into /etc/default/grub, then upgrade your grub

GRUB_CMDLINE_LINUX_DEFAULT="... cgroup_enable=memory swapaccount=1"

Extlinux

With Extlinux, you add the cgroup condition, but inside of /etc/update-extlinux.conf

default_kernel_opts="... cgroup_enable=memory swapaccount=1"

then update the config and reboot

update-extlinux

How to use docker

Check the official documentation for details on general usage of docker, including creating and management of containers. Repeating these instructions here be redundant.

Public images can be browsed at the Docker Hub. These should also serve as further reference on the Dockerfile format.

Official Docker image files are denoted on the website by a special badge.

See also