mirror of
https://github.com/pschiffe/docker-pdns.git
synced 2024-11-13 03:47:56 +01:00
Update readme, add new badges
This commit is contained in:
Peter Schiffer
parent
2422110d64
commit
203f36e743
1 changed files with 40 additions and 30 deletions
70
README.md
70
README.md
|
|
@ -1,11 +1,15 @@
|
|||
# PowerDNS Docker Images
|
||||
|
||||
This repository contains five Docker images - pdns-mysql, pdns-admin-static, pdns-admin-uwsgi, pdns-recursor and deprecated pdns-admin. Image **pdns-mysql** contains completely configurable [PowerDNS 4.x server](https://www.powerdns.com/) with mysql backend (without mysql server). Image **pdns-recursor** contains completely configurable [PowerDNS 4.x recursor](https://www.powerdns.com/). Images **pdns-admin-static** and **pdns-admin-uwsgi** contains fronted (nginx) and backend (uWSGI) for [PowerDNS Admin](https://git.0x97.io/0x97/powerdns-admin) web app, written in Flask, for managing PowerDNS servers. Pdns-admin is also completely configurable. Deprecated **pdns-admin** contains PowerDNS Admin in a single image where both nginx and uWSGI processes are managed by systemd. This image won't be updated anymore.
|
||||
This repository contains five Docker images - pdns-mysql, pdns-recursor, pdns-admin-static, pdns-admin-uwsgi and deprecated pdns-admin. Image **pdns-mysql** contains completely configurable [PowerDNS 4.x server](https://www.powerdns.com/) with mysql backend (without mysql server). Image **pdns-recursor** contains completely configurable [PowerDNS 4.x recursor](https://www.powerdns.com/). Images **pdns-admin-static** and **pdns-admin-uwsgi** contains fronted (nginx) and backend (uWSGI) for [PowerDNS Admin](https://git.0x97.io/0x97/powerdns-admin) web app, written in Flask, for managing PowerDNS servers. Pdns-admin is also completely configurable. Deprecated **pdns-admin** contains PowerDNS Admin in a single image where both nginx and uWSGI processes are managed by systemd. This image won't be updated anymore.
|
||||
|
||||
Most of the images (except *pdns-admin-static* based on `nginx` image) have now also the `alpine` tag thanks to the @PoppyPop .
|
||||
|
||||
All images are available on Docker Hub:
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-mysql/
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-recursor/
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-admin-uwsgi/
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-admin-static/
|
||||
|
|
@ -14,7 +18,9 @@ https://hub.docker.com/r/pschiffe/pdns-admin/
|
|||
|
||||
## pdns-mysql
|
||||
|
||||
[](http://microbadger.com/images/pschiffe/pdns-mysql "Get your own image badge on microbadger.com")
|
||||
[](https://microbadger.com/images/pschiffe/pdns-mysql "Get your own version badge on microbadger.com") [](http://microbadger.com/images/pschiffe/pdns-mysql "Get your own image badge on microbadger.com")
|
||||
|
||||
[](https://microbadger.com/images/pschiffe/pdns-mysql:alpine "Get your own version badge on microbadger.com") [](https://microbadger.com/images/pschiffe/pdns-mysql:alpine "Get your own image badge on microbadger.com")
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-mysql/
|
||||
|
||||
|
|
@ -34,6 +40,8 @@ PowerDNS server is configurable via env vars. Every variable starting with `PDNS
|
|||
|
||||
There is also a `SUPERMASTER_IPS` env var supported, which can be used to configure supermasters for slave dns server. [Docs](https://doc.powerdns.com/md/authoritative/modes-of-operation/#supermaster-automatic-provisioning-of-slaves). Multiple ip addresses separated by space should work.
|
||||
|
||||
You can find [here](https://doc.powerdns.com/md/authoritative/) all available settings.
|
||||
|
||||
### Examples
|
||||
|
||||
Master server with API enabled and with one slave server configured:
|
||||
|
|
@ -69,9 +77,36 @@ docker run -d -p 53:53 -p 53:53/udp --name pdns-slave \
|
|||
pschiffe/pdns-mysql
|
||||
```
|
||||
|
||||
## pdns-recursor
|
||||
|
||||
[](https://microbadger.com/images/pschiffe/pdns-recursor "Get your own version badge on microbadger.com") [](https://microbadger.com/images/pschiffe/pdns-recursor "Get your own image badge on microbadger.com")
|
||||
|
||||
[](https://microbadger.com/images/pschiffe/pdns-recursor:alpine "Get your own version badge on microbadger.com") [](https://microbadger.com/images/pschiffe/pdns-recursor:alpine "Get your own image badge on microbadger.com")
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-recursor/
|
||||
|
||||
Docker image with [PowerDNS 4.x recursor](https://www.powerdns.com/).
|
||||
|
||||
PowerDNS recursor is configurable via env vars. Every variable starting with `PDNS_` will be inserted into `/etc/pdns/recursor.conf` conf file in the following way: prefix `PDNS_` will be stripped and every `_` will be replaced with `-`. For example, from above mysql config, `PDNS_gmysql_host=mysql` will became `gmysql-host=mysql` in `/etc/pdns/recursor.conf` file. This way, you can configure PowerDNS recursor any way you need within a `docker run` command.
|
||||
|
||||
You can find [here](https://doc.powerdns.com/md/recursor/settings/) all available settings.
|
||||
|
||||
### Examples
|
||||
|
||||
Recursor server with API enabled:
|
||||
```
|
||||
docker run -d -p 53:53 -p 53:53/udp --name pdns-recursor \
|
||||
-e PDNS_api=yes \
|
||||
-e PDNS_api_key=secret \
|
||||
-e PDNS_webserver=yes \
|
||||
-e PDNS_webserver_address=0.0.0.0 \
|
||||
-e PDNS_webserver_password=secret2 \
|
||||
pschiffe/pdns-recursor
|
||||
```
|
||||
|
||||
## pdns-admin-uwsgi
|
||||
|
||||
[](https://microbadger.com/images/pschiffe/pdns-admin-uwsgi "Get your own image badge on microbadger.com")
|
||||
[](https://microbadger.com/images/pschiffe/pdns-admin-uwsgi "Get your own version badge on microbadger.com") [](https://microbadger.com/images/pschiffe/pdns-admin-uwsgi "Get your own image badge on microbadger.com")
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-admin-uwsgi/
|
||||
|
||||
|
|
@ -132,7 +167,7 @@ docker run -d --name pdns-admin-uwsgi \
|
|||
|
||||
## pdns-admin-static
|
||||
|
||||
[](https://microbadger.com/images/pschiffe/pdns-admin-static "Get your own image badge on microbadger.com")
|
||||
[](https://microbadger.com/images/pschiffe/pdns-admin-static "Get your own version badge on microbadger.com") [](https://microbadger.com/images/pschiffe/pdns-admin-static "Get your own image badge on microbadger.com")
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-admin-static/
|
||||
|
||||
|
|
@ -146,34 +181,9 @@ docker run -d -p 8080:80 --name pdns-admin-static \
|
|||
pschiffe/pdns-admin-static
|
||||
```
|
||||
|
||||
## pdns-recursor
|
||||
|
||||
[](http://microbadger.com/images/pschiffe/pdns-recursor "Get your own image badge on microbadger.com")
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-recursor/
|
||||
|
||||
Docker image with [PowerDNS 4.x recursor](https://www.powerdns.com/).
|
||||
|
||||
PowerDNS recursor is configurable via env vars. Every variable starting with `PDNS_` will be inserted into `/etc/pdns/recursor.conf` conf file in the following way: prefix `PDNS_` will be stripped and every `_` will be replaced with `-`. For example, from above mysql config, `PDNS_gmysql_host=mysql` will became `gmysql-host=mysql` in `/etc/pdns/recursor.conf` file. This way, you can configure PowerDNS recursor any way you need within a `docker run` command.
|
||||
|
||||
You can find [here](https://doc.powerdns.com/md/recursor/settings/) all available settings.
|
||||
|
||||
### Examples
|
||||
|
||||
Recursor server with API enabled:
|
||||
```
|
||||
docker run -d -p 53:53 -p 53:53/udp --name pdns-recursor \
|
||||
-e PDNS_api=yes \
|
||||
-e PDNS_api_key=secret \
|
||||
-e PDNS_webserver=yes \
|
||||
-e PDNS_webserver_address=0.0.0.0 \
|
||||
-e PDNS_webserver_password=secret2 \
|
||||
pschiffe/pdns-recursor
|
||||
```
|
||||
|
||||
## pdns-admin - DEPRECATED
|
||||
|
||||
[](http://microbadger.com/images/pschiffe/pdns-admin "Get your own image badge on microbadger.com")
|
||||
[](https://microbadger.com/images/pschiffe/pdns-admin "Get your own version badge on microbadger.com") [](http://microbadger.com/images/pschiffe/pdns-admin "Get your own image badge on microbadger.com")
|
||||
|
||||
https://hub.docker.com/r/pschiffe/pdns-admin/
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue