koishi-plugin-docker-control 0.0.6 → 0.0.8

package/lib/commands/cluster.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Docker Swarm 集群管理指令
+ */
+import { Context } from 'koishi';
+export declare function registerClusterCommands(ctx: Context, getService: () => any, config?: any): void;

package/lib/commands/cluster.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerClusterCommands = registerClusterCommands;
+const logger_1 = require("../utils/logger");
+const render_1 = require("../utils/render");
+function registerClusterCommands(ctx, getService, config) {
+    const useImageOutput = config?.imageOutput === true;
+    /**
+     * 查看集群信息
+     */
+    ctx.command('docker.cluster [selector]', '查看 Swarm 集群信息')
+        .alias('集群', 'swarm', 'docker集群')
+        .action(async (_, selector) => {
+        logger_1.commandLogger.debug(`docker.cluster 被调用: selector=${selector}`);
+        const service = getService();
+        if (!service)
+            return '❌ 服务未初始化';
+        const nodes = service.getNodesBySelector(selector || '');
+        if (nodes.length === 0)
+            return `❌ 未找到节点: ${selector}`;
+        const lines = [];
+        for (const node of nodes) {
+            if (node.status !== 'connected') {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (未连接)');
+                lines.push('');
+                continue;
+            }
+            // 检查是否在 Swarm 模式
+            const isSwarm = await node.isSwarmMode();
+            if (!isSwarm) {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (不在 Swarm 模式)');
+                lines.push('');
+                continue;
+            }
+            const swarmInfo = await node.getSwarmInfo();
+            if (!swarmInfo) {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (无法获取集群信息)');
+                lines.push('');
+                continue;
+            }
+            lines.push(`=== ${node.name} ===`);
+            lines.push(`  集群 ID: ${swarmInfo.id}`);
+            lines.push(`  集群名称: ${swarmInfo.name}`);
+            lines.push(`  创建时间: ${swarmInfo.createdAt}`);
+            lines.push(`  更新时间: ${swarmInfo.updatedAt}`);
+            lines.push('');
+        }
+        return lines.join('\n').trim();
+    });
+    /**
+     * 查看集群节点列表
+     */
+    ctx.command('docker.cluster.nodes [selector]', '查看 Swarm 集群节点')
+        .alias('集群节点', 'swarm节点', 'swarm节点')
+        .option('format', '-f <format> 输出格式: simple|image', { fallback: null })
+        .action(async ({ options }, selector) => {
+        logger_1.commandLogger.debug(`docker.cluster.nodes 被调用: selector=${selector}, format=${options.format}`);
+        const service = getService();
+        if (!service)
+            return '❌ 服务未初始化';
+        const nodes = service.getNodesBySelector(selector || '');
+        if (nodes.length === 0)
+            return `❌ 未找到节点: ${selector}`;
+        const format = options.format || (useImageOutput ? 'image' : 'simple');
+        // 图片渲染模式
+        if (format === 'image') {
+            if (!ctx.puppeteer)
+                return '❌ 未安装 puppeteer 插件';
+            try {
+                const results = [];
+                for (const node of nodes) {
+                    if (node.status !== 'connected')
+                        continue;
+                    const isSwarm = await node.isSwarmMode();
+                    if (!isSwarm)
+                        continue;
+                    const swarmNodes = await node.getSwarmNodes();
+                    if (swarmNodes.length > 0) {
+                        results.push({ node, swarmNodes });
+                    }
+                }
+                if (results.length === 0)
+                    return '❌ 未找到任何 Swarm 集群节点';
+                const html = (0, render_1.generateSwarmNodesHtml)(results, '集群节点');
+                return await (0, render_1.renderToImage)(ctx, html);
+            }
+            catch (e) {
+                logger_1.commandLogger.error(`获取集群节点失败: ${e.message}`);
+                return `❌ 错误: ${e.message}`;
+            }
+        }
+        // 文字模式
+        const lines = [];
+        for (const node of nodes) {
+            if (node.status !== 'connected') {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (未连接)');
+                lines.push('');
+                continue;
+            }
+            const isSwarm = await node.isSwarmMode();
+            if (!isSwarm) {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (不在 Swarm 模式)');
+                lines.push('');
+                continue;
+            }
+            const swarmNodes = await node.getSwarmNodes();
+            lines.push(`=== ${node.name} (${swarmNodes.length} 个节点) ===`);
+            if (swarmNodes.length === 0) {
+                lines.push('  (无节点)');
+            }
+            else {
+                for (const n of swarmNodes) {
+                    const shortId = n.ID.slice(0, 12);
+                    const isLeader = n.ManagerStatus?.Leader ? ' 👑' : '';
+                    const statusIcon = n.Status.State === 'ready' ? '🟢' : '🔴';
+                    lines.push(`  ${isLeader}${n.Hostname} (${n.Role})`);
+                    lines.push(`    ID: ${shortId}`);
+                    lines.push(`    状态: ${statusIcon} ${n.Status.State} | 可用性: ${n.Availability}`);
+                    lines.push(`    地址: ${n.Status.Addr}`);
+                    if (n.ManagerStatus?.Reachability) {
+                        lines.push(`    管理可达性: ${n.ManagerStatus.Reachability}`);
+                    }
+                }
+            }
+            lines.push('');
+        }
+        return lines.join('\n').trim();
+    });
+    /**
+     * 查看集群服务列表
+     */
+    ctx.command('docker.cluster.services [selector]', '查看 Swarm 集群服务')
+        .alias('集群服务', 'swarm服务', '集群services')
+        .option('format', '-f <format> 输出格式: simple|image', { fallback: null })
+        .action(async ({ options }, selector) => {
+        logger_1.commandLogger.debug(`docker.cluster.services 被调用: selector=${selector}, format=${options.format}`);
+        const service = getService();
+        if (!service)
+            return '❌ 服务未初始化';
+        const nodes = service.getNodesBySelector(selector || '');
+        if (nodes.length === 0)
+            return `❌ 未找到节点: ${selector}`;
+        const format = options.format || (useImageOutput ? 'image' : 'simple');
+        // 图片渲染模式
+        if (format === 'image') {
+            if (!ctx.puppeteer)
+                return '❌ 未安装 puppeteer 插件';
+            try {
+                const results = [];
+                for (const node of nodes) {
+                    if (node.status !== 'connected')
+                        continue;
+                    const isSwarm = await node.isSwarmMode();
+                    if (!isSwarm)
+                        continue;
+                    const services = await node.getSwarmServices();
+                    if (services.length > 0) {
+                        results.push({ node, services });
+                    }
+                }
+                if (results.length === 0)
+                    return '❌ 未找到任何 Swarm 服务';
+                const html = (0, render_1.generateSwarmServicesHtml)(results, '集群服务');
+                return await (0, render_1.renderToImage)(ctx, html);
+            }
+            catch (e) {
+                logger_1.commandLogger.error(`获取集群服务失败: ${e.message}`);
+                return `❌ 错误: ${e.message}`;
+            }
+        }
+        // 文字模式
+        const lines = [];
+        for (const node of nodes) {
+            if (node.status !== 'connected') {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (未连接)');
+                lines.push('');
+                continue;
+            }
+            const isSwarm = await node.isSwarmMode();
+            if (!isSwarm) {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (不在 Swarm 模式)');
+                lines.push('');
+                continue;
+            }
+            const services = await node.getSwarmServices();
+            lines.push(`=== ${node.name} (${services.length} 个服务) ===`);
+            if (services.length === 0) {
+                lines.push('  (无服务)');
+            }
+            else {
+                for (const s of services) {
+                    const shortId = s.ID.slice(0, 12);
+                    const imageName = s.Image.split('@')[0];
+                    lines.push(`  ${s.Name}`);
+                    lines.push(`    ID: ${shortId} | 副本: ${s.Replicas} | 镜像: ${imageName}`);
+                    if (s.Ports !== '-') {
+                        lines.push(`    端口: ${s.Ports}`);
+                    }
+                }
+            }
+            lines.push('');
+        }
+        return lines.join('\n').trim();
+    });
+    /**
+     * 查看集群服务任务
+     */
+    ctx.command('docker.cluster.ps <selector> <service>', '查看 Swarm 服务任务')
+        .alias('集群任务', 'swarm任务', 'swarmps', '集群ps')
+        .option('format', '-f <format> 输出格式: simple|image', { fallback: null })
+        .action(async ({ options }, selector, serviceName) => {
+        logger_1.commandLogger.debug(`docker.cluster.ps 被调用: selector=${selector}, service=${serviceName}`);
+        const service = getService();
+        if (!service)
+            return '❌ 服务未初始化';
+        if (!serviceName) {
+            return '⚠️ 请指定服务名称\n例如: 集群任务 yun my-service';
+        }
+        const nodes = service.getNodesBySelector(selector || '');
+        if (nodes.length === 0)
+            return `❌ 未找到节点: ${selector}`;
+        const format = options.format || (useImageOutput ? 'image' : 'simple');
+        // 图片渲染模式
+        if (format === 'image') {
+            if (!ctx.puppeteer)
+                return '❌ 未安装 puppeteer 插件';
+            try {
+                const results = [];
+                for (const node of nodes) {
+                    if (node.status !== 'connected')
+                        continue;
+                    const isSwarm = await node.isSwarmMode();
+                    if (!isSwarm)
+                        continue;
+                    const tasks = await node.getSwarmTasks(serviceName);
+                    if (tasks.length > 0) {
+                        results.push({ node, serviceName, tasks });
+                    }
+                }
+                if (results.length === 0)
+                    return `❌ 未找到服务 "${serviceName}" 的任务`;
+                const html = (0, render_1.generateSwarmTasksHtml)(results, `集群任务 - ${serviceName}`);
+                return await (0, render_1.renderToImage)(ctx, html);
+            }
+            catch (e) {
+                logger_1.commandLogger.error(`获取集群任务失败: ${e.message}`);
+                return `❌ 错误: ${e.message}`;
+            }
+        }
+        // 文字模式
+        const lines = [];
+        for (const node of nodes) {
+            if (node.status !== 'connected') {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (未连接)');
+                lines.push('');
+                continue;
+            }
+            const isSwarm = await node.isSwarmMode();
+            if (!isSwarm) {
+                lines.push(`=== ${node.name} ===`);
+                lines.push('  (不在 Swarm 模式)');
+                lines.push('');
+                continue;
+            }
+            const tasks = await node.getSwarmTasks(serviceName);
+            lines.push(`=== ${node.name} (${tasks.length} 个任务) ===`);
+            if (tasks.length === 0) {
+                lines.push(`  (服务 "${serviceName}" 无任务或不存在)`);
+            }
+            else {
+                for (const t of tasks) {
+                    const shortId = t.ID.slice(0, 12);
+                    const statusIcon = t.Status.State === 'running' ? '🟢' :
+                        t.Status.State === 'pending' ? '⏳' :
+                            t.Status.State === 'failed' ? '❌' : '⚪';
+                    lines.push(`  ${statusIcon} Slot ${t.Slot} | ${t.Status.State}`);
+                    lines.push(`    ID: ${shortId}`);
+                    lines.push(`    节点: ${t.NodeID} | 期望状态: ${t.DesiredState}`);
+                    lines.push(`    时间: ${t.Status.Since}`);
+                }
+            }
+            lines.push('');
+        }
+        return lines.join('\n').trim();
+    });
+}

