softonic/portainer-endpoint

已弃用

该项目不再维护，Portainer现已提供原生集成的官方Agent。 官方镜像：https://hub.docker.com/r/portainer/agent/ 官方文档：[***]

Portainer Endpoint

该镜像可自动将Swarm集群中的所有节点注册到同一集群和网络中的Portainer。

目标

在Docker Swarm模式下，Portainer能查看服务及其任务，但无法从任务中获取日志/SSH会话等；容器标签页仅能访问Portainer所连接主机上的容器。若需在集群其他节点的容器上使用该功能，需手动添加连接详情，这在节点动态增减的弹性集群中并非有效方案。本镜像可实现该过程自动化。

使用方法

需创建全局服务并传递一些选项和环境变量。借助Swarm模式的“全局服务”概念，可确保每个节点运行一个服务任务；集群新增节点时，Swarm会自动在新节点启动任务。

选项

• 网络：需将服务附加到Portainer所在的网络。
• 挂载：
  • 主机名文件：用于检测服务任务运行的主机名称。
  • Docker socket：允许Portainer访问该socket。

环境变量

• HOST_HOSTNAME：（可选）若需修改主机名文件的挂载路径。
• PORTAINER_ADDR：Portainer的名称和端口。
• PORTAINER_USER：Portainer登录用户名。
• PORTAINER_PASS：Portainer登录密码。
• SSL_IGNORE_CERTIFICATION_CHECK：若无需验证Portainer服务的证书则激活。
• SLEEP_IF_WORKER：若节点为worker，注册前等待的秒数（避免worker成为第一个注册的端点，导致集群概览无法直接显示）。

作为容器运行示例

仅注册当前节点，需确保portainer网络可附加：

bash
docker container run \
  --name portainer-endpoint \
  --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock \
  --mount type=bind,source=/etc/hostname,target=/etc/host_hostname \
  --network portainer \
  --hostname="{{.Node.Hostname}}" \
  -e PORTAINER_ADDR=portainer:9000 \
  -e PORTAINER_USER=admin \
  -e PORTAINER_PASS=12341234 \
  softonic/portainer-endpoint

作为全局服务运行示例

注册集群中所有节点：

bash
docker service create --with-registry-auth \
  --name portainer-endpoint \
  --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock \
  --mount type=bind,source=/etc/hostname,target=/etc/host_hostname \
  --hostname="{{.Node.Hostname}}" \
  --network portainer \
  --mode global \
  -e PORTAINER_ADDR=portainer:9000 \
  -e PORTAINER_USER=admin \
  -e PORTAINER_PASS=12341234 \
  softonic/portainer-endpoint

在Stack中与Portainer一同部署

可通过Swarm Stack部署Portainer及自动注册功能，在Swarm集群中执行以下命令：

bash
git clone git@github.com:softonic/portainer-endpoint.git
cd portainer-endpoint
export VOLUME_DRIVER=local
export PORTAINER_PASS=12341234
export PORTAINER_ENC_PASS=$(docker run --rm httpd:2.4-alpine htpasswd -nbB admin ${PORTAINER_PASS} | cut -d ":" -f 2)
echo $PORTAINER_PASS | docker secret create portainer_password.v1 --label portainer -
docker stack deploy --compose-file docker-compose.yml portainer

部署完成后，访问集群任一节点的9000端口即可进入Portainer，所有节点已自动注册。

要求

• 需要Docker >17.04（因stack文件版本要求）。
• 需要Docker >17.10.0（可移除主机名挂载及HOST_HOSTNAME变量）。
• 示例中使用secret存储Portainer密码（推荐），也可使用明文环境变量（不推荐）。