jamie/tools Docker 镜像 - 轩辕镜像

tools

![Build Status]([] ![healthchecks.io]([] ![Docker Image Version]([] ![Docker Image Size]([] ![Docker Image Pulls]([] ![Docker Image Stars]([] ![License]([***]

概述

这是一个用于诊断和故障排除的工具镜像，集成了多种实用工具，适合系统管理员、开发人员在各类环境中进行快速调试和问题排查。该镜像注重安全性、轻量性和易用性，确保在提供丰富功能的同时保持精简的体积和最小的***面。

核心功能和特性

• 交互式Shell：提供便捷的命令行交互环境
• 包管理器：内置包管理工具，支持扩展功能
• 预安装工具集：包含常用诊断和排查工具
• 镜像体积小：优化的镜像大小，减少资源占用
• ***面小：精简设计，降低安全风险
• 自动同步上游版本：保持与基础镜像版本同步更新
• 自动更新固定APK包版本：确保依赖包版本可控且最新
• 可重现构建：构建过程可重复，确保一致性
• 简单Dockerfile：透明的构建配置，易于理解和定制
• 自动化测试：通过自动化测试保障功能稳定性
• 安全性：基于上述要求构建，确保使用安全

使用场景和适用范围

• 系统诊断与故障排除
• 网络问题排查（如DNS查询、端口测试等）
• 容器环境快速调试
• 临时命令行工具需求
• 开发和测试环境中的辅助工具

使用方法

交互式Shell

通过以下命令启动交互式Shell环境：

bash
docker run -it --rm jamie/tools:1.4.2

运行容器内工具

直接运行容器中的特定工具（以dig命令为例）：

bash
docker run --rm jamie/tools:1.4.2 dig [***]

开发指南

环境准备

• 确保已安装并配置Docker CLI

• 安装Node.js（可使用mise、nvm等版本管理工具，版本参见.nvmrc）

• 使用npm执行干净安装：

  bash
  npm ci
  

开发命令

代码检查

bash
make lint

构建镜像

bash
make build

运行测试

bash
make smoke

运行本地CI流水线

（不执行镜像发布和推送操作）

bash
make ci

监控与告警

工作流失败告警

失败的工作流告警将发送到***频道，通过Webhook配置：

bash
gh secret set ***_WEBHOOK -e ci -r jamiemoore/tools

死信开关告警

使用healthchecks.io配置死信开关告警，ping URL存储为密钥：

bash
gh secret set PING_URL -e ci -r jamiemoore/tools

技术栈

• CI：GitHub Workflows
• 版本控制：semantic-release
• 任务运行器：make
• 包管理：npm
• Node版本管理：mise/nvm

架构决策记录（ADR）

• 使用renovate替代dependabot：dependabot在支持范围上存在限制（如nvm和锁文件管理）
• 选择make作为任务运行器：通用的任务管理工具，make ci比执行多个独立命令更便捷
  • package.json无法在命令间存储变量
  • mise tasks虽有潜力，但尚不成熟
• 告警工具选择：在现有选项中选择最优解
  • ***：仅在桌面端空闲时发送移动通知
  • Slack：错过通知后可能无法再查看
  • Pushover：存在与Slack相同的通知遗漏问题
• 监控工具选择：采用healthchecks.io作为死信开关服务，提供慷慨的免费计划
• 选择npm：作为最成熟、支持最广泛的包管理器
• 使用Bats进行测试：熟悉该工具且适合容器冒烟测试
  • 从容器外部测试更能反映实际使用场景
• 冒烟测试：基础设施的必要测试要求
• Semantic Release配置：需要GitHub PAT以绕过PR要求并触发其他工作流（如Docker Hub README更新）
• 签名提交：Semantic Release目前未配置使用签名提交，因此禁用要求签名提交的分支保护
• APK包版本固定：避免因构建时间不同导致包版本变化
• 无需运行apk update：使用apk add --no-cache已确保索引为最新版本
• 不运行apk upgrade：避免包版本变为未知状态