xuanwu-cli 1.0.0

package/README.md

@@ -0,0 +1,171 @@
+# xuanwu-cli
+
+玄武工厂平台 CLI 工具
+
+## 快速开始
+
+### 1. 安装依赖
+
+```bash
+npm install
+```
+
+### 2. 编译
+
+```bash
+npm run build
+```
+
+### 3. 配置连接
+
+```bash
+# 添加连接
+node bin/xuanwu connect add prod \
+  --endpoint http://localhost:3000 \
+  --token <your-api-token>
+```
+
+### 4. 运行演示
+
+```bash
+./demo.sh
+```
+
+### 5. 运行验证测试
+
+```bash
+./verify.sh
+```
+
+## 功能验证
+
+运行验证脚本以测试所有已实现的功能：
+
+```bash
+./verify.sh
+```
+
+验证内容包括：
+- ✅ 依赖检查（Node.js, jq, curl）
+- ✅ 后端服务连接
+- ✅ CLI 编译和执行
+- ✅ 用户认证（注册、登录）
+- ✅ 环境管理（列出、创建）
+- ✅ 服务管理（列出、查询）
+- ✅ 所有 CLI 命令
+
+## 详细文档
+
+- [API 任务清单](../xuanwu-factory-v2/docs/tasks.md)
+- [功能验证报告](../xuanwu-factory-v2/docs/verification-report.md)
+
+## 当前状态
+
+**阶段 1 (基础功能)**: ✅ 完成
+- 环境管理 API
+- 服务管理 API
+- K8s 查询 API
+- 扩缩容 API
+- 用户认证 API
+
+**验证结果**: 19/19 测试通过 ✅
+
+## 获取 API Token
+
+### 方法1: Web 界面
+
+登录平台后，进入 `用户菜单 → API Token` 创建新 Token
+
+### 方法2: 命令行
+
+```bash
+# 登录获取 JWT Token
+curl -X POST http://localhost:3000/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email": "your@email.com", "password": "password"}'
+
+# 使用 JWT Token 创建 API Token
+curl -X POST http://localhost:3000/api/users/api-tokens \
+  -H "Authorization: Bearer <jwt-token>" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "cli-token"}'
+```
+
+## 快速开始
+
+### 1. 配置连接
+
+```bash
+xuanwu connect add prod --endpoint https://xuanwu.company.com --token your-token
+```
+
+### 2. 环境管理
+
+```bash
+# 列出环境
+xuanwu env ls
+
+# 创建环境
+xuanwu env create shop-dev
+```
+
+### 3. 部署服务
+
+```bash
+# 部署镜像
+xuanwu deploy shop-dev nginx --type image --image nginx:latest
+
+# 部署数据库
+xuanwu deploy shop-dev mysql --type database --db-type mysql --db-version 8.0
+
+# 部署应用（源码构建）
+xuanwu deploy shop --type application \
+  --git https-dev api://gitlab.com/user/repo.git \
+  --git-branch main \
+  --build-type template \
+  --language java-springboot
+```
+
+### 4. 查看服务
+
+```bash
+# 列出服务
+xuanwu svc ls shop-dev
+
+# 服务状态
+xuanwu svc status shop-dev nginx
+```
+
+### 5. 调试
+
+```bash
+# 查看日志
+xuanwu logs shop-dev nginx -n 100
+
+# 实时日志
+xuanwu logs shop-dev nginx -f
+
+# Pod 列表
+xuanwu pods shop-dev nginx
+```
+
+## 命令参考
+
+| 命令 | 说明 |
+|------|------|
+| `connect` | 管理连接 |
+| `env` | 环境管理 |
+| `deploy` | 部署服务 |
+| `svc` | 服务管理 |
+| `build` | 构建应用 |
+| `scale` | 扩缩容 |
+| `logs` | 查看日志 |
+| `pods` | Pod 列表 |
+
+## 输出格式
+
+默认输出人类可读格式，使用 `-o json` 切换到 JSON 格式：
+
+```bash
+xuanwu env ls -o json
+```

