There are a number of system limits you can run into (and work around) but there’s a significant amount of grey area depending on
- How you are configuring your docker containers.
- What you are running in your containers.
- What kernel, distribution and docker version you are on.
The figures below are from the boot2docker 1.11.1 vm image which is based on Tiny Core Linux 7. The kernel is 4.4.8
Docker
Docker creates or uses a number of resources to run a container, on top of what you run inside the container.
- Attaches a virtual ethernet adaptor to the
docker0
bridge (1023 max per bridge) - Mounts an AUFS and
shm
file system (1048576 mounts max per fs type) - Create’s an AUFS layer on top of the image (127 layers max)
- Forks 1 extra
docker-containerd-shim
management process (~3MB per container on avg andsysctl kernel.pid_max
) - Docker API/daemon internal data to manage container. (~400k per container)
- Creates kernel
cgroup
s and name spaces - Opens file descriptors (~15 + 1 per running container at startup.
ulimit -n
andsysctl fs.file-max
)
Docker options
- Port mapping
-p
will run a extra process per port number on the host (~4.5MB per port on avg pre 1.12, ~300k per port > 1.12 and alsosysctl kernel.pid_max
) --net=none
and--net=host
would remove the networking overheads.
Container services
The overall limits will normally be decided by what you run inside the containers rather than dockers overhead (unless you are doing something esoteric, like testing how many containers you can run 🙂
If you are running apps in a virtual machine (node,ruby,python,java) memory usage is likely to become your main issue.
IO across a 1000 processes would cause a lot of IO contention.
1000 processes trying to run at the same time would cause a lot of context switching (see vm apps above for garbage collection)
If you create network connections from a 1000 containers the hosts network layer will get a workout.
It’s not much different to tuning a linux host to run a 1000 processes, just some additional Docker overheads to include.
Example
1023 Docker busybox images running nc -l -p 80 -e echo host
uses up about 1GB of kernel memory and 3.5GB of system memory.
1023 plain nc -l -p 80 -e echo host
processes running on a host uses about 75MB of kernel memory and 125MB of system memory
Starting 1023 containers serially took ~8 minutes.
Killing 1023 containers serially took ~6 minutes