xuanwu-cli 1.0.0

package/docs//345/276/205/344/274/230/345/214/226.md

@@ -0,0 +1,89 @@
+# CLI 待优化清单
+
+**更新日期**: 2026-03-10
+**状态**: 需要修改 API 端点
+
+---
+
+## 一、需要修改的 API 端点
+
+### 服务删除 API 路径变更
+
+**原因**: 后端路由冲突，已将服务删除 API 迁移到新路径
+
+| 命令 | 旧端点 | 新端点 |
+|------|--------|--------|
+| `xuanwu svc rm <namespace> <name>` | `DELETE /api/services/[ns]/[name]` | `DELETE /api/services/by-ns/[ns]/[name]` |
+
+---
+
+## 二、CLI 代码修改位置
+
+需要修改 CLI 中调用服务删除 API 的代码，将端点从：
+```
+/api/services/${namespace}/${name}
+```
+改为：
+```
+/api/services/by-ns/${namespace}/${name}
+```
+
+### 修改示例
+
+```typescript
+// 旧代码
+const response = await fetch(`${endpoint}/api/services/${namespace}/${name}`, {
+  method: 'DELETE',
+  headers: { 'Authorization': `Bearer ${token}` }
+})
+
+// 新代码
+const response = await fetch(`${endpoint}/api/services/by-ns/${namespace}/${name}`, {
+  method: 'DELETE',
+  headers: { 'Authorization': `Bearer ${token}` }
+})
+```
+
+---
+
+## 三、验证命令
+
+修改完成后，使用以下命令验证：
+
+```bash
+# 部署测试服务
+xuanwu deploy test-ns test-delete --image nginx:latest
+
+# 删除服务（验证新端点）
+xuanwu svc rm test-ns test-delete
+```
+
+预期结果：返回 `{ "success": true }`
+
+---
+
+## 四、API 端点完整映射（更新后）
+
+| CLI 命令 | API 端点 | 状态 |
+|---------|---------|------|
+| env ls | GET /api/deploy-spaces | ✅ |
+| env create | POST /api/deploy-spaces | ✅ |
+| env rm | DELETE /api/deploy-spaces/[id] | ✅ |
+| deploy | POST /api/services | ✅ |
+| svc ls | GET /api/k8s?kind=deployments | ✅ |
+| svc status | GET /api/k8s/deployments/[name] | ✅ |
+| **svc rm** | **DELETE /api/services/by-ns/[ns]/[name]** | **🔄 需修改** |
+| scale | POST /api/k8s?action=scale | ✅ |
+| logs | GET /api/k8s/logs | ✅ |
+| logs -f | GET /api/k8s/logs/stream | ✅ |
+| pods | GET /api/k8s?kind=pods | ✅ |
+| top | GET /api/k8s/metrics | ✅ |
+| exec | POST /api/debug/pod-exec | ✅ |
+
+---
+
+## 五、后端已完成
+
+- [x] 创建新路由 `/api/services/by-ns/[namespace]/[name]`
+- [x] 实现 DELETE 方法
+- [x] 构建验证通过

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "xuanwu-cli",
+  "version": "1.0.0",
+  "description": "玄武工厂平台 CLI 工具",
+  "main": "dist/index.js",
+  "bin": {
+    "xuanwu": "./bin/xuanwu"
+  },
+  "keywords": [
+    "cli",
+    "kubernetes",
+    "devops"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "inquirer": "^9.2.12",
+    "axios": "^1.6.5"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  }
+}

package/src/api/client.ts