package/bin/xuanwu

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+/**
+ * xuanwu-cli 入口脚本
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const distPath = path.join(__dirname, '..', 'dist', 'index.js');
+
+const child = spawn('node', [distPath, ...args], {
+  stdio: 'inherit',
+  shell: process.platform === 'win32'
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/dist/api/client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * API 客户端
+ */
+import { Connection, CLIResult, ServiceInfo, NamespaceInfo, DeployOptions } from '../config/types';
+export declare class APIClient {
+    private client;
+    constructor(connection: Connection);
+    private request;
+    listNamespaces(): Promise<CLIResult<NamespaceInfo[]>>;
+    createNamespace(name: string): Promise<CLIResult<any>>;
+    deleteNamespace(id: string): Promise<CLIResult<void>>;
+    getNamespaceInfo(identifier: string): Promise<CLIResult<any>>;
+    getProjects(): Promise<CLIResult<any[]>>;
+    createNamespaceWithProject(name: string, projectId: string, environment?: string): Promise<CLIResult<any>>;
+    listServices(namespace: string): Promise<CLIResult<ServiceInfo[]>>;
+    getServiceStatus(namespace: string, name: string): Promise<CLIResult<any>>;
+    deleteService(namespace: string, name: string): Promise<CLIResult<void>>;
+    deploy(options: DeployOptions): Promise<CLIResult<any>>;
+    private getDefaultPort;
+    build(namespace: string, serviceName: string): Promise<CLIResult<any>>;
+    getBuildStatus(namespace: string, serviceName: string): Promise<CLIResult<any>>;
+    private getServiceByName;
+    scale(namespace: string, serviceName: string, replicas: number): Promise<CLIResult<any>>;
+    getLogs(namespace: string, serviceName: string, lines?: number, follow?: boolean): Promise<CLIResult<any>>;
+    streamLogs(namespace: string, serviceName: string): Promise<void>;
+    listPods(namespace: string, serviceName: string): Promise<CLIResult<any>>;
+    getMetrics(namespace: string, serviceName: string, podName?: string): Promise<CLIResult<any>>;
+    exec(namespace: string, serviceName: string, command: string, podName?: string): Promise<CLIResult<any>>;
+}
+export declare function createClient(connection: Connection): APIClient;

