将 MeterSphere 集成到流水线
- 准备工作
- 动手实验

将 MeterSphere 集成到流水线

本教程演示如何将 MeterSphere 集成到流水线。

准备工作

您需要启用 KubeSphere DevOps 系统。
您需要在 KubeSphere 上部署 MeterSphere。
您需要创建一个企业空间、一个 DevOps 工程和一个帐户 (project-regular)。需要邀请该帐户至 DevOps 工程并赋予 operator 角色。如果尚未创建，请参见创建企业空间、项目、帐户和角色。

动手实验

步骤 1：在 MeterSphere 上创建 API Keys

登录 MeterSphere 控制台。访问个人信息下的 API Keys，点击新建来创建 API Keys。
API Keys 创建好之后，您可以进行查看。复制 Access Key。
点击 Secret Key 下的显示并复制 Secret Key。

步骤 2：在 Jenkins 上安装 MeterSphere 插件

登录 Jenkins 控制台，点击 Manage Jenkins。有关如何登录 Jenkins 控制台的更多信息，请参考将 SonarQube 集成到流水线。
在 Manage Jenkins 页面，下滑至 Manage Plugins 并点击。
访问高级选项卡，下滑至上传插件。点击文件旁边的按钮上传 MeterSphere 插件的 HPI 文件。
上传 HPI 文件之后，点击上传以继续。
您可以在页面上看到安装状态，请确保选择安装完成后重启 Jenkins（空闲时）。安装成功后，Jenkins 会重启。
待 Jenkins 完成重启，请登录并再次访问 Manage Jenkins 中的 Manage Plugins。在已安装选项卡，可以看到已安装 MeterSphere 插件。

步骤 3：生成流水线代码段

点击新建Item 创建条目。
将条目名称设为 metersphere-test，选择流水线。点击确定继续。
在本教程中，直接点击保存使用默认设置。
在 Pipeline metersphere-test 页面，点击流水线语法。
在步骤下，选择范例步骤下拉菜单中的 meterSphere: MeterSphere。
输入上述步骤中创建的 MeterSphere API Keys 以及 API Endpoint http://NodeIP:NodePort。您可以在下拉菜单中设置其他的值，然后点击生成流水线脚本。

备注

本教程使用 MeterSphere 的 demo-workspace 工作空间和 demo 项目进行演示。您首先需要创建工作空间和项目，并在 MeterSphere 上配置测试用例，否则上图所示的下拉列表里将没有可选的条目。有关如何使用 MeterSphere 的更多信息，请参考 MeterSphere GitHub 网站。
您将看到以下输出：

步骤 4：创建流水线

以 project-regular 身份登录 KubeSphere 的 Web 控制台。在 DevOps 工程中，访问流水线，然后点击创建。
将名称设置为 metersphere-pipeline，点击下一步。在高级设置页面，点击创建使用默认配置。
点击列表中的流水线访问其详情页，然后点击编辑 Jenkinsfile。

在出现的对话框中，根据之前的步骤中 Jenkins 生成的代码段输入以下流水线代码，然后点击确定。

node('base') {
    stage('stage-zewwa') {
      meterSphere method: 'single',
      msAccessKey: 'O4baJHYpybhPizFS',
      msEndpoint: 'http://103.61.37.135:31397/',
      msSecretKey: 'tIKidlPrpZFJgGl9',
      projectId: 'e72714e2-dfc5-4370-a9bc-f17e596caf66',
      result: 'jenkins',
      testCaseId: '2fc3210b-6c99-4633-9701-1a8941640018',
      testPlanId: '',
      workspaceId: 'f9dbbadb-0d0c-4d2e-bf6d-0e996d92899d'
     }
}

备注

请确保将以下字段的值更改为您在 Jenkins 控制台上生成的值： msAccessKey、msSecretKey、msEndpoint、projectId、testCaseId 和 workspaceId。

点击运行来运行流水线。
稍等片刻，您可以在活动选项卡下看到流水线的状态变为成功。点击该流水线查看其详情。
在详情页，您可以点击右上角的显示日志来查看日志。
您可以在 MeterSphere 的控制台上查看测试报告，点击测试报告可查看其详情。