package/lib/commands/control.js

@@ -48,7 +48,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.start <selector> <container>', '启动容器')
-        .alias('docker启动', '容器启动', 'docker开启', '容器开启')
+        .alias('容器启动', '启动', '容器开启')
         .option('async', '-a 异步执行，不等待结果', { fallback: false })
         .action(async ({ options }, selector, container) => {
         logger_1.commandLogger.debug(`docker.start 被调用: selector=${selector}, container=${container}`);
@@ -97,7 +97,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.stop <selector> <container>', '停止容器')
-        .alias('docker停止', '容器停止', 'docker关闭', '容器关闭')
+        .alias('容器停止', '停止', '容器关闭')
         .option('async', '-a 异步执行，不等待结果', { fallback: false })
         .action(async ({ options }, selector, container) => {
         logger_1.commandLogger.debug(`docker.stop 被调用: selector=${selector}, container=${container}`);
@@ -140,7 +140,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.restart <selector> <container>', '重启容器')
-        .alias('docker重启', '容器重启')
+        .alias('容器重启', '重启')
         .option('async', '-a 异步执行，不等待结果', { fallback: false })
         .action(async ({ options }, selector, container) => {
         logger_1.commandLogger.debug(`docker.restart 被调用: selector=${selector}, container=${container}`);
@@ -183,7 +183,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.inspect <selector> <container>', '查看容器详情')
-        .alias('docker详情', '容器详情', 'docker检查', '容器检查')
+        .alias('容器详情', '容器检查', '检查')
         .action(async (_, selector, container) => {
         const service = getService();
         if (!service) {

package/lib/commands/index.js

@@ -5,6 +5,9 @@ const list_1 = require("./list");
 const control_1 = require("./control");
 const logs_1 = require("./logs");
 const compose_1 = require("./compose");
+const resources_1 = require("./resources");
+const update_1 = require("./update");
+const cluster_1 = require("./cluster");
 const render_1 = require("../utils/render");
 /**
  * 注册所有指令
@@ -15,6 +18,9 @@ function registerCommands(ctx, getService, config) {
     (0, control_1.registerControlCommands)(ctx, getService, config);
     (0, logs_1.registerLogsCommand)(ctx, getService, config);
     (0, compose_1.registerComposeCommand)(ctx, getService, config);
+    (0, resources_1.registerResourceCommands)(ctx, getService, config);
+    (0, update_1.registerUpdateCommands)(ctx, getService);
+    (0, cluster_1.registerClusterCommands)(ctx, getService, config);
     // 注册辅助指令
     registerHelperCommands(ctx, getService, config);
 }
@@ -26,7 +32,7 @@ function registerHelperCommands(ctx, getService, config) {
     /**
      * 查看节点列表
      */
-    ctx.command('docker.nodes', '查看节点').alias('docker节点', '容器节点').action(async () => {
+    ctx.command('docker.nodes', '查看节点').alias('节点列表', '节点').action(async () => {
         const service = getService();
         if (!service) {
             return 'Docker 服务未初始化';
@@ -58,7 +64,7 @@ function registerHelperCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.node <selector>', '查看节点详情')
-        .alias('docker节点详情', '容器节点详情')
+        .alias('节点详情', '查看节点')
         .action(async (_, selector) => {
         const service = getService();
         if (!service) {
@@ -116,7 +122,7 @@ function registerHelperCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.find <container>', '搜索容器')
-        .alias('docker查找', '容器查找', 'docker搜索', '容器搜索')
+        .alias('查找容器', '搜索', '查找')
         .option('all', '-a 包含已停止的容器', { fallback: false })
         .action(async ({ options }, container) => {
         const service = getService();
@@ -145,7 +151,7 @@ function registerHelperCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.exec <container> <cmd>', '在容器中执行命令')
-        .alias('docker执行', '容器执行', 'dockerexec', 'dockercmd', 'docker命令', '容器命令')
+        .alias('容器执行', '执行')
         .option('node', '-n <node> 指定节点', { fallback: '' })
         .action(async ({ options }, container, cmd) => {
         const service = getService();
@@ -183,7 +189,7 @@ function registerHelperCommands(ctx, getService, config) {
     /**
      * 查看帮助
      */
-    ctx.command('docker.help', '查看帮助').alias('docker帮助', 'docker帮助', '容器帮助').action(async () => {
+    ctx.command('docker.help', '查看帮助').alias('帮助').action(async () => {
         return [
             '=== Docker Control 帮助 ===',
             '',
@@ -191,8 +197,8 @@ function registerHelperCommands(ctx, getService, config) {
             '  docker.nodes               - 查看节点列表',
             '  docker.node <节点>         - 查看节点详情',
             '',
-            '【容器操作】(参数顺序: 节点 容器)',
-            '  docker.ls <节点>           - 列出容器',
+            '【容器操作】',
+            '  docker.ls <节点>           - 列出容器 [-f image]',
             '  docker.start <节点> <容器> - 启动容器',
             '  docker.stop <节点> <容器>  - 停止容器',
             '  docker.restart <节点> <容器> - 重启容器',
@@ -200,11 +206,32 @@ function registerHelperCommands(ctx, getService, config) {
             '  docker.inspect <节点> <容器> - 查看容器详情',
             '  docker.exec <节点> <容器> <命令> - 在容器内执行命令',
             '',
+            '【更新操作】',
+            '  docker.check <节点> <容器> - 检查镜像更新',
+            '  docker.update <节点> <容器> [-b] - 更新容器 (-b 备份)',
+            '  docker.backup <节点> <容器> [tag] - 备份容器为镜像',
+            '  docker.set <节点> <容器> -e KEY=VALUE - 修改环境变量',
+            '',
+            '【集群操作】',
+            '  docker.cluster [节点]      - 查看 Swarm 集群信息',
+            '  docker.cluster.nodes [节点] - 查看集群节点 [-f image]',
+            '  docker.cluster.services [节点] - 查看集群服务 [-f image]',
+            '  docker.cluster.ps <节点> <服务> - 查看服务任务 [-f image]',
+            '',
+            '【资源操作】',
+            '  docker.images <节点>       - 查看镜像列表 [-f image]',
+            '  docker.networks <节点>     - 查看网络列表 [-f image]',
+            '  docker.volumes <节点>      - 查看存储卷列表 [-f image]',
+            '',
             '【节点选择器】',
             '  all        - 所有节点',
             '  @标签      - 指定标签的节点',
             '  节点ID/名称 - 指定单个节点',
             '',
+            '【输出格式】',
+            '  -f simple   - 文本格式（默认）',
+            '  -f image    - 图片格式（需要 puppeteer 插件）',
+            '',
             '【通知事件类型】',
             '  container.start/stop/restart/die',
             '  container.health_status',

package/lib/commands/list.js

@@ -8,7 +8,7 @@ function registerListCommand(ctx, getService, config) {
     const useImageOutput = config?.imageOutput === true;
     ctx
         .command('docker.ls [selector]', '列出容器')
-        .alias('docker列表', '容器列表', 'dockercs', '容器查看', 'docker查看')
+        .alias('容器列表', '查看容器', '列表')
         .option('all', '-a 列出所有容器，包括已停止', { fallback: false })
         .option('format', '-f <format> 输出格式: simple|detail|json|image', {
         fallback: null, // 由 config.imageOutput 决定

package/lib/commands/logs.js

@@ -16,7 +16,7 @@ function registerLogsCommand(ctx, getService, config) {
     const useImageOutput = config?.imageOutput === true;
     ctx
         .command('docker.logs <node> <container>', '查看容器日志')
-        .alias('docker日志', '容器日志', 'docker查看日志', '容器查看日志', 'dockerlogs')
+        .alias('容器日志', '查看日志', '日志')
         .option('lines', '-n <lines:number> 显示最后 N 行')
         .option('timestamp', '-t 显示时间戳')
         .option('all', '-a 显示全部（不截断）')

package/lib/commands/resources.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 资源列表指令（镜像、网络、存储卷）
+ */
+import { Context } from 'koishi';
+export declare function registerResourceCommands(ctx: Context, getService: () => any, config?: any): void;