npalm/docker-discovery-agent

!https://img.shields.io/badge/project-unmaintained-red.svg

Docker暴露端口发现代理

这是一个用Go编写的简单代理，提供极简的REST API，让容器能够查找其容器端口对应的暴露端口。该代理是针对Docker官方问题（https://github.com/docker/docker/issues/3778%EF%BC%89%E7%9A%84%E4%B8%B4%E6%97%B6%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82

使用方法

启动代理：

bash
docker run -p 5555:8080 -v /var/run/docker.sock:/var/run/docker.sock \
  --name docker-discovery-agent docker.xuanyuan.run/npalm/docker-discovery-agent

测试代理：

bash
export DOCKERHOST=$(ifconfig | grep -E "([0-9]{1,3}\.){3}[0-9]{1,3}" | \
  grep -v 127.0.0.1 | awk '{ print $2 }' | cut -f2 -d: | head -n1)
docker run -it -p 80 --add-host="dockerhost:$(DOCKERHOST)" --rm docker.xuanyuan.run/centos /bin/bash

进入容器shell后，查询暴露端口：

bash
# 获取容器ID
CONTAINER_ID=$(cat /proc/self/cgroup | grep "cpu:/" | sed 's/\([0-9]\):cpu:\/docker\///g')

# 查询端口80的TCP暴露端口
curl "http://dockerhost:5555/container/${CONTAINER_ID}/portbinding?port=80&protocol=tcp"

响应示例：

json
[{"HostIp":"0.0.0.0","HostPort":"12345"}]

REST API

仅实现了极简的API接口。

健康检查

服务运行时，健康检查应返回200状态码：

资源：<host:port>
响应：200 OK

端口绑定查询

资源：<host:port>/container/{id}/portbinding?port={port}&protocol={protocol}
响应：JSON格式的容器暴露端口信息，结构如下：
{
  "HostIp": "",
  "HostPort": ""
}