AzBrowse 项目启动与配置教程

1. 项目目录结构及介绍

AzBrowse 项目是一个用于浏览 Azure 资源的命令行工具。以下是项目的目录结构及其简单介绍：

azbrowse/
├── bin/                # 存放编译后的可执行文件
├── build/              # 构建脚本和依赖文件
├── cmd/                # 主应用程序代码
│   └── azbrowse/       # AzBrowse 工具的主要代码
├── docs/               # 文档资料
├── internal/           # 内部使用的库和模块
│   ├── azclient/       # Azure 客户端相关代码
│   ├── config/         # 配置处理相关代码
│   ├── graphql/        # GraphQL 相关代码
│   ├── styles/         # 样式文件
│   └── themes/         # 主题文件
├── pkg/                # 封装的库和工具
├── scripts/            # 脚本文件，包括启动脚本
├── test/               # 测试相关文件和代码
└── README.md           # 项目说明文件

• bin/：存放编译后的可执行文件。
• build/：包含构建脚本和依赖文件。
• cmd/：包含主应用程序代码，azbrowse/ 目录下是 AzBrowse 工具的主要代码。
• docs/：存放项目文档资料。
• internal/：包含内部使用的库和模块，例如 azclient/ 用于处理 Azure 客户端请求。
• pkg/：封装的库和工具。
• scripts/：包含启动脚本和其他脚本文件。
• test/：存放测试相关文件和代码。
• README.md：项目说明文件。

2. 项目的启动文件介绍

项目的启动文件位于 scripts/ 目录下，名为 start.sh（对于 Linux 和 macOS 系统）和 start.bat（对于 Windows 系统）。以下是 start.sh 的内容示例：

#!/bin/bash

# 设置 AzBrowse 的根目录
AZBROWSE_ROOT=$(dirname "$(readlink -f "$0")")

# 启动 AzBrowse
"${AZBROWSE_ROOT}/bin/azbrowse" "$@"

• 这段脚本设置了 AzBrowse 的根目录。
• 然后，它调用编译后的 azbrowse 可执行文件，并传递所有参数。

对于 Windows 用户，start.bat 文件的内容将类似，但使用的是 Windows 批处理命令。

3. 项目的配置文件介绍

AzBrowse 的配置文件通常位于 ~/.azbrowse/ 目录下，文件名为 config.json。以下是配置文件的一个基本示例：

{
  "AzureSubscription": "<SubscriptionId>",
  "TenantId": "<TenantId>",
  "Environment": "AzurePublicCloud",
  "AzureClientID": "<ClientID>",
  "AzureClientSecret": "<ClientSecret>",
  "AzureRefreshToken": "<RefreshToken>",
  "TokenEndpoint": "https://login.microsoftonline.com/<TenantId>/oauth2/v2.0/token"
}

• AzureSubscription：Azure 订阅 ID。
• TenantId：Azure 租户 ID。
• Environment：Azure 环境，例如 "AzurePublicCloud"。
• AzureClientID：Azure 应用程序的客户端 ID。
• AzureClientSecret：Azure 应用程序的客户端密钥。
• AzureRefreshToken：用于刷新访问令牌的刷新令牌。
• TokenEndpoint：用于获取令牌的终结点。

确保将 <SubscriptionId>, <TenantId>, <ClientID>, <ClientSecret>, <RefreshToken> 替换为实际的值。这些信息可以从 Azure 门户中获取。