可以通过多种方式触发持续集成 (CI) 运行:
- 当 Looker 开发者向 LookML 项目的代码库提交拉取请求时自动运行(如需了解如何设置此功能,请参阅创建持续集成套件页面)。
- 自动按周期性时间表运行(如需了解如何设置此项,请参阅创建持续集成套件页面)。
- 从 Looker IDE 手动触发 CI 套件的新运行。
- 在 Looker IDE 中手动重新运行之前的 CI 运行。
验证测试完成后,您可以查看结果,如查看持续集成运行结果文档页面中所述。
通过拉取请求自动触发
如果您已通过在收到来自 Looker 的拉取请求时触发启用了 CI 套件,那么当 Looker 开发者向您的 LookML 代码库提交拉取请求时,CI 会自动触发验证运行。(您可以选择指定仅当拉取请求针对代码库中的特定分支时才触发自动 CI 运行。)
对于自动拉取请求验证运行,CI 会验证最新的拉取请求提交,并返回相应版本的代码库中的所有错误。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
按时间表自动触发
如果您已为 CI 套件启用按时间表触发,CI 将按您指定的时间表自动触发验证运行。
对于自动安排的验证运行,CI 会验证代码库的正式版,并返回该版本中的所有错误。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
手动触发 CI 套件的新运行
拥有 see_ci 权限的 Looker 用户可以从 Looker IDE 手动触发 CI 运行。
如需手动触发 CI 套件的新运行,请按以下步骤操作:
- 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
- 点击 Suites(套装)打开 Suites(套装)页面。
- 点击要运行的 CI 套件对应的 Run suite 按钮(如果您的项目没有任何 CI 套件,您可以创建 CI 套件)。
在手动触发运行对话框中,使用工作区选项选择要验证的分支(有关详情,请参阅工作区部分):
- 如需验证 LookML 项目的生产版本,请点击 Production。
- 如果您想验证 LookML 项目的开发分支,请点击开发模式。使用分支下拉菜单选择要验证的开发分支。
如需触发 CI 套件的运行,请点击开始运行。
CI 套件可能需要几分钟才能完成运行,具体取决于项目的大小、CI 套件中包含的验证器以及 CI 套件的配置。
触发运行后,Looker IDE 将显示您触发的测试套件的运行页面。验证测试完成后,运行页面将显示每个验证器的结果。在验证测试运行期间,您可以离开运行页面,稍后再返回运行页面查看结果。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
工作区
手动触发 CI 运行后,您可以使用工作区选项来验证代码库的正式版或代码库的开发分支。
对于正式版选项,如果您想确定正式版使用的是哪个分支或提交,可以在 Looker IDE 中查看项目设置的分支管理页面中的 Git 摘要部分的默认正式版分支字段:
- 对于配置了高级部署模式的项目,生产版本是指在部署管理器中由拥有
deploy权限的 Looker 开发者选择的提交或标记。 - 对于没有高级部署模式的项目,生产版本是项目设置的项目配置页面中 Git 生产分支名称字段中配置的分支。
对于开发模式选项,请注意以下事项,以便验证项目中的开发分支:
- 如需查看 LookML 项目中的分支,并确定生产分支和开发者的个人分支,请参阅 Looker IDE 中项目的项目设置的分支管理页面。
- 如需验证开发分支,必须将开发分支推送到 LookML 代码库。在 Looker IDE 中,这意味着开发者必须点击提交更改并推送按钮,或从 IDE 的 Git 操作面板中选择提交选项。
手动重新运行之前的 CI 运行
对于已完成的运行(无论运行是成功、失败、出错还是已取消),具有 see_ci 权限的 Looker 用户可以在 Looker IDE 中手动触发 CI 运行的重新运行:
- 如果您重新运行 PR 触发的运行,持续集成会针对与原始运行相同的提交运行。
- 如果您重新运行手动触发的运行,持续集成会针对重新运行时的生产状态或分支 HEAD 运行,其中将包含自初始 CI 运行以来所做的任何后续提交。
此外,如果您自初次运行以来修改过 CI 套件,重新运行将包含您自初次运行以来对 CI 套件所做的任何更改。
如需重新运行 CI 运行,请按以下步骤操作:
- 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
- 点击运行以打开运行页面。
- 在运行页面上,点击要取消的 CI 运行对应的查看运行按钮。
- 在所选跑步活动的跑步结果页面上,点击页面顶部的重新跑按钮。
点击重新运行后,内容验证器将启动运行,并将您返回到新运行的运行页面。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
取消 CI 运行
如果您想取消正在运行的 CI 运行,可以按照以下步骤从其运行页面中取消:
- 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
- 点击运行以打开运行页面。
- 在运行页面上,点击要取消的 CI 运行对应的查看运行按钮。
- 在所选跑步活动的跑步页面上,点击页面顶部的取消按钮。
点击取消后,持续集成会取消运行,并在运行页面上显示已取消状态。