go-selfupdate 使用指南

1. 项目介绍

go-selfupdate 是一个用于实现Go应用程序自我更新功能的库。它允许你的程序检查是否有新版本可用，并在发现更新时安全地替换当前正在运行的可执行文件。支持跨平台更新（包括Windows），并且提供了二进制补丁应用、校验和验证等高级特性。

2. 项目快速启动

安装依赖

首先，确保你的Go环境已经设置好，然后通过以下命令获取 go-selfupdate 库：

go get -u github.com/sanbornm/go-selfupdate

示例代码

下面是一个简单的自我更新示例：

package main

import (
	"fmt"
	"github.com/minio/selfupdate"
	"net/http"
)

func main() {
	err := selfupdate.UpdateFromURL("http://updates.yourdomain.com/update")
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println("Application updated.")
}

在这个例子中，我们调用 selfupdate.UpdateFromURL 来检查并更新来自指定URL的最新版本。

自定义行为

你可以自定义更新成功后的行为，例如优雅重启：

var updater = &selfupdate.Updater{
    ...
    OnSuccessfulUpdate: func() { os.Exit(0) },
}

// 在主程序逻辑之后进行背景更新
go updater.BackgroundRun()

3. 应用案例和最佳实践

• 服务重启: 当更新成功后，可以根据应用场景优雅地重启服务，如使用Docker或systemd。
• 定时检查: 可以设置定期检查更新的时间间隔，并随机化时间以避免所有客户端同时请求。
• 安全性: 验证下载的更新包的SHA256校验和，确保数据完整性。
• 多应用管理: 可在同一服务器上处理多个应用的更新，只需提供不同的更新端点。

4. 典型生态项目

• minio/selfupdate: 这个项目虽然不是go-selfupdate的直接分支，但它是相似概念的一个实现，提供了用于创建自我更新Go程序的功能。这个项目在实践中被广泛使用，特别是在存储和云相关服务中。

完成上述步骤后，你将拥有一个基本的自我更新Go应用程序。继续探索项目的文档和示例，以充分利用其所有特性和灵活性。