@nexusgpu/repterm-plugin-kubectl 0.1.0

package/dist/plugin-kubectl/examples/02-debugging.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 示例 2: 日志与调试
+ *
+ * 演示 kubectl 插件的调试 API：logs, exec, describe
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/02-debugging.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+export {};
+//# sourceMappingURL=02-debugging.d.ts.map

package/dist/plugin-kubectl/examples/02-debugging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"02-debugging.d.ts","sourceRoot":"","sources":["../../../examples/02-debugging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/plugin-kubectl/examples/02-debugging.js

@@ -0,0 +1,80 @@
+/**
+ * 示例 2: 日志与调试
+ *
+ * 演示 kubectl 插件的调试 API：logs, exec, describe
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/02-debugging.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+import { describe, defineConfig, createTestWithPlugins, } from '../../repterm/src/index.js';
+import { kubectlPlugin } from '../src/index.js';
+// 配置插件
+const config = defineConfig({
+    plugins: [kubectlPlugin({ namespace: 'default' })],
+});
+const test = createTestWithPlugins(config);
+// 测试用 Pod
+const debugPodYaml = `
+apiVersion: v1
+kind: Pod
+metadata:
+  name: debug-pod
+  labels:
+    app: debug
+spec:
+  containers:
+  - name: main
+    image: busybox
+    command: ['sh', '-c', 'echo "Container started"; while true; do echo "heartbeat $(date)"; sleep 5; done']
+`;
+describe('日志与调试 API', () => {
+    // 准备测试环境
+    test('准备: 创建测试 Pod', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.apply(debugPodYaml);
+        await kubectl.waitForPod('debug-pod', 'Running', 60000);
+    });
+    // ===== logs - 获取 Pod 日志 =====
+    test('logs - 获取 Pod 日志', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 基础日志获取
+        const logs = await kubectl.logs('debug-pod');
+    });
+    test('logs - 带选项获取日志', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用 tail 选项限制行数
+        await kubectl.logs('debug-pod', { tail: 5 });
+        // 使用 since 选项按时间过滤
+        await kubectl.logs('debug-pod', { since: '1m' });
+    });
+    // ===== exec - 在 Pod 中执行命令 =====
+    test('exec - 执行简单命令', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 执行单个命令
+        await kubectl.exec('debug-pod', 'hostname');
+    });
+    test('exec - 执行复杂命令', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 执行 shell 命令
+        await kubectl.exec('debug-pod', ['sh', '-c', 'ls -la / && echo "done"']);
+    });
+    // ===== describe - 获取资源描述 =====
+    test('describe - 获取 Pod 描述', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 获取详细描述
+        const description = await kubectl.describe('pod', 'debug-pod');
+    });
+    test('describe - 获取所有 Pods 描述', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 不指定名称，获取所有资源的描述
+        await kubectl.describe('pods');
+    });
+    // 清理
+    test('清理: 删除测试 Pod', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.delete('pod', 'debug-pod', { force: true });
+    });
+});

package/dist/plugin-kubectl/examples/03-resource-management.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 示例 3: 资源管理
+ *
+ * 演示 kubectl 插件的资源管理 API：scale, patch, label, annotate, wait, waitForReplicas
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/03-resource-management.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+export {};
+//# sourceMappingURL=03-resource-management.d.ts.map

package/dist/plugin-kubectl/examples/03-resource-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"03-resource-management.d.ts","sourceRoot":"","sources":["../../../examples/03-resource-management.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/plugin-kubectl/examples/03-resource-management.js

@@ -0,0 +1,134 @@
+/**
+ * 示例 3: 资源管理
+ *
+ * 演示 kubectl 插件的资源管理 API：scale, patch, label, annotate, wait, waitForReplicas
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/03-resource-management.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+import { describe, defineConfig, createTestWithPlugins, } from '../../repterm/src/index.js';
+import { kubectlPlugin } from '../src/index.js';
+// 配置插件
+const config = defineConfig({
+    plugins: [kubectlPlugin({ namespace: 'default' })],
+});
+const test = createTestWithPlugins(config);
+// 测试用 Deployment
+const nginxDeploymentYaml = `
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: nginx-deploy
+  labels:
+    app: nginx
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app: nginx
+  template:
+    metadata:
+      labels:
+        app: nginx
+    spec:
+      containers:
+      - name: nginx
+        image: nginx:1.21-alpine
+        ports:
+        - containerPort: 80
+`;
+describe('资源管理 API', () => {
+    // 准备测试环境
+    test('准备: 创建测试 Deployment', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.apply(nginxDeploymentYaml);
+        // 等待 Deployment 就绪
+        await kubectl.wait('deployment', 'nginx-deploy', 'Available', { timeout: 120000 });
+    });
+    // ===== scale - 扩缩容 =====
+    test('scale - 扩展副本数', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用 scale API 扩展到 3 个副本
+        await kubectl.scale('deployment', 'nginx-deploy', 3);
+        // 等待副本就绪
+        await kubectl.waitForReplicas('deployment', 'nginx-deploy', 3, 60000);
+    });
+    test('scale - 缩减副本数', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.scale('deployment', 'nginx-deploy', 1);
+    });
+    // ===== label - 管理标签 =====
+    test('label - 添加标签', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用 label API 添加标签
+        await kubectl.label('deployment', 'nginx-deploy', {
+            env: 'production',
+            team: 'platform',
+        });
+        // 验证
+        const deploy = await kubectl.get('deployment', 'nginx-deploy');
+        if (deploy.metadata.labels.env !== 'production') {
+            throw new Error('Label env not set correctly');
+        }
+    });
+    test('label - 删除标签', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用 null 值删除标签
+        await kubectl.label('deployment', 'nginx-deploy', {
+            team: null, // 删除 team 标签
+        });
+    });
+    // ===== annotate - 管理注解 =====
+    test('annotate - 添加注解', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.annotate('deployment', 'nginx-deploy', {
+            'description': 'Test deployment for kubectl plugin',
+            'owner': 'test-team',
+        });
+    });
+    test('annotate - 删除注解', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.annotate('deployment', 'nginx-deploy', {
+            'owner': null, // 删除 owner 注解
+        });
+    });
+    // ===== patch - 补丁更新 =====
+    test('patch - Strategic Merge Patch', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用对象形式的 patch
+        await kubectl.patch('deployment', 'nginx-deploy', {
+            spec: {
+                template: {
+                    spec: {
+                        containers: [{
+                                name: 'nginx',
+                                resources: {
+                                    limits: { memory: '128Mi' },
+                                },
+                            }],
+                    },
+                },
+            },
+        }, 'strategic');
+    });
+    test('patch - JSON Patch', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用 JSON Patch 格式
+        await kubectl.patch('deployment', 'nginx-deploy', [
+            { op: 'replace', path: '/spec/replicas', value: 2 },
+        ], 'json');
+    });
+    // ===== wait - 等待条件 =====
+    test('wait - 等待 Deployment Available', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.wait('deployment', 'nginx-deploy', 'Available', { timeout: 60000 });
+    });
+    // 清理
+    test('清理: 删除测试 Deployment', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.delete('deployment', 'nginx-deploy', { force: true });
+    });
+});

package/dist/plugin-kubectl/examples/04-rollout.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 示例 4: 发布管理 (Rollout)
+ *
+ * 演示 kubectl 插件的 rollout API：status, history, restart, undo, pause, resume
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/04-rollout.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+export {};
+//# sourceMappingURL=04-rollout.d.ts.map

package/dist/plugin-kubectl/examples/04-rollout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"04-rollout.d.ts","sourceRoot":"","sources":["../../../examples/04-rollout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/plugin-kubectl/examples/04-rollout.js

@@ -0,0 +1,122 @@
+/**
+ * 示例 4: 发布管理 (Rollout)
+ *
+ * 演示 kubectl 插件的 rollout API：status, history, restart, undo, pause, resume
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/04-rollout.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+import { describe, defineConfig, createTestWithPlugins, } from '../../repterm/src/index.js';
+import { kubectlPlugin } from '../src/index.js';
+// 配置插件
+const config = defineConfig({
+    plugins: [kubectlPlugin({ namespace: 'default' })],
+});
+const test = createTestWithPlugins(config);
+// 测试用 Deployment
+const appDeploymentYaml = `
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: app-deploy
+  annotations:
+    kubernetes.io/change-cause: "Initial deployment"
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app: myapp
+  template:
+    metadata:
+      labels:
+        app: myapp
+    spec:
+      containers:
+      - name: app
+        image: nginx:1.20-alpine
+        ports:
+        - containerPort: 80
+`;
+describe('发布管理 (Rollout) API', () => {
+    // 准备测试环境
+    test('准备: 创建测试 Deployment', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.apply(appDeploymentYaml);
+        await kubectl.wait('deployment', 'app-deploy', 'Available', { timeout: 120000 });
+    });
+    // ===== rollout.status - 获取发布状态 =====
+    test('rollout.status - 获取发布状态', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        const status = await kubectl.rollout.status('deployment', 'app-deploy');
+    });
+    // ===== rollout.history - 获取发布历史 =====
+    test('rollout.history - 获取发布历史', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        const history = await kubectl.rollout.history('deployment', 'app-deploy');
+        for (const entry of history) {
+        }
+    });
+    // ===== rollout.restart - 重启 Deployment =====
+    test('rollout.restart - 重启 Deployment', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.rollout.restart('deployment', 'app-deploy');
+        // 等待重启完成
+        await kubectl.wait('deployment', 'app-deploy', 'Available', { timeout: 120000 });
+    });
+    // ===== rollout.pause / resume - 暂停/恢复发布 =====
+    test('rollout.pause - 暂停发布', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.rollout.pause('deployment', 'app-deploy');
+    });
+    test('rollout.resume - 恢复发布', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.rollout.resume('deployment', 'app-deploy');
+    });
+    // 触发新版本以便测试回滚
+    test('触发镜像更新', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用 patch 更新镜像
+        await kubectl.patch('deployment', 'app-deploy', {
+            spec: {
+                template: {
+                    spec: {
+                        containers: [{
+                                name: 'app',
+                                image: 'nginx:1.21-alpine',
+                            }],
+                    },
+                },
+            },
+        });
+        // 添加变更原因注解
+        await kubectl.annotate('deployment', 'app-deploy', {
+            'kubernetes.io/change-cause': 'Update to nginx:1.21',
+        });
+        await kubectl.wait('deployment', 'app-deploy', 'Available', { timeout: 120000 });
+    });
+    // ===== rollout.undo - 回滚 =====
+    test('rollout.undo - 回滚到上一版本', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.rollout.undo('deployment', 'app-deploy');
+        await kubectl.wait('deployment', 'app-deploy', 'Available', { timeout: 120000 });
+    });
+    test('rollout.undo - 回滚到指定版本', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 获取历史，找到可用的版本
+        const history = await kubectl.rollout.history('deployment', 'app-deploy');
+        if (history.length > 1) {
+            const targetRevision = history[0].revision;
+            await kubectl.rollout.undo('deployment', 'app-deploy', targetRevision);
+        }
+        else {
+        }
+    });
+    // 清理
+    test('清理: 删除测试 Deployment', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.delete('deployment', 'app-deploy', { force: true });
+    });
+});

package/dist/plugin-kubectl/examples/05-matchers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 示例 5: K8s Matchers
+ *
+ * 演示 kubectl 插件的 expect matchers：
+ * toExistInCluster, toBeRunning, toHavePhase, toHaveReplicas,
+ * toHaveAvailableReplicas, toBeAvailable, toHaveLabel, toHaveAnnotation, toHaveCondition
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/05-matchers.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+export {};
+//# sourceMappingURL=05-matchers.d.ts.map

package/dist/plugin-kubectl/examples/05-matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"05-matchers.d.ts","sourceRoot":"","sources":["../../../examples/05-matchers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/plugin-kubectl/examples/05-matchers.js

@@ -0,0 +1,138 @@
+/**
+ * 示例 5: K8s Matchers
+ *
+ * 演示 kubectl 插件的 expect matchers：
+ * toExistInCluster, toBeRunning, toHavePhase, toHaveReplicas,
+ * toHaveAvailableReplicas, toBeAvailable, toHaveLabel, toHaveAnnotation, toHaveCondition
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/05-matchers.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+import { describe, defineConfig, createTestWithPlugins, expect, } from 'repterm';
+import { kubectlPlugin, pod, deployment, registerK8sMatchers } from '../src/index.js';
+// 注册 K8s matchers
+registerK8sMatchers();
+// 配置插件
+const config = defineConfig({
+    plugins: [kubectlPlugin({ namespace: 'default' })],
+});
+const test = createTestWithPlugins(config);
+// 测试资源 YAML
+const testPodYaml = `
+apiVersion: v1
+kind: Pod
+metadata:
+  name: matcher-pod
+  labels:
+    app: matcher-test
+    env: test
+  annotations:
+    description: Test pod for matchers
+spec:
+  containers:
+  - name: nginx
+    image: nginx:alpine
+`;
+const testDeploymentYaml = `
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: matcher-deploy
+  labels:
+    app: matcher-deploy
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app: matcher-deploy
+  template:
+    metadata:
+      labels:
+        app: matcher-deploy
+    spec:
+      containers:
+      - name: nginx
+        image: nginx:alpine
+`;
+describe('K8s Matchers', () => {
+    // 准备测试资源
+    test('准备: 创建测试资源', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.apply(testPodYaml);
+        await kubectl.apply(testDeploymentYaml);
+        await kubectl.waitForPod('matcher-pod', 'Running', 60000);
+        await kubectl.wait('deployment', 'matcher-deploy', 'Available', { timeout: 120000 });
+    });
+    // ===== toExistInCluster - 验证资源存在 =====
+    test('toExistInCluster - 验证 Pod 存在', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 使用 pod() helper 创建资源包装器
+        await expect(pod(kubectl, 'matcher-pod')).toExistInCluster();
+    });
+    test('toExistInCluster - 验证 Deployment 存在', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(deployment(kubectl, 'matcher-deploy')).toExistInCluster();
+    });
+    // ===== toBeRunning - 验证 Pod Running =====
+    test('toBeRunning - 验证 Pod Running 状态', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(pod(kubectl, 'matcher-pod')).toBeRunning();
+    });
+    // ===== toHavePhase - 验证 Pod 阶段 =====
+    test('toHavePhase - 验证 Pod 阶段', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(pod(kubectl, 'matcher-pod')).toHavePhase('Running');
+    });
+    // ===== toHaveReplicas - 验证副本数 =====
+    test('toHaveReplicas - 验证 Deployment 副本数', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(deployment(kubectl, 'matcher-deploy')).toHaveReplicas(2);
+    });
+    // ===== toHaveAvailableReplicas - 验证可用副本数 =====
+    test('toHaveAvailableReplicas - 验证可用副本数', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(deployment(kubectl, 'matcher-deploy')).toHaveAvailableReplicas(2);
+    });
+    // ===== toBeAvailable - 验证 Deployment 可用 =====
+    test('toBeAvailable - 验证 Deployment 可用', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(deployment(kubectl, 'matcher-deploy')).toBeAvailable();
+    });
+    // ===== toHaveLabel - 验证标签 =====
+    test('toHaveLabel - 验证 Pod 标签存在', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 只检查标签是否存在
+        await expect(pod(kubectl, 'matcher-pod')).toHaveLabel('app');
+    });
+    test('toHaveLabel - 验证 Pod 标签值', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        // 检查标签的具体值
+        await expect(pod(kubectl, 'matcher-pod')).toHaveLabel('app', 'matcher-test');
+        await expect(pod(kubectl, 'matcher-pod')).toHaveLabel('env', 'test');
+    });
+    // ===== toHaveAnnotation - 验证注解 =====
+    test('toHaveAnnotation - 验证 Pod 注解', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(pod(kubectl, 'matcher-pod')).toHaveAnnotation('description');
+        await expect(pod(kubectl, 'matcher-pod')).toHaveAnnotation('description', 'Test pod for matchers');
+    });
+    // ===== toHaveCondition - 验证条件 =====
+    test('toHaveCondition - 验证 Deployment 条件', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(deployment(kubectl, 'matcher-deploy')).toHaveCondition('Available', 'True');
+    });
+    // ===== not. 否定断言 =====
+    test('not.toExistInCluster - 验证资源不存在', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await expect(pod(kubectl, 'non-existent-pod')).not.toExistInCluster();
+    });
+    // 清理
+    test('清理: 删除测试资源', async (ctx) => {
+        const { kubectl } = ctx.plugins;
+        await kubectl.delete('pod', 'matcher-pod', { force: true });
+        await kubectl.delete('deployment', 'matcher-deploy', { force: true });
+    });
+});

package/dist/plugin-kubectl/examples/06-advanced.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 示例 6: 进阶功能
+ *
+ * 演示 kubectl 插件的进阶 API：
+ * portForward, waitForService, getEvents, getNodes, cp
+ *
+ * 运行方式:
+ *   bun run repterm packages/plugin-kubectl/examples/06-advanced.ts
+ *
+ * 前置条件:
+ *   - 已配置 kubectl 并连接到 Kubernetes 集群
+ */
+export {};
+//# sourceMappingURL=06-advanced.d.ts.map

package/dist/plugin-kubectl/examples/06-advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"06-advanced.d.ts","sourceRoot":"","sources":["../../../examples/06-advanced.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}