package/dist/api/client.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * API 客户端
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIClient = void 0;
+exports.createClient = createClient;
+const axios_1 = __importDefault(require("axios"));
+const formatter_1 = require("../output/formatter");
+class APIClient {
+    constructor(connection) {
+        this.client = axios_1.default.create({
+            baseURL: connection.endpoint,
+            headers: {
+                'Authorization': `Bearer ${connection.token}`,
+                'Content-Type': 'application/json'
+            },
+            timeout: 30000
+        });
+    }
+    async request(method, url, data, config) {
+        const startTime = Date.now();
+        try {
+            const response = await this.client.request({
+                method,
+                url,
+                data,
+                ...config
+            });
+            return {
+                success: true,
+                data: response.data,
+                meta: {
+                    timestamp: new Date().toISOString(),
+                    duration: Date.now() - startTime
+                }
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const message = error.response?.data?.message || error.message;
+            return {
+                success: false,
+                error: {
+                    code: error.response?.status?.toString() || 'ERROR',
+                    message,
+                    details: error.response?.data
+                },
+                meta: {
+                    timestamp: new Date().toISOString(),
+                    duration
+                }
+            };
+        }
+    }
+    // ===================
+    // Namespace (环境)
+    // ===================
+    async listNamespaces() {
+        return this.request('GET', '/api/deploy-spaces');
+    }
+    async createNamespace(name) {
+        return this.request('POST', '/api/deploy-spaces', {
+            name,
+            identifier: name,
+            namespace: name,
+            environment: 'development'
+        });
+    }
+    async deleteNamespace(id) {
+        return this.request('DELETE', `/api/deploy-spaces/${id}`);
+    }
+    async getNamespaceInfo(identifier) {
+        return this.request('GET', `/api/deploy-spaces?identifier=${identifier}`);
+    }
+    async getProjects() {
+        return this.request('GET', '/api/projects');
+    }
+    async createNamespaceWithProject(name, projectId, environment = 'development') {
+        return this.request('POST', '/api/deploy-spaces', {
+            name,
+            identifier: name,
+            namespace: name,
+            environment,
+            project_id: projectId
+        });
+    }
+    // ===================
+    // Service
+    // ===================
+    async listServices(namespace) {
+        return this.request('GET', `/api/k8s?kind=deployments&namespace=${namespace}`);
+    }
+    async getServiceStatus(namespace, name) {
+        return this.request('GET', `/api/k8s/deployments/${name}?namespace=${namespace}`);
+    }
+    async deleteService(namespace, name) {
+        return this.request('DELETE', `/api/services/by-ns/${namespace}/${name}`);
+    }
+    // ===================
+    // Deploy
+    // ===================
+    async deploy(options) {
+        const { namespace, serviceName, type, ...rest } = options;
+        // 获取 namespace 对应的 project_id
+        let projectId;
+        // 尝试通过 identifier 查询
+        const envResult = await this.getNamespaceInfo(namespace);
+        if (envResult.success && envResult.data) {
+            const envData = Array.isArray(envResult.data) ? envResult.data[0] : envResult.data;
+            projectId = envData.project?.id || envData.projectId;
+        }
+        // 如果没找到，尝试从列表中查找
+        if (!projectId) {
+            const listResult = await this.listNamespaces();
+            if (listResult.success && listResult.data) {
+                const env = listResult.data.find((e) => e.namespace === namespace || e.identifier === namespace);
+                if (env) {
+                    projectId = env.project?.id || env.projectId;
+                }
+            }
+        }
+        // 如果还是没有，使用第一个项目的 ID
+        if (!projectId) {
+            const projectsResult = await this.getProjects();
+            if (projectsResult.success && projectsResult.data && projectsResult.data.length > 0) {
+                projectId = projectsResult.data[0].id;
+            }
+        }
+        if (!projectId) {
+            return {
+                success: false,
+                error: { code: 'NOT_FOUND', message: `Cannot find project for namespace "${namespace}"` }
+            };
+        }
+        const payload = {
+            project_id: projectId,
+            name: serviceName,
+            type
+        };
+        // 根据类型添加配置
+        if (type === 'application') {
+            payload.git_provider = 'gitlab';
+            payload.git_repository = rest.git;
+            payload.git_branch = rest.gitBranch || 'main';
+            payload.build_type = rest.buildType || 'template';
+            payload.port = rest.port || 8080;
+        }
+        else if (type === 'database') {
+            payload.database_type = rest.dbType;
+            payload.version = rest.dbVersion || '8.0';
+            payload.root_password = rest.rootPassword || 'root';
+            payload.port = rest.port || this.getDefaultPort(rest.dbType);
+        }
+        else if (type === 'image') {
+            payload.image = rest.image;
+            payload.port = rest.port || 80;
+        }
+        // 添加通用配置
+        payload.replicas = rest.replicas || 1;
+        payload.port = rest.port || 8080;
+        // 添加资源限制
+        if (rest.cpu || rest.memory) {
+            payload.resource_limits = {
+                cpu: rest.cpu || '500m',
+                memory: rest.memory || '512Mi'
+            };
+        }
+        // 构建网络配置
+        payload.network_config = {
+            service_type: 'ClusterIP',
+            ports: [{
+                    container_port: payload.port,
+                    protocol: 'TCP'
+                }]
+        };
+        // 添加域名
+        if (rest.domain) {
+            payload.network_config.ports[0].domain = {
+                enabled: true,
+                prefix: rest.domain,
+                host: `${rest.domain}.${namespace}.dev.aimstek.cn`
+            };
+        }
+        // 环境变量
+        if (rest.envVars) {
+            payload.env_vars = rest.envVars;
+        }
+        return this.request('POST', '/api/services', payload);
+    }
+    getDefaultPort(dbType) {
+        const ports = {
+            mysql: 3306,
+            redis: 6379,
+            postgres: 5432,
+            elasticsearch: 9200
+        };
+        return ports[dbType] || 3306;
+    }
+    // ===================
+    // Build
+    // ===================
+    async build(namespace, serviceName) {
+        // 先获取服务 ID
+        const serviceResult = await this.getServiceByName(namespace, serviceName);
+        if (!serviceResult.success || !serviceResult.data) {
+            return {
+                success: false,
+                error: { code: 'NOT_FOUND', message: `Service ${serviceName} not found` }
+            };
+        }
+        const service = serviceResult.data;
+        if (!service.application_id) {
+            return {
+                success: false,
+                error: { code: 'NO_APPLICATION', message: 'Service is not an application type' }
+            };
+        }
+        return this.request('POST', `/api/applications/${service.application_id}/build`);
+    }
+    async getBuildStatus(namespace, serviceName) {
+        const serviceResult = await this.getServiceByName(namespace, serviceName);
+        if (!serviceResult.success || !serviceResult.data) {
+            return { success: false, error: { code: 'NOT_FOUND', message: 'Service not found' } };
+        }
+        const service = serviceResult.data;
+        if (!service.application_id) {
+            return { success: false, error: { code: 'NO_APPLICATION', message: 'Not an application' } };
+        }
+        return this.request('GET', `/api/applications/${service.application_id}/builds`);
+    }
+    async getServiceByName(namespace, name) {
+        return this.request('GET', `/api/services?project_id=${namespace}&name=${name}`);
+    }
+    // ===================
+    // Scale
+    // ===================
+    async scale(namespace, serviceName, replicas) {
+        return this.request('POST', `/api/k8s?namespace=${namespace}&action=scale`, {
+            name: serviceName,
+            replicas
+        });
+    }
+    // ===================
+    // Logs
+    // ===================
+    async getLogs(namespace, serviceName, lines = 100, follow = false) {
+        return this.request('GET', `/api/k8s/logs?namespace=${namespace}&serviceName=${serviceName}&lines=${lines}&follow=${follow}`);
+    }
+    async streamLogs(namespace, serviceName) {
+        const url = `${this.client.defaults.baseURL}/api/k8s/logs/stream?namespace=${namespace}&serviceName=${serviceName}`;
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'Authorization': `Bearer ${this.client.defaults.headers['Authorization']}`
+                }
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                formatter_1.OutputFormatter.error(`Failed to stream logs: ${error}`);
+                return;
+            }
+            const reader = response.body?.getReader();
+            if (!reader) {
+                formatter_1.OutputFormatter.error('Failed to read stream');
+                return;
+            }
+            const decoder = new TextDecoder();
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const text = decoder.decode(value);
+                // 解析 SSE 格式
+                const lines = text.split('\n');
+                for (const line of lines) {
+                    if (line.startsWith('data: ')) {
+                        console.log(line.slice(6));
+                    }
+                }
+            }
+        }
+        catch (error) {
+            formatter_1.OutputFormatter.error(`Stream error: ${error.message}`);
+        }
+    }
+    // ===================
+    // Pods
+    // ===================
+    async listPods(namespace, serviceName) {
+        return this.request('GET', `/api/k8s?kind=pods&namespace=${namespace}&labelSelector=app=${serviceName}`);
+    }
+    // ===================
+    // Metrics
+    // ===================
+    async getMetrics(namespace, serviceName, podName) {
+        const url = podName
+            ? `/api/k8s/metrics?namespace=${namespace}&podName=${podName}`
+            : `/api/k8s/metrics?namespace=${namespace}&serviceName=${serviceName}`;
+        return this.request('GET', url);
+    }
+    // ===================
+    // Exec
+    // ===================
+    async exec(namespace, serviceName, command, podName) {
+        let targetPod = podName;
+        // 如果没有指定 podName，自动获取第一个 pod
+        if (!targetPod) {
+            const podsResult = await this.listPods(namespace, serviceName);
+            if (!podsResult.success || !podsResult.data || podsResult.data.length === 0) {
+                return { success: false, error: { code: 'NOT_FOUND', message: 'No pods found' } };
+            }
+            const pods = Array.isArray(podsResult.data) ? podsResult.data : podsResult.data.items || [];
+            if (pods.length === 0) {
+                return { success: false, error: { code: 'NOT_FOUND', message: 'No pods found' } };
+            }
+            targetPod = pods[0].metadata?.name;
+        }
+        return this.request('POST', '/api/debug/pod-exec', {
+            namespace,
+            podName: targetPod,
+            command
+        });
+    }
+}
+exports.APIClient = APIClient;
+function createClient(connection) {
+    return new APIClient(connection);
+}

