Node.js如何实现Travis CI与Kubernetes的Mock2Image镜像自动构建与部署？

在持续集成与容器化交付的链路里，把Mock服务做成标准镜像并自动推送到Kubernetes集群，是提升前后端联调效率的有效手段。Travis CI提供了一套HTTP API，Node.js可以非常方便地完成构建触发、参数注入和状态查询。本文围绕Mock2Image这个具体场景，拆解如何用Node.js把Travis CI的构建结果变成Kubernetes里可用的镜像资源。

一、Travis CI API 认证与 Node.js 调用基础

Travis CI 的 API v3 采用基于 token 的认证方式，token 可以从 Travis CI 的账户设置页面生成，也可以使用 Travis CLI 的 travis token 命令获取。在 Node.js 中调用时，我们需要把 token 放入请求头的 Authorization 字段，值为 token 加上空格和具体的 token 字符串。官方推荐将 token 存放在环境变量里，而不是硬编码在代码或仓库中。

以下代码使用 Node.js 内置的 https 模块发送一个简单的认证测试请求，查询当前用户信息。实际使用时可以换成 axios 或 node-fetch，但内置模块不需要额外依赖，更适合在 Travis CI 的构建环境中直接运行。

const https = require('https');
const token = process.env.TRAVIS_TOKEN;
const options = {
  hostname: 'api.travis-ci.com',
  path: '/user',
  method: 'GET',
  headers: {
    'Authorization': `token ${token}`,
    'Travis-API-Version': '3',
    'Content-Type': 'application/json'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => data += chunk);
  res.on('end', () => {
    if (res.statusCode === 200) {
      console.log('认证成功', JSON.parse(data).login);
    } else {
      console.error('认证失败，状态码', res.statusCode);
    }
  });
});
req.on('error', (err) => console.error('请求异常', err));
req.end();

需要特别注意的是，Travis CI 的 API 域名分为 travis-ci.com 和 travis-ci.org，新版项目都使用 travis-ci.com。请求头中必须添加 Travis-API-Version: 3，否则会回退到旧版接口，响应结构会有差异。认证失败通常表现为 401 或 403，此时要检查 token 是否过期以及仓库是否使用正确的 API 端点。

二、触发 Mock2Image 镜像构建并传递参数

Mock2Image 的核心思路是在 Travis CI 的构建阶段生成一个包含 Mock 接口数据的镜像，然后推送到容器仓库。Node.js 可以调用 Travis CI 的 POST /repo/{repo_slug}/requests 接口来手动触发一次构建，同时在请求体中传递环境变量或配置信息。

常见做法是把 Mock 数据源地址、接口定义文件路径、目标镜像 tag 等作为参数传给构建任务。Travis CI 的请求体支持 config 字段，可以覆盖 .travis.yml 中的部分配置，但更稳妥的方式是通过 env 字段注入环境变量。以下代码展示如何触发一个构建并设置两个环境变量 MOCK_IMAGE_TAG 和 MOCK_DATA_URL。

const https = require('https');
const token = process.env.TRAVIS_TOKEN;
const repoSlug = 'your-org/mock2image';

const payload = JSON.stringify({
  request: {
    branch: 'main',
    message: 'Triggered by Node.js pipeline',
    config: {
      env: {
        global: [
          'MOCK_IMAGE_TAG=v1.2.3',
          'MOCK_DATA_URL=https://ipipp.com/mock-data.json'
        ]
      }
    }
  }
});

const options = {
  hostname: 'api.travis-ci.com',
  path: `/repo/${encodeURIComponent(repoSlug)}/requests`,
  method: 'POST',
  headers: {
    'Authorization': `token ${token}`,
    'Travis-API-Version': '3',
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(payload)
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => data += chunk);
  res.on('end', () => {
    if (res.statusCode === 202) {
      console.log('构建已接受', data);
    } else {
      console.error('触发失败，状态码', res.statusCode, data);
    }
  });
});
req.on('error', (err) => console.error('请求异常', err));
req.write(payload);
req.end();

触发成功后 Travis CI 会返回 202 状态码，响应中包含构建请求的 id。我们需要保存这个 id，后续查询构建状态和日志时会用到。如果返回 409，说明当前已有排队中的构建，可能触发了并发限制，此时可以选择等待一段时间再重试，而不是无限循环请求。

在实际使用中，参数传递还可以通过修改 .travis.yml 文件后再推送代码的方式实现，但这种方式不够灵活，每次调整 Mock 数据源都要提交一次代码。使用 API 触发配合环境变量注入，可以做到不改变仓库内容就能控制镜像构建，更适合 Mock 场景的频繁变化。

三、将生成的镜像部署到 Kubernetes 集群

Travis CI 完成构建并推送镜像到容器仓库后，Node.js 还需要把最新的镜像版本更新到 Kubernetes 的 Deployment 中。可以使用 Kubernetes 官方提供的 @kubernetes/client-node 包，也可以直接通过 child_process 执行 kubectl 命令。对于简单的 Mock2Image 场景，使用 kubectl set image 命令更加直观。

以下代码从 Travis CI 构建产物中读取镜像 tag，然后执行 kubectl 命令更新 Deployment。这里假设镜像仓库地址为 registry.ipipp.com/mock2image，Kubernetes 命名空间为 mock。

