southclaws/wadsworth

Wadsworth

自动化的“万能助手”机器人！

Wadsworth是一个Git驱动的任务运行器，用于自动化配置的应用。

安装

Linux

sh
curl -s https://raw.githubusercontent.com/Southclaws/wadsworth/master/install.sh | bash

其他平台

它主要面向Linux服务器的服务端工具，暂无其他平台安装脚本。Windows/Mac用户若用于本地测试，可使用go get安装。

镜像概述

Wadsworth用于单服务器环境实现Git-Ops，非云/集群工具（集群场景建议用kube-applier、Terraform等）。核心特点是极简：指定Git仓库，提交时自动执行命令；支持从Hashicorp Vault安全传递凭据，避免敏感信息明文存储。

核心功能

1. Git驱动触发：仓库提交时自动执行指定命令
2. 安全凭据管理：集成Hashicorp Vault获取敏感信息
3. 灵活配置：用JavaScript定义配置，支持变量与逻辑
4. 多目标管理：在配置仓库中声明多个目标仓库及操作

使用场景

• 单服务器Git-Ops实践
• Docker Compose栈的自动化部署（仓库变更时重新部署）
• 批量管理多应用配置更新
• 带安全凭据的自动化任务执行

配置说明

Wadsworth使用JavaScript配置文件，支持T（声明目标）和E（声明环境变量）函数。

T函数示例（Docker Compose部署）

js
T({
  name: "我的应用",
  url: "git@github.com:用户名/我的docker-compose项目",
  up: ["docker-compose", "up", "-d"],
  down: ["docker-compose", "down"]
});

目标仓库变更时自动执行docker-compose up -d重新部署。

变量与函数复用

js
var GIT_HOST = "git@github.com:用户名/";

function Compose(name) {
  return {
    name: name,
    url: GIT_HOST + name,
    up: ["docker-compose", "up", "-d"]
  };
}

T(Compose("主页"));
T(Compose("待办应用"));

E函数示例（环境变量）

js
E("MOUNT_POINT", "/data");
T({ name: "postgres", url: "...", up: ["docker-compose", "up", "-d"] });

环境变量会传递给up/down命令，可用于Docker卷挂载路径。

部署示例

启动Wadsworth并指定配置仓库：

sh
wadsworth run git@github.com:你的用户名/你的配置仓库.git

未来规划

• 守护进程控制：通过Unix socket和API交互（如强制触发目标）
• 完善发布：提供systemd单元文件和Snapcraft应用
• 依赖树支持：（可能）允许仓库包含配置构建依赖树