package/dist/commands/build.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 构建命令
+ */
+import { Command } from 'commander';
+export declare function makeBuildCommand(): Command;

package/dist/commands/build.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * 构建命令
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeBuildCommand = makeBuildCommand;
+const commander_1 = require("commander");
+const store_1 = require("../config/store");
+const client_1 = require("../api/client");
+const formatter_1 = require("../output/formatter");
+function makeBuildCommand() {
+    const cmd = new commander_1.Command('build')
+        .description('Build applications');
+    cmd
+        .command('<namespace> <service-name>')
+        .description('Build a service')
+        .action(async (namespace, serviceName) => {
+        const conn = store_1.configStore.getDefaultConnection();
+        if (!conn) {
+            formatter_1.OutputFormatter.error('No connection configured');
+            return;
+        }
+        const client = (0, client_1.createClient)(conn);
+        formatter_1.OutputFormatter.info('Starting build...');
+        const result = await client.build(namespace, serviceName);
+        if (!result.success) {
+            formatter_1.OutputFormatter.error(result.error.message);
+            return;
+        }
+        formatter_1.OutputFormatter.success('Build started');
+    });
+    cmd
+        .command('status <namespace> <service-name>')
+        .description('Get build status')
+        .action(async (namespace, serviceName) => {
+        const conn = store_1.configStore.getDefaultConnection();
+        if (!conn) {
+            formatter_1.OutputFormatter.error('No connection configured');
+            return;
+        }
+        const client = (0, client_1.createClient)(conn);
+        const result = await client.getBuildStatus(namespace, serviceName);
+        if (!result.success) {
+            formatter_1.OutputFormatter.error(result.error.message);
+            return;
+        }
+        const builds = result.data || [];
+        if (builds.length === 0) {
+            formatter_1.OutputFormatter.info('No builds found');
+            return;
+        }
+        const latest = builds[0];
+        formatter_1.OutputFormatter.info(`Status: ${latest.status}`);
+        formatter_1.OutputFormatter.info(`Created: ${latest.created_at}`);
+    });
+    return cmd;
+}

