https://github.com/psvmcc/disconter
Discovery docker containers service
https://github.com/psvmcc/disconter
container containers discovery discovery-service dns docker podman
Last synced: 7 months ago
JSON representation
Discovery docker containers service
- Host: GitHub
- URL: https://github.com/psvmcc/disconter
- Owner: psvmcc
- License: mit
- Created: 2024-03-06T20:07:50.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-04T08:44:39.000Z (9 months ago)
- Last Synced: 2025-01-29T10:16:57.646Z (9 months ago)
- Topics: container, containers, discovery, discovery-service, dns, docker, podman
- Language: Go
- Homepage:
- Size: 2.04 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# disconter - discovery containers(docker and podman)
## run
```
podman run --rm --net=host -v /run/podman/podman.sock:/var/run/docker.sock ghcr.io/psvmcc/disconter:latest
```
## how it works
```
Usage of /disconter:
-bind.dns string
Bind the DNS server (default "0.0.0.0:53535")
-bind.metrics string
Bind the HTTP metrics server (default "0.0.0.0:9553")
-debug
Enable debug logging
-docker.refresh.interval int
Container events refresh interval in milliseconds (default 100)
-docker.socket string
Docker(Podman) socket path (default "/var/run/docker.sock")
-metrics.go
Extend Golang metrics (default true)
-v Print version
```
### labels
- **disconter.service** - name of the service, if set then watching for events of this container
- **disconter.service.priority** - dns discovery priority, default 1
- **disconter.service.weight** - dns discovery weight, default 1
- **disconter.service.port** - dns discovery port, default 80
- **disconter.service.ttl** - dns discovery ttl in seconds, default 0
### run container with label `disconter.service`
```
podman run --rm -l disconter.service=test -ti centos bash
```
### dig
#### srv
```
$ dig @127.0.0.1 -p 53535 _test._tcp.service.disconter SRV
; <<>> DiG 9.18.24 <<>> @127.0.0.1 -p 53535 _test._tcp.service.disconter SRV
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 33492
;; flags: qr rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
;; WARNING: recursion requested but not available
;; QUESTION SECTION:
;_test._tcp.service.disconter. IN SRV
;; ANSWER SECTION:
_test._tcp.service.disconter. 0 IN SRV 1 1 80 nice_golick.container.disconter.
;; ADDITIONAL SECTION:
nice_golick.container.disconter. 0 IN A 10.88.0.5
;; Query time: 3 msec
;; SERVER: 127.0.0.1#53535(127.0.0.1) (UDP)
;; WHEN: Wed Mar 06 20:32:46 UTC 2024
;; MSG SIZE rcvd: 172
```
or
```
$ dig @127.0.0.1 -p 53535 test.service.disconter SRV
; <<>> DiG 9.18.24 <<>> @127.0.0.1 -p 53535 test.service.disconter SRV
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 22671
;; flags: qr rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
;; WARNING: recursion requested but not available
;; QUESTION SECTION:
;test.service.disconter. IN SRV
;; ANSWER SECTION:
test.service.disconter. 0 IN SRV 1 1 80 nice_golick.container.disconter.
;; ADDITIONAL SECTION:
nice_golick.container.disconter. 0 IN A 10.88.0.5
;; Query time: 0 msec
;; SERVER: 127.0.0.1#53535(127.0.0.1) (UDP)
;; WHEN: Wed Mar 06 20:33:54 UTC 2024
;; MSG SIZE rcvd: 160
```
#### a
```
$ dig @127.0.0.1 -p 53535 test.service.disconter A
; <<>> DiG 9.18.24 <<>> @127.0.0.1 -p 53535 test.service.disconter A
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 34103
;; flags: qr rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available
;; QUESTION SECTION:
;test.service.disconter. IN A
;; ANSWER SECTION:
test.service.disconter. 0 IN A 10.88.0.5
;; Query time: 3 msec
;; SERVER: 127.0.0.1#53535(127.0.0.1) (UDP)
;; WHEN: Wed Mar 06 20:34:34 UTC 2024
;; MSG SIZE rcvd: 78
```
or container by name `nice_golick`
```
$ dig @127.0.0.1 -p 53535 nice_golick.container.disconter A
; <<>> DiG 9.18.24 <<>> @127.0.0.1 -p 53535 nice_golick.container.disconter A
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 20492
;; flags: qr rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available
;; QUESTION SECTION:
;nice_golick.container.disconter. IN A
;; ANSWER SECTION:
nice_golick.container.disconter. 0 IN A 10.88.0.5
;; Query time: 0 msec
;; SERVER: 127.0.0.1#53535(127.0.0.1) (UDP)
;; WHEN: Wed Mar 06 20:35:50 UTC 2024
;; MSG SIZE rcvd: 96
```
### metrics
```
$ curl 127.0.0.1:9553/metrics -s |grep disco
disconter_dns_queries_total 7
disconter_dns_queries{type="A"} 3
disconter_dns_queries{type="SRV"} 4
disconter_info{version="v0.0.0",commit="7639f0cf6424a0d4be7a93ada21b78a0c33394fc"} 0
```