buildkite/zstash
GitHub: buildkite/zstash
zstash 是一个面向 Buildkite Agent 的 Go 缓存库，提供缓存保存/恢复功能及 API，支持 S3 存储后端和 glob 模式匹配。
Stars: 4 | Forks: 0
# zstash
Go 缓存库，为 [Buildkite Agent](https://github.com/buildkite/agent) 提供缓存保存/恢复和 API 功能。
# 缓存键模式匹配
zstash 使用 [zzglob](https://pkg.go.dev/drjosh.dev/zzglob) 库支持缓存键的完整 glob 模式匹配。
# S3 自管理存储桶
当使用 S3 作为存储后端（`local_s3` 存储类型）时，请使用查询参数配置存储桶 URL 以自定义行为。
## URL 格式
```
s3://bucket-name[/prefix][?options]
```
## 选项
| 参数 | 描述 | 默认值 | 有效范围 |
|-----------|-------------|---------|-------------|
| `region` | 存储桶所在的 AWS region | `us-east-1` | 任何有效的 AWS region |
| `endpoint` | 自定义 S3 endpoint（用于兼容 S3 的存储或本地测试） | AWS 默认值 | 任何有效的 URL |
| `use_path_style` | 使用 path-style 寻址而不是 virtual-hosted-style | `false` | `true` 或 `false` |
| `concurrency` | 并行上传/下载分片的数量 | `5` | 0-100（0 = 默认值） |
| `part_size_mb` | 多部分传输时每个分片的大小（以 MB 为单位） | `5` | 0，或 5-5120（0 = 默认值） |
## 示例
基础 S3 存储桶：
```
s3://my-cache-bucket
```
带有前缀和 region 的 S3 存储桶：
```
s3://my-cache-bucket/buildkite/cache?region=us-west-2
```
使用 path-style 访问的 S3 兼容存储（例如 MinIO）：
```
s3://my-bucket?endpoint=http://localhost:9000&use_path_style=true
```
针对大文件的高性能配置：
```
s3://my-cache-bucket?concurrency=20&part_size_mb=100
```
所有选项组合：
```
s3://my-cache-bucket/prefix?region=eu-west-1&concurrency=10&part_size_mb=50
```
## 注意事项
# API 文档
详情请参阅 [pkg.go.dev 上的 API 文档](https://pkg.go.dev/github.com/buildkite/zstash)。
## 许可证
MIT © Buildkite
SPDX-License-Identifier: MIT
标签：EVTX分析, 日志审计, 漏洞探索