package/dist/commands/connect.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 连接管理命令
+ */
+import { Command } from 'commander';
+export declare function makeConnectCommand(): Command;

package/dist/commands/connect.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * 连接管理命令
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeConnectCommand = makeConnectCommand;
+const commander_1 = require("commander");
+const store_1 = require("../config/store");
+const formatter_1 = require("../output/formatter");
+function makeConnectCommand() {
+    const cmd = new commander_1.Command('connect')
+        .description('Manage connections to xuanwu platform');
+    cmd
+        .command('add <name>')
+        .description('Add a new connection')
+        .requiredOption('-e, --endpoint <url>', 'Platform API endpoint')
+        .requiredOption('-t, --token <token>', 'API token')
+        .action(async (name, options) => {
+        try {
+            store_1.configStore.addConnection({
+                name,
+                endpoint: options.endpoint,
+                token: options.token,
+                isDefault: store_1.configStore.getConnections().length === 0
+            });
+            formatter_1.OutputFormatter.success(`Connection "${name}" added`);
+        }
+        catch (error) {
+            formatter_1.OutputFormatter.error(error.message);
+        }
+    });
+    cmd
+        .command('ls')
+        .description('List all connections')
+        .action(() => {
+        const connections = store_1.configStore.getConnections();
+        if (connections.length === 0) {
+            formatter_1.OutputFormatter.info('No connections configured');
+            return;
+        }
+        formatter_1.OutputFormatter.table(['Name', 'Endpoint', 'Default'], connections.map(c => [
+            c.name,
+            c.endpoint,
+            c.isDefault ? '✓' : ''
+        ]));
+    });
+    cmd
+        .command('use <name>')
+        .description('Set default connection')
+        .action((name) => {
+        const conn = store_1.configStore.getConnection(name);
+        if (!conn) {
+            formatter_1.OutputFormatter.error(`Connection "${name}" not found`);
+            return;
+        }
+        store_1.configStore.setDefaultConnection(name);
+        formatter_1.OutputFormatter.success(`Using connection "${name}"`);
+    });
+    cmd
+        .command('rm <name>')
+        .description('Remove a connection')
+        .action((name) => {
+        store_1.configStore.removeConnection(name);
+        formatter_1.OutputFormatter.success(`Connection "${name}" removed`);
+    });
+    return cmd;
+}

package/dist/commands/deploy.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 部署命令
+ */
+import { Command } from 'commander';
+export declare function makeDeployCommand(): Command;