nss-docker - nss module for finding Docker containers
Contents
Bugs
If you find the bug or want to implement new features, please report it at
<https://github.com/dex4er/nss-docker/issues>
Copying
nss-docker is distributed under the GNU Lesser General Public License (LGPL 2.1 or greater).
nss-docker 20 Oct 2015 NSS-DOCKER(8)
Description
This is a plugin for the GNU Name Service Switch (NSS) functionality of the GNU C Library (glibc)
providing mechanism for finding Docker containers by theirs IDs.
The container names are searched in virtual domain name ".docker".
The Docker API webservice has to be available as /var/run/docker.sock socket for current user. Usually it
requires to add the user to "docker" system group.
To activate this NSS module, the "docker" module has to be added to /etc/nsswitch.conf file in "hosts:"
line.
It is recommended to put the "docker" module after "files" module and before "dns" module.
"[NOTFOUND=return]" setting is recommended before "dns" module to prevent using DNS as fallback if the
container ID is not found.
Example
/etc/nsswitch.conf
hosts: files docker [NOTFOUND=return] dns
Limitations
The container ID can't be longer than "getconf HOST_NAME_MAX" (64 for Linux).
The container ID are case sensitive. It means that "test.docker" and "Test.docker" can return different
IP addresses.
Only IPv4 addresses are supported.
Name
nss-docker - nss module for finding Docker containers
See Also
docker(1), nsswitch.conf(5)
Synopsis
libnss_docker.so.2
