stixes/docker-hook

docker-hook

本镜像为 https://github.com/schickling/docker-hook 的Docker封装，通过简单的webhook工具实现Docker服务的更新与部署。docker-hook 监听传入的HTTP请求，在身份验证通过后触发指定命令。

核心功能

• 使用简单
• 支持身份验证
• 内置Docker服务更新工具

配置说明

示例：

生成一个保密的令牌：

sh
$ uuidgen
f14c64f3-1df9-4b98-988a-b58d6289cfcc

启动docker-hook容器：

sh
$ docker run -d -e MYENV=stuff -e CMD="sh update.sh" -e TOKEN=f14c64f3-1df9-4b98-988a-b58d6289cfcc -v /var/run/docker.sock:/var/run/docker.sock:ro -v ./scripts/:/root -p 8555:8555 stixes/docker-hook

上述命令生成用于身份验证的令牌，并设置触发命令为 sh update.sh。由于更新操作在容器环境中执行，需映射Docker套接字以允许脚本使用 docker 和 docker-compose 命令更新主机上的容器。MYENV环境变量可传递配置至脚本。钩子暴露在8555端口，可通过curl调用：

sh
$ curl -X POST http://your.domain.com:8555/f14c64f3-1df9-4b98-988a-b58d6289cfcc

Docker Compose示例：

docker-compose.yml

该Compose文件运行 myapp 镜像及更新钩子。钩子需映射Compose文件以使用docker-compose命令。出于安全考虑，所有映射应设为只读。

yaml
version: '3'
services:
  myapp:
    image: myimage:latest
    ports:
      - 80:80
  
  appupdater:
    image: stixes/docker-hook:latest
    ports:
      - 8555:8555
    environment:
      CMD: sh /update.sh
      TOKEN: f14c64f3-1df9-4b98-988a-b58d6289cfcc
    working_dir: /
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./update.sh:/update.sh:ro
      - ./docker-compose.yml:/docker-compose.yml:ro

update.sh

该脚本在容器环境中运行，可使用Docker工具：

sh
#!/bin/sh
docker-compose pull && \
docker-compose up -d myapp

工作原理

docker-hook 采用纯Python编写，无额外依赖。它通过 BaseHTTPRequestHandler 监听来自Docker Hub的HTTP请求，在身份验证成功后执行指定命令。

许可证

MIT License