Diun镜像监控工具命令行使用指南

Diun镜像监控工具命令行使用指南

diun crazy-max/diun: Diun 是一个用于自动更新 Docker 镜像的 Python 库，可以用于自动化更新 Docker 镜像和容器，支持多种 Docker 镜像仓库和容器运行时，可以用于自动化部署和更新 Docker 应用程序。 项目地址: https://gitcode.com/gh_mirrors/di/diun

概述

Diun是一款强大的Docker镜像更新监控工具，能够帮助开发者和管理员及时获取容器镜像的更新信息。本文将详细介绍Diun的命令行使用方法，包括服务启动、镜像管理以及通知测试等功能。

基本命令结构

Diun的命令行采用标准的CLI结构：

diun [全局选项] 命令 [命令或全局选项] [参数...]

全局选项

所有命令均可使用以下全局选项：

• --help或-h：显示上下文相关的帮助信息
• --version：显示版本信息并退出

主要命令详解

启动服务命令

serve命令用于启动Diun服务：

diun serve --config diun.yml --log-level debug

可用选项包括：

• --config：指定配置文件路径
• --log-level：设置日志级别（默认info）
• --log-json：启用JSON格式日志输出
• --log-caller：在日志中显示调用者文件位置
• --log-nocolor：禁用彩色日志输出
• --grpc-authority：gRPC服务监听地址（默认:42286）

环境变量替代方案：

| 变量名 | 默认值 | 说明 | |-----------------|----------|-----------------------------| | LOG_LEVEL | info | 日志级别：panic/fatal/error等 | | LOG_JSON | false | 是否启用JSON日志 | | LOG_CALLER | false | 是否显示调用者位置 | | LOG_NOCOLOR | false | 是否禁用彩色输出 |

镜像管理命令

列出镜像

查看数据库中所有镜像：

diun image list

使用--raw选项可获取JSON格式输出。

查看镜像详情

获取特定镜像的详细信息：

diun image inspect --image alpine

必须指定--image参数，同样支持--raw选项。

删除镜像记录

从数据库中移除镜像记录：

diun image remove --image alpine:latest

注意：若不指定标签，将删除该镜像的所有记录。

清理所有镜像记录

清空数据库中的所有镜像记录：

diun image prune

建议谨慎使用，可通过--force跳过确认提示。

通知测试命令

测试通知配置是否正常工作：

diun notif test

使用建议

1. 生产环境建议使用配置文件配合serve命令长期运行
2. 调试时可使用--log-level debug获取详细日志
3. 镜像管理命令需要先启动服务才能使用
4. 定期检查镜像更新情况，及时清理无用记录

通过合理使用这些命令，您可以高效地管理Docker镜像更新监控任务，确保容器环境的安全性。

diun crazy-max/diun: Diun 是一个用于自动更新 Docker 镜像的 Python 库，可以用于自动化更新 Docker 镜像和容器，支持多种 Docker 镜像仓库和容器运行时，可以用于自动化部署和更新 Docker 应用程序。 项目地址: https://gitcode.com/gh_mirrors/di/diun