Spacelift CLI 项目安装与配置指南

1. 项目基础介绍

Spacelift CLI 是一个开源项目，为 Spacelift 提供了命令行界面（CLI），使得用户可以方便地在命令行环境中通过 GraphQL API 进行交互。它主要用于探索和执行 Spacelift 中的操作，并提供有限的资源创建或编辑功能。该项目主要使用 Golang 编程语言开发。

2. 关键技术和框架

• Golang：项目的主体编程语言。
• GraphQL：用于与 Spacelift API 进行交互的查询语言。
• Terraform：通过 Spacelift Terraform Provider 进行资源的程序化创建和编辑。

3. 安装和配置准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：支持 macOS、Linux 和 Windows。
• Go 语言环境：需要安装 Go (Golang) 环境，版本至少为 1.16。
• 网络：确保您的网络环境可以访问 GitHub 和 Spacelift API。

安装步骤

方法一：使用包管理器安装

根据您的操作系统，可以使用以下包管理器进行安装：

• macOS 或 Linux：使用 Homebrew 安装。

  brew install spacelift-io/spacelift/spacectl
  

• Windows：使用 winget 安装。

  winget install spacectl
  

  或者

  winget install --id spacelift-io.spacectl
  

方法二：使用 Docker

您也可以使用 Docker 来运行 Spacelift CLI：

docker run -it --rm ghcr.io/spacelift-io/spacectl stack deploy --id my-infra-stack

确保您已安装 Docker 并且已添加必要的环境变量以进行认证。

方法三：手动安装

1. 从 GitHub 克隆项目：

   git clone https://github.com/spacelift-io/spacectl.git
   

2. 进入项目目录并构建：

   cd spacectl
   go build -o spacectl .
   

   这将在当前目录生成 spacectl 可执行文件。

3. 将生成的可执行文件移动到您的系统路径中：

   mv spacectl /usr/local/bin/
   

配置环境变量

为了使用 Spacelift CLI，您需要设置环境变量以提供认证信息。以下是一些常用的环境变量：

• SPACELIFT_API_KEY_ENDPOINT：Spacelift API 的终端点。
• SPACELIFT_API_KEY_ID：您的 API 密钥 ID。
• SPACELIFT_API_KEY_SECRET：您的 API 密钥秘密。

将以下内容添加到您的 shell 配置文件中（如 .bashrc 或 .zshrc）：

export SPACELIFT_API_KEY_ENDPOINT="https://mycorp.app.spacelift.io"
export SPACELIFT_API_KEY_ID="your_api_key_id"
export SPACELIFT_API_KEY_SECRET="your_api_key_secret"

然后，重新加载配置文件或打开一个新的 shell 会话。

安装完成后，您可以通过以下命令验证安装：

spacectl --version

如果返回了版本信息，则表示安装成功。