ARI 2024.3.25.72

ARI

Azure Resource Inventory .NET 工具 - 将指定租户的 Azure 资源清单文档化到指定的文件夹中，并生成一系列 Markdown 文件。

获取

dotnet tool install -g ari

命令

使用 -h / --help 获取当前可用命令和选项的列表。

ari --help
ari command --help

清单

清单 命令列出租户并输出结果作为 Markdown 文件到指定的输出路径。

ari inventory <tenantId> <outputpath> [options]

快速入门

首次成功运行 ARI

默认情况下，它会尝试使用 DefaultAzureCredential 进行身份验证，它将根据您的工作环境按以下顺序尝试授权。

1. 环境凭证
2. 工作负载身份凭证
3. 托管身份凭证
4. 共享令牌缓存凭证
5. VisualStudio 凭证
6. VisualStudioCode 凭证
7. AzureCli 凭证
8. AzurePowerShell 凭证
9. AzureDeveloperCli 凭证
10. 交互式浏览器凭证

设置 Azure 应用注册

最佳做法是使用仅需要归属文档化的访问权限的服务主体，您可以通过创建应用注册来实现。

1. 首先，为报告生成器在 Azure Entra 中创建一个 应用注册。这确保报告生成器恰好具有所需的访问权限，例如组织范围内的读取权限或对有限订阅的访问权限。
2. 将 API 权限 https://graph.microsoft.com/Organization.Read.All 分配给创建的 应用注册。
3. 在我的租户中，此权限需要管理员同意。
4. 添加一个允许 应用注册 读取组织的角色。您可以在 Azure 中的 订阅 管理和 访问控制 (IAM) 之下进行此操作。添加 角色分配，找到 应用注册 并授予其 读取 权限。
5. 为 应用注册 分配一个机密并将其记录下来。

现在 Azure 应用注册已配置，我们可以继续了。

配置 ARI 以执行

1. 创建一个专用的文件夹用于生成的报告。
2. 设置环境变量 AZURE_TENANT_ID 为租户 ID（位于您的应用的 应用注册 概览中）。
3. 设置环境变量 AZURE_CLIENT_ID 为客户端 ID（可在您的应用的 应用注册 概述中找到）。
4. 将环境变量 AZURE_CLIENT_SECRET 设置为之前记下的密钥。
5. 将环境变量 AZURE_AUTHORITY_HOST 设置为 https://login.microsoftonline.com/。

运行 ARI

假设所有环境变量都已正确设置，请按照以下步骤操作

dotnet tool install --global ARI
ari <AZURE_TENANT_ID> <FOLDER_FOR_REPORT>

按照以下步骤操作，您应该能够成功运行 ARI。如果遇到任何问题，请仔细检查 Azure 应用注册设置，并确保环境变量配置准确。