const { execSync } = require('child_process');
const imageTag = process.env.MOCK_IMAGE_TAG || 'latest';
const namespace = 'mock';
const deployment = 'mock2image-server';
const image = `registry.ipipp.com/mock2image:${imageTag}`;

try {
  execSync(`kubectl set image deployment/${deployment} mock2image=${image} -n ${namespace}`, {
    stdio: 'inherit'
  });
  console.log(`Deployment ${deployment} 已更新为 ${image}`);
} catch (err) {
  console.error('kubectl 更新失败', err.message);
  process.exit(1);
}

如果不想依赖 kubectl CLI，也可以使用 @kubernetes/client-node。这个库通过 kubeconfig 文件认证，能在 Node.js 进程中直接调用 Kubernetes API。相比 CLI 方式，它更容易处理返回状态和 ResourceVersion 冲突。但引入该库会增加构建依赖，如果 Travis CI 运行环境已经预装了 kubectl，优先使用 execSync 会更轻量。

还需要注意镜像拉取策略。Mock2Image 镜像更新频繁，如果 Deployment 的 imagePullPolicy 设置为 IfNotPresent，而宿主机节点上已经存在同 tag 的旧镜像，kubectl set image 不会重新拉取。建议在开发环境使用 Always 策略，或者每次构建都生成唯一 tag，例如基于 git commit hash 或时间戳。

四、构建状态轮询与错误处理

调用 Travis CI 触发构建后，Node.js 不能立即执行 kubectl 更新，因为镜像可能还没有推送完成。需要轮询 Travis CI 的构建详情接口 GET /repo/{repo_slug}/builds/{build_id}，判断状态是否为 passed。以下代码展示一个简单的轮询逻辑，每隔 15 秒检查一次，最多等待 10 分钟。

const https = require('https');
const token = process.env.TRAVIS_TOKEN;
const repoSlug = 'your-org/mock2image';
const buildId = process.env.TRAVIS_BUILD_ID;

function checkBuildStatus() {
  const options = {
    hostname: 'api.travis-ci.com',
    path: `/repo/${encodeURIComponent(repoSlug)}/builds/${buildId}`,
    method: 'GET',
    headers: {
      'Authorization': `token ${token}`,
      'Travis-API-Version': '3'
    }
  };
  return new Promise((resolve, reject) => {
    const req = https.request(options, (res) => {
      let data = '';
      res.on('data', (chunk) => data += chunk);
      res.on('end', () => {
        if (res.statusCode === 200) {
          const build = JSON.parse(data);
          resolve(build.state);
        } else {
          reject(new Error(`状态码 ${res.statusCode}`));
        }
      });
    });
    req.on('error', reject);
    req.end();
  });
}

async function waitForBuild() {
  const deadline = Date.now() + 10 * 60 * 1000;
  while (Date.now() < deadline) {
    const state = await checkBuildStatus();
    console.log('当前构建状态', state);
    if (state === 'passed') {
      return true;
    }
    if (state === 'failed' || state === 'errored') {
      return false;
    }
    await new Promise((resolve) => setTimeout(resolve, 15000));
  }
  throw new Error('构建等待超时');
}

轮询结束后，需要根据构建状态决定是否继续部署。如果状态为 failed，直接终止流程并输出 Travis CI 构建日志地址，方便排查。如果构建成功但镜像尚未出现在仓库，可能是推送延迟，可以在部署前增加一次 docker pull 或镜像检查，避免 kubectl set image 因为找不到镜像而失败。

另一个常见错误是镜像回退。当新版本 Mock 数据有问题时，需要快速回退到上一个可用版本。建议在每次部署前记录当前 Deployment 的镜像 tag，存储在环境变量或注释中。如果健康检查失败，可以执行 kubectl rollout undo 回滚。Node.js 中可以通过 execSync 执行这条命令，也可以在 Kubernetes 客户端中调用 rollback 相关接口。

五、安全与令牌管理

Travis CI token 拥有触发构建和读取仓库信息的权限，一旦泄露可能被用于恶意构建。Node.js 代码中不要直接写入 token，应该从 Travis CI 的环境变量或者 Kubernetes 的 Secret 中读取。在 Travis CI 的仓库设置里勾选 Display value in build log 为 off，防止构建日志打印环境变量值。

如果 Node.js 服务运行在 Kubernetes 集群内，建议使用 Kubernetes Secret 挂载 token 文件，然后通过 fs.readFileSync 读取。以下代码展示了从挂载文件中读取 token 的简单方式。

const fs = require('fs');
const path = '/var/run/secrets/travis/token';
const token = fs.readFileSync(path, 'utf8').trim();
if (!token) {
  throw new Error('Travis token 不能为空');
}

另外，Kubernetes 部署清单中如果包含镜像仓库凭据，需要使用 Secret 类型的 imagePullSecret，避免把用户名密码写在 Deployment 的 YAML 里。Node.js 在生成或更新清单时，应该引用已有的 Secret 名称，而不是拼接明文凭据。

Node.jsTravis CIKubernetes Mock2Image修改时间：2026-10-07 00:38:41