adamus1red/ouroboros

⚠️⚠️⚠️ ouroboros 已停止开发。它在一定程度上仍能正常工作，但开发者已因现实原因停止维护！欢迎大家fork并自行维护。感谢过去一年的所有支持 :)。在社区支持下，自动化版本更新将继续进行，以尽量保持 ouroboros 与依赖项的兼容性。 ⚠️⚠️⚠️

!https://raw.githubusercontent.com/pyouroboros/ouroboros/master/assets/ouroboros_logo_primary_long_cropped.jpg

![]([] ![Python Version]([***]

自动将运行中的 Docker 容器更新到最新可用镜像。Docker 更新自动化的事实标准工具。

概述

Ouroboros 会监控（所有或指定的）运行中的 Docker 容器，并将它们更新到远程 registry 中的（最新或指定标签的）可用镜像。更新后的容器使用容器首次创建时使用的相同标签和参数，例如卷/绑定挂载、Docker 网络连接、环境变量、重启策略、入口点、命令等。

• 将镜像推送到 registry 后，只需等待您定义的时间间隔，Ouroboros 就会找到新镜像并自动重新部署容器。
• 通过 https://github.com/caronc/apprise 支持多种平台的通知功能。
• 提供指标用于趋势监控（当前支持：Prometheus/Influxdb）。
• 减少服务器 SSH 访问需求。
• ssh -i key server.domainname "docker pull ... && docker run ..." 是初级玩法。
• docker-compose pull && docker-compose up -d 是进阶初级玩法。

核心功能和特性

• 自动更新容器：监控容器并自动更新到最新镜像，保留原配置。
• 多平台通知：通过 Apprise 支持多种通知渠道。
• 指标收集：支持 Prometheus 和 Influxdb 用于趋势监控。
• 跨架构支持：兼容 amd64、arm32 和 arm64 CPU 架构。
• 减少手动操作：无需手动执行 docker pull 和 docker run 命令。

使用场景和适用范围

适用于需要自动维护 Docker 容器最新状态的场景，尤其是：

• 希望减少手动更新容器操作的开发者和运维人员。
• 需要确保服务持续运行在最新镜像版本的生产环境。
• 希望通过通知及时了解容器更新状态的团队。
• 需要监控容器更新趋势和性能指标的场景。

使用方法和配置说明

更详细的使用和配置说明可在 https://github.com/pyouroboros/ouroboros/wiki 中找到。

Docker 部署

Ouroboros 可通过 Docker 镜像部署，命令如下：

bash
docker run -d --name ouroboros \
  -v /var/run/docker.sock:/var/run/docker.sock \
  pyouroboros/ouroboros

此镜像兼容 amd64、arm32 和 arm64 CPU 架构

或通过 docker-compose 部署：

https://github.com/pyouroboros/ouroboros/blob/master/docker-compose.yml

pip 安装

Ouroboros 也可通过 pip 安装：

bash
pip install ouroboros-cli

安装后可使用 ouroboros 命令调用：

bash
$ ouroboros --interval 300 --log-level debug

这对于创建 systemd 服务或类似非容器化守护进程非常有用。

示例

各命令和场景示例可在 https://github.com/pyouroboros/ouroboros/wiki/Usage 中找到。

贡献

欢迎所有贡献！贡献指南正在制定中。