stackgenhq/homebrew-stackgen
GitHub: stackgenhq/homebrew-stackgen
StackGen 的 Homebrew 软件源，提供代码生成基础设施、云资源逆向导入 Terraform、SLO 管理等 DevOps 工具链的安装入口。
Stars: 1 | Forks: 0
# StackGen Homebrew Tap
通过 [Homebrew](https://brew.sh) 安装 StackGen 的 CLI 和工具。
## 目录
- [前置条件](#prerequisites)
- [可用的 formulae](#available-formulae)
- [快速安装 (StackGen CLI)](#quick-install-stackgen-cli)
- [安装其他工具](#install-other-tools)
- [配置](#configuration)
- [用法](#usage)
## 前置条件
- **Homebrew** — 如需请安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- **StackGen 账户** (用于云服务) — 在 [cloud.stackgen.com](https://cloud.stackgen.com/) 注册
## 可用的 formulae
| Formula | 描述 | 安装命令 |
|--------|-------------|-----------------|
| **stackgen** | 主 CLI — 从代码生成基础设施 | `brew install stackgenhq/homebrew-stackgen/stackgen` |
| **stackgen-beta** | StackGen CLI (beta/RC 版本) | `brew install stackgenhq/homebrew-stackgen/stackgen-beta` |
| **stackgen-slo** | SLO 应用 — 从代码生成基础设施 | `brew install stackgenhq/homebrew-stackgen/stackgen-slo` |
| **terraform-importer** | 解析 Terraform IaC 并导入到 Stackgen | `brew install stackgenhq/homebrew-stackgen/terraform-importer` |
| **cloud2code** | 将云资源转换为 tfstate 文件 | `brew install stackgenhq/homebrew-stackgen/cloud2code` |
| **cloud2code-beta** | Cloud2code (beta/RC 版本) | `brew install stackgenhq/homebrew-stackgen/cloud2code-beta` |
| **logexplorer** | 日志浏览器 | `brew install stackgenhq/homebrew-stackgen/logexplorer` |
| **genie** | 从代码生成基础设施 (Genie) | `brew install stackgenhq/homebrew-stackgen/genie` |
| **stackboot** | 从代码生成基础设施 (StackBoot, 仅限 macOS) | `brew install stackgenhq/homebrew-stackgen/stackboot` |
## 快速安装 (StackGen CLI)
1. 添加 tap 并安装：
brew tap stackgenhq/homebrew-stackgen
brew install stackgenhq/homebrew-stackgen/stackgen
2. 检查安装：
stackgen version
## 安装其他工具
对[上表](#available-formulae)中的任何 formula 使用相同的模式：
```
brew tap stackgenhq/homebrew-stackgen # only needed once
brew install stackgenhq/homebrew-stackgen/
```
示例：
```
brew install stackgenhq/homebrew-stackgen/terraform-importer
brew install stackgenhq/homebrew-stackgen/cloud2code
brew install stackgenhq/homebrew-stackgen/logexplorer
```
## 配置
CLI **需要**一个 base URL 和一个 API token。
### 必需的环境变量
| 变量 | 必需 | 描述 |
|----------|----------|-------------|
| `STACKGEN_URL` | **是** | StackGen API 的 base URL (云端或本地部署)。 |
| `STACKGEN_TOKEN` | **是** | 你的 API key (个人访问令牌)。 |
### 云端 (cloud.stackgen.com)
1. 登录 [cloud.stackgen.com](https://cloud.stackgen.com/)。
2. 打开 [Personal access tokens](https://cloud.stackgen.com/account-settings/pat/) 并复制你的 API key。
3. 在你的 shell 中设置两者：
export STACKGEN_URL="https://cloud.stackgen.com"
export STACKGEN_TOKEN=
将这些行添加到 `~/.zshrc` 或 `~/.bashrc` 以使其持久化。
### 本地部署
使用你组织的 StackGen URL 和 API key：
```
export STACKGEN_URL="https://my-org.stackgen.com"
export STACKGEN_TOKEN=
```
## 用法
安装 **stackgen** 后：
```
stackgen --help
```
对于其他工具，运行二进制文件名（例如 `terraform-importer --help`、`logexplorer --help`）。
## 链接
- [StackGen](https://stackgen.com/)
- [文档](https://docs.stackgen.com/)
标签：CLI, EC2, ECS, Homebrew, IaC, SLO, StackGen, TAP, Terraform, WiFi技术, 云计算, 云资源管理, 威胁情报, 开发者工具, 开源, 文档结构分析, 日志审计, 特权提升, 生成式基础设施, 自动化部署, 规则引擎, 软件包管理器