NubesGen CLI 使用指南：从安装到实战

前言

NubesGen 是一个强大的云基础设施即代码(IaC)工具，它能够帮助开发者快速生成适用于 Azure 云的部署配置。本文将详细介绍如何安装和使用 NubesGen CLI 工具，让您能够轻松管理云基础设施。

安装准备

在开始使用 NubesGen CLI 之前，需要确保您的系统满足以下先决条件：

1. Bash 环境：

   • Linux 和 Mac OS X 系统默认已安装
   • Windows 用户建议使用 WSL (Windows Subsystem for Linux)

2. Azure CLI：

   • 用于与 Azure 云服务交互
   • 安装后需执行 az login 进行登录认证

3. GitHub CLI (可选)：

   • 用于自动化管理 GitHub 密钥
   • 安装后需执行 gh auth login 进行认证

安装 NubesGen CLI

NubesGen CLI 提供多种安装方式，您可以根据自己的系统环境选择最适合的方案：

Java 版本安装 (跨平台)

1. 确保已安装 Java 11 或更高版本
2. 下载最新版 JAR 文件
3. 运行命令：java -jar nubesgen-*.jar -h

Linux 系统安装

1. 下载 Linux 版二进制文件
2. 添加可执行权限：chmod +x nubesgen-cli-linux
3. 运行测试：./nubesgen-cli-linux -h

Mac OS 系统安装

1. 下载 Mac 版二进制文件
2. 对于 Apple Silicon 芯片，可能需要安装 Rosetta
3. 添加可执行权限并解除安全限制
4. 运行测试：./nubesgen-cli-macos -h

Windows 系统安装

1. 下载 Windows 版可执行文件
2. 直接运行：nubesgen-cli-windows -h

CLI 使用详解

NubesGen CLI 提供了多个功能强大的子命令，下面我们将详细介绍每个命令的使用场景和功能：

1. 基础使用

直接运行 CLI 而不带任何参数时，工具会按逻辑顺序执行以下操作：

• 自动设置 GitOps
• 扫描项目使用的技术栈
• 从 NubesGen REST 服务器下载基础设施即代码配置

2. 项目命名 (projectname)

此命令会为您的 Azure 项目生成唯一名称：

• 自动截取当前目录名的前8个字符
• 添加两个随机数字确保唯一性
• 示例：./nubesgen-cli-linux projectname

3. 项目扫描 (scan)

技术栈扫描功能可以：

• 自动识别项目中使用的技术框架
• 生成 REST 请求字符串
• 为后续基础设施配置提供依据
• 示例：./nubesgen-cli-linux scan

4. GitOps 设置 (gitops)

此命令帮助您快速设置 GitOps 工作流：

• 自动化配置持续部署流程
• 与 GitHub 仓库无缝集成
• 示例：./nubesgen-cli-linux gitops

5. 配置下载 (download)

从 NubesGen 服务器获取基础设施即代码模板：

• 提供标准化的部署配置
• 支持多种云服务组合
• 示例：./nubesgen-cli-linux download

使用技巧

1. 任何时候都可以使用 -h 参数查看完整的帮助文档
2. 建议在项目根目录下运行 CLI 命令
3. 对于复杂项目，可以多次运行 scan 命令确保技术栈识别准确
4. 下载配置后，建议仔细检查生成的 IaC 文件是否符合预期

总结

通过本文的介绍，您应该已经掌握了 NubesGen CLI 的安装和基本使用方法。这个工具能够显著简化云基础设施的配置过程，让开发者可以更专注于业务逻辑的实现。建议初次使用时从简单项目开始，逐步熟悉各项功能，再应用到生产环境中。

随着对工具的深入理解，您可以探索更高级的功能，如自定义配置模板、多环境部署等，这些都将帮助您构建更健壮的云原生应用架构。