embeddedenterprises/burrow

burrow https://img.shields.io/github/tag/EmbeddedEnterprises/burrow.svg](https://github.com/EmbeddedEnterprises/burrow/releases) https://travis-ci.org/EmbeddedEnterprises/burrow.svg?branch=master](https://travis-ci.org/EmbeddedEnterprises/burrow) https://goreportcard.com/badge/github.com/EmbeddedEnterprises/burrow](https://goreportcard.com/report/github.com/EmbeddedEnterprises/burrow) https://godoc.org/github.com/EmbeddedEnterprises/burrow?status.svg](https://godoc.org/github.com/EmbeddedEnterprises/burrow) https://img.shields.io/docker/pulls/embeddedenterprises/burrow.svg](https://hub.docker.com/r/embeddedenterprises/burrow/) https://img.shields.io/docker/build/embeddedenterprises/burrow.svg](https://hub.docker.com/r/embeddedenterprises/burrow/builds/)

警告：该项目已弃用，建议使用官方 go mod 工具！

镜像概述

burrow是一个Go构建系统，最初基于Glide进行依赖管理，现转为封装官方go mod工具。它旨在解决go tool构建的可复现性问题，支持项目级默认参数配置，并提供完整的项目生命周期管理（包括创建、依赖管理、构建、测试、打包、发布等）。所有burrow项目仍可通过手动执行go build完成构建，burrow仅用于简化流程。

核心功能

• 封装go mod工具，支持依赖管理与可复现构建
• 提供项目级go build等命令的默认参数配置
• 覆盖项目全生命周期：创建、依赖管理、构建、测试、打包、发布等
• 兼容官方go tool，无需burrow也可构建项目

使用场景

• 维护已有的burrow项目（不推荐用于新项目）
• 需要简化Go项目构建流程，确保构建可复现
• 需要统一管理项目的依赖和构建参数

配置说明

burrow项目结构

+-bin/
| +-app
+-example/
| +-api-showcase.go
+-package/
| +-app-0.1.0.tar.gz
+-vendor/
+-burrow.yaml
+-glide.lock
+-glide.yaml
+-LICENSE
+-main.go
+-README.md

其中burrow.yaml用于配置项目的默认参数和生命周期行为。

部署示例

Docker运行命令

在项目根目录执行以下命令构建项目：

bash
docker run --rm -v $(pwd):/app docker.xuanyuan.run/embeddedenterprises/burrow build

该命令将当前目录挂载到容器/app目录，执行burrow build构建项目。

其他命令

执行burrow --help可查看所有命令，主要包括：

• init/create: 初始化burrow项目（已弃用）
• new: 创建新burrow项目（已弃用）
• clone: 克隆Git仓库到当前目录
• get: 向go.mod添加依赖
• fetch/ensure: 从go.sum获取依赖以复现构建
• update: 更新依赖并同步go.sum
• run: 运行应用
• test: 执行所有测试
• build: 构建应用
• install/uninstall: 安装/卸载应用到GOPATH
• package: 生成包含二进制的.tar.gz包
• publish: 发布版本（构建包并设置Git标签）
• clean: 清理构建产物
• doc: 本地托管Go文档
• format/fmt: 用go fmt格式化代码
• check/vet: 用go vet检查代码
• major/minor/patch: 递增版本号的主/次/补丁部分

许可证

本项目采用GPL-3许可证。