washpost/fusion-cli-api

Fusion CLI API Docker镜像文档

镜像概述

Fusion CLI API Docker镜像是一个预配置的容器化解决方案，旨在提供Fusion工具的命令行界面(CLI)和应用程序编程接口(API)服务。该镜像封装了Fusion CLI工具及API服务依赖环境，可快速部署并提供稳定的交互接口，适用于开发、测试及生产环境中与Fusion系统的集成。

核心功能与特性

• 完整CLI工具集：内置Fusion官方CLI工具，支持所有核心命令操作
• API服务支持：提供RESTful API接口，支持通过HTTP请求与Fusion系统交互
• 轻量级部署：基于精简基础镜像构建，体积小，启动速度快
• 环境隔离：容器化运行环境，避免与主机系统依赖冲突
• 版本一致性：固定Fusion CLI及API服务版本，确保不同环境下的一致性

使用场景与适用范围

• 开发环境：开发者可快速获取Fusion CLI工具，无需本地安装依赖
• 集成测试：在CI/CD流水线中集成，通过API或CLI执行自动化测试命令
• 生产环境：作为Fusion系统的辅助服务节点，提供稳定的API访问接口
• 多环境一致性：确保开发、测试、生产环境使用相同版本的Fusion工具链

使用方法与配置说明

基本部署（docker run）

bash
docker run -d --name fusion-cli-api -p 8080:8080 fusion-cli-api:latest

参数说明：

• -d：后台运行容器
• --name fusion-cli-api：指定容器名称为fusion-cli-api
• -p 8080:8080：映射容器内API服务端口8080到主机8080端口
• fusion-cli-api:latest：使用最新版本的Fusion CLI API镜像

环境变量配置

该镜像支持通过环境变量自定义配置，常用环境变量如下：

示例（带环境变量的启动命令）：

bash
docker run -d --name fusion-cli-api \
  -p 8081:8081 \
  -e API_PORT=8081 \
  -e LOG_LEVEL=debug \
  -e FUSION_SERVER_URL=http://fusion-prod:9000 \
  -e AUTH_TOKEN=your_auth_token \
  fusion-cli-api:latest

CLI工具使用

容器启动后，可通过docker exec进入容器使用CLI工具：

bash
# 进入容器
docker exec -it fusion-cli-api /bin/bash

# 执行Fusion CLI命令示例
fusion-cli --version
fusion-cli status
fusion-cli deploy --project my-project

API服务使用

API服务默认监听在配置的API_PORT端口，基础URL为http://<容器IP>:<API_PORT>/api/v1。

API示例（获取系统状态）：

bash
curl http://localhost:8080/api/v1/status \
  -H "Authorization: Bearer your_auth_token"

响应示例：

json
{
  "status": "running",
  "version": "1.0.0",
  "fusion_server": "http://fusion-prod:9000",
  "uptime": "2h30m"
}

注意事项

• 确保主机端口（如8080）未被占用，或通过-p参数映射到其他可用端口
• AUTH_TOKEN建议通过环境变量或Docker Secrets安全注入，避免明文暴露
• 生产环境中建议配合Docker Compose或Kubernetes进行编排，实现高可用部署
• 镜像定期更新，建议通过指定具体版本标签（如fusion-cli-api:1.2.0）而非latest确保稳定性