dockage/confd

By dockage

Updated about 5 years ago

Docker confd, built on Alpine Linux. confd is a lightweight configuration management tool.

Image
Integration & Delivery
Networking

10K+

confd Docker PullsDocker StarsDocker Build StatusDocker Automated build

confd is a lightweight configuration management tool focused on:

  • keeping local configuration files up-to-date using data stored in etcd, consul, dynamodb, redis, vault, zookeeper, aws ssm parameter store or env vars and processing template resources.
  • reloading applications to pick up new config file changes
VersionsSizeLayerDockerfile
alpine3.5MicroBadger Size (alpine3.5)MicroBadger Layers (alpine3.5)alpine/3.5/Dockerfile
alpine3.6MicroBadger Size (alpine3.6)MicroBadger Layers (alpine3.6)alpine/3.6/Dockerfile
alpine3.7MicroBadger Size (alpine3.7)MicroBadger Layers (alpine3.7)alpine/3.7/Dockerfile
alpine3.8MicroBadger Size (alpine3.8)MicroBadger Layers (alpine3.8)alpine/3.8/Dockerfile
alpine3.11, latestMicroBadger Size (alpine3.11)MicroBadger Layers (alpine3.11)alpine/3.11/Dockerfile

Contributing

If you find this image useful here's how you can help:

  • Send a pull request with your awesome features and bug fixes
  • Help users resolve their issues

Issues

Before reporting your issue please try updating Docker to the latest version and check if it resolves the issue. Refer to the Docker installation guide for instructions.

SELinux users should try disabling SELinux using the command setenforce 0 to see if it resolves the issue.

If the above recommendations do not help then report your issue along with the following information:

  • Output of the docker vers6 and docker info commands
  • The docker run command or docker-compose.yml used to start the image. Mask out the sensitive bits.
  • Please state if you are using Boot2Docker, VirtualBox, etc.

Getting started

Installation

Automated builds of the image are available on Dockerhub and is the recommended method of installation.

Note: Builds are also available on Quay.io

docker pull dockage/confd:latest

Alternatively you can build the image yourself.

docker build -t dockage/confd github.com/dockage/confd
Available Configuration Parameters

Please refer the docker run command options for the --env-file flag where you can specify all required environment variables in a single file. This will save you from writing a potentially long docker run command. Alternatively you can use docker-compose.

Below is the complete list of available options that can be used to customize your confd installation.

ParameterDescription
CONFD_BACKENDThe backend to use. Possible options: etcd, consul, dynamodb, redis, vault, zookeeper, ssm or env. Defaults to env.
CONFD_CLIENT_CAKEYSThe client CA key file. Defaults to ''.
CONFD_CLIENT_CERTThe client cert file. Defaults to ''.
CONFD_CLIENT_KEYThe client key file. Defaults to ''
CONFD_INTERVALThe backend polling interval in seconds. Defaults to 600.
CONFD_LOG_LEVELLevel which confd should log messages. Defaults to info.
CONFD_NODESList of backend nodes. E.g.: "http://127.0.0.1:4001", "http://127.0.0.1:4002". Defaults to ''.
CONFD_PREFIXThe string to prefix to keys. Defaults to /.
CONFD_SCHEMEThe backend URI scheme. E.g.: http or https. Defaults to http.
CONFD_SRV_DOMAINThe name of the resource record. Defaults to ''.
CONFD_SRV_RECORDThe SRV record to search for backends nodes. Defaults to ''.
CONFD_SYNC_ONLYsync without check_cmd and reload_cmd. Defaults to false.
CONFD_WATCHEnable watch support. Defaults to false.

Quick reference

Docker Pull Command

docker pull dockage/confd