@@ -0,0 +1,380 @@
+/**
+ * API 客户端
+ */
+
+import axios, { AxiosInstance, AxiosRequestConfig } from 'axios'
+import { Connection, CLIResult, ServiceInfo, NamespaceInfo, DeployOptions } from '../config/types'
+import { OutputFormatter } from '../output/formatter'
+
+export class APIClient {
+  private client: AxiosInstance
+
+  constructor(connection: Connection) {
+    this.client = axios.create({
+      baseURL: connection.endpoint,
+      headers: {
+        'Authorization': `Bearer ${connection.token}`,
+        'Content-Type': 'application/json'
+      },
+      timeout: 30000
+    })
+  }
+
+  private async request<T>(method: string, url: string, data?: any, config?: AxiosRequestConfig): Promise<CLIResult<T>> {
+    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: any) {
+      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(): Promise<CLIResult<NamespaceInfo[]>> {
+    return this.request<NamespaceInfo[]>('GET', '/api/deploy-spaces')
+  }
+
+  async createNamespace(name: string): Promise<CLIResult<any>> {
+    return this.request('POST', '/api/deploy-spaces', {
+      name,
+      identifier: name,
+      namespace: name,
+      environment: 'development'
+    })
+  }
+
+  async deleteNamespace(id: string): Promise<CLIResult<void>> {
+    return this.request('DELETE', `/api/deploy-spaces/${id}`)
+  }
+
+  async getNamespaceInfo(identifier: string): Promise<CLIResult<any>> {
+    return this.request('GET', `/api/deploy-spaces?identifier=${identifier}`)
+  }
+
+  async getProjects(): Promise<CLIResult<any[]>> {
+    return this.request<any[]>('GET', '/api/projects')
+  }
+
+  async createNamespaceWithProject(name: string, projectId: string, environment: string = 'development'): Promise<CLIResult<any>> {
+    return this.request('POST', '/api/deploy-spaces', {
+      name,
+      identifier: name,
+      namespace: name,
+      environment,
+      project_id: projectId
+    })
+  }
+
+  // ===================
+  // Service
+  // ===================
+
+  async listServices(namespace: string): Promise<CLIResult<ServiceInfo[]>> {
+    return this.request<any[]>('GET', `/api/k8s?kind=deployments&namespace=${namespace}`)
+  }
+
+  async getServiceStatus(namespace: string, name: string): Promise<CLIResult<any>> {
+    return this.request('GET', `/api/k8s/deployments/${name}?namespace=${namespace}`)
+  }
+
+  async deleteService(namespace: string, name: string): Promise<CLIResult<void>> {
+    return this.request('DELETE', `/api/services/by-ns/${namespace}/${name}`)
+  }
+
+  // ===================
+  // Deploy
+  // ===================
+
+  async deploy(options: DeployOptions): Promise<CLIResult<any>> {
+    const { namespace, serviceName, type, ...rest } = options
+    
+    // 获取 namespace 对应的 project_id
+    let projectId: string | undefined
+    
+    // 尝试通过 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 as any[]).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: any = {
+      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)
+  }
+
+  private getDefaultPort(dbType: string): number {
+    const ports: Record<string, number> = {
+      mysql: 3306,
+      redis: 6379,
+      postgres: 5432,
+      elasticsearch: 9200
+    }
+    return ports[dbType] || 3306
+  }
+
+  // ===================
+  // Build
+  // ===================
+
+  async build(namespace: string, serviceName: string): Promise<CLIResult<any>> {
+    // 先获取服务 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 as any
+    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: string, serviceName: string): Promise<CLIResult<any>> {
+    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 as any
+    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`)
+  }
+
+  private async getServiceByName(namespace: string, name: string): Promise<CLIResult<any>> {
+    return this.request('GET', `/api/services?project_id=${namespace}&name=${name}`)
+  }
+
+  // ===================
+  // Scale
+  // ===================
+
+  async scale(namespace: string, serviceName: string, replicas: number): Promise<CLIResult<any>> {
+    return this.request('POST', `/api/k8s?namespace=${namespace}&action=scale`, {
+      name: serviceName,
+      replicas
+    })
+  }
+
+  // ===================
+  // Logs
+  // ===================
+
+  async getLogs(namespace: string, serviceName: string, lines: number = 100, follow: boolean = false): Promise<CLIResult<any>> {
+    return this.request('GET', `/api/k8s/logs?namespace=${namespace}&serviceName=${serviceName}&lines=${lines}&follow=${follow}`)
+  }
+
+  async streamLogs(namespace: string, serviceName: string): Promise<void> {
+    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()
+        OutputFormatter.error(`Failed to stream logs: ${error}`)
+        return
+      }
+
+      const reader = response.body?.getReader()
+      if (!reader) {
+        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: any) {
+      OutputFormatter.error(`Stream error: ${error.message}`)
+    }
+  }
+
+  // ===================
+  // Pods
+  // ===================
+
+  async listPods(namespace: string, serviceName: string): Promise<CLIResult<any>> {
+    return this.request('GET', `/api/k8s?kind=pods&namespace=${namespace}&labelSelector=app=${serviceName}`)
+  }
+
+  // ===================
+  // Metrics
+  // ===================
+
+  async getMetrics(namespace: string, serviceName: string, podName?: string): Promise<CLIResult<any>> {
+    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: string, serviceName: string, command: string, podName?: string): Promise<CLIResult<any>> {
+    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
+    })
+  }
+}
+
+export function createClient(connection: Connection): APIClient {
+  return new APIClient(connection)
+}

package/src/commands/build.ts

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

package/src/commands/connect.ts

@@ -0,0 +1,75 @@
+/**
+ * 连接管理命令
+ */
+
+import { Command } from 'commander'
+import { configStore } from '../config/store'
+import { OutputFormatter } from '../output/formatter'
+import { createClient } from '../api/client'
+
+export function makeConnectCommand(): Command {
+  const cmd = new 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 {
+        configStore.addConnection({
+          name,
+          endpoint: options.endpoint,
+          token: options.token,
+          isDefault: configStore.getConnections().length === 0
+        })
+        OutputFormatter.success(`Connection "${name}" added`)
+      } catch (error: any) {
+        OutputFormatter.error(error.message)
+      }
+    })
+
+  cmd
+    .command('ls')
+    .description('List all connections')
+    .action(() => {
+      const connections = configStore.getConnections()
+      if (connections.length === 0) {
+        OutputFormatter.info('No connections configured')
+        return
+      }
+
+      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 = configStore.getConnection(name)
+      if (!conn) {
+        OutputFormatter.error(`Connection "${name}" not found`)
+        return
+      }
+      configStore.setDefaultConnection(name)
+      OutputFormatter.success(`Using connection "${name}"`)
+    })
+
+  cmd
+    .command('rm <name>')
+    .description('Remove a connection')
+    .action((name) => {
+      configStore.removeConnection(name)
+      OutputFormatter.success(`Connection "${name}" removed`)
+    })
+
+  return cmd
+}