持续集成 (CI) 运行可通过多种方式触发:
- 当 Looker 开发者向 LookML 项目的代码库提交拉取请求时,自动运行(如需了解如何设置,请参阅创建持续集成套件页面)。
- 在向导入的 LookML 项目提交拉取请求时自动运行(如需了解如何设置此功能,请参阅创建持续集成套件页面)。
- 在 dbt Cloud CI 作业完成时自动运行(如需了解如何设置,请参阅创建持续集成套件页面)。
- 自动按周期性时间表运行(如需了解如何设置,请参阅创建持续集成套件页面)。
- 从 Looker IDE 手动触发 CI 套件的新运行。
- 从 Looker IDE 手动重新运行之前的 CI 运行。
验证测试完成后,您可以查看结果,如查看持续集成运行结果文档页面中所述。
通过拉取请求自动触发
如果您已为 CI 套件启用在收到来自 Looker 的拉取请求时触发,那么当 Looker 开发者向您的 LookML 代码库提交拉取请求时,CI 将自动触发验证运行。(您可以选择指定仅针对代码库中的特定分支的拉取请求应触发自动 CI 运行。)
对于自动拉取请求验证运行,CI 会验证最新的拉取请求提交,并返回该版本代码库中的所有错误。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
通过导入项目的拉取请求自动触发
如果您在下游(spoke)项目中启用了 CI 套件,并选择了在导入的项目中收到拉取请求时触发,那么当开发者在订阅的上游(hub)项目代码库中打开或更新拉取请求时,CI 会自动在 spoke 项目中触发验证运行。
在由导入的项目拉取请求触发的 CI 运行期间,Looker 会执行以下操作:
- 验证 spoke 项目的正式版,同时将导入的 hub 项目临时固定到拉取请求提交。
- 将 spoke 项目的 CI 运行结果写回 hub 项目代码库中的拉取请求。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
从 dbt Cloud 自动触发
如果您已为 CI 套件启用在收到来自 dbt Cloud 的拉取请求时触发,则当指定的 dbt Cloud CI 作业完成时,CI 将自动触发验证运行。
由 dbt Cloud CI 作业触发的 CI 运行旨在检查 dbt 中的架构更改是否会破坏 LookML 内容。在运行期间,Looker 会执行以下操作:
- 在作业完成后接收来自 dbt Cloud 的通知。
- 提取 dbt Cloud 为该特定运行创建的临时架构的详细信息。
- 使用此临时架构的名称覆盖已配置的用户属性(例如,连接的架构属性)。
- 针对此临时架构执行 CI 验证器。
这样,您就可以在 dbt 更改合并到生产环境之前,发现破坏性更改(例如删除的列或重命名的表)。运行完成后,CI 用户的用户属性值会恢复为标准值。
按时间表自动触发
如果您已为 CI 套件启用按时间表触发,CI 将在您指定的时间表自动触发验证运行。
对于自动安排的验证运行,CI 会验证代码库的正式版,并返回该版本中的所有错误。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
手动触发 CI 套件的新运行
拥有 see_ci 权限的 Looker 用户可以从 Looker IDE 手动触发 CI 运行。
如需手动触发 CI 套件的新运行,请按以下步骤操作:
- 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
- 点击套件以打开套件页面。
- 点击要运行的 CI 套件对应的运行套件按钮(如果您的项目没有任何 CI 套件,您可以创建 CI 套件)。
在手动触发运行对话框中,使用工作区选项选择要验证的分支(如需了解详情,请参阅工作区部分):
- 如需验证 LookML 项目的正式版,请点击正式版。
- 如果您想验证 LookML 项目的开发分支,请点击开发模式。使用分支下拉菜单选择要验证的开发分支。
如需触发 CI 套件的运行,请点击开始运行。
CI 套件可能需要几分钟才能完成运行,具体取决于项目的大小、CI 套件中包含的验证器以及 CI 套件的配置。
触发运行后,Looker IDE 将显示您触发的套件的运行页面。验证测试完成后,运行页面将显示每个验证器的结果。在验证测试运行期间,您可以离开运行页面,稍后再返回运行页面查看结果。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
工作区
手动触发 CI 运行作业时,您可以使用工作区选项来验证代码库的正式版或开发分支。
对于正式版选项,如果您想确定哪个分支或提交用于正式版,可以在 Looker IDE 中查看项目设置的分支管理页面中 Git 摘要部分的默认正式版分支字段:
- 对于配置了高级部署模式的项目,正式版是由具有
deploy权限的 Looker 开发者在部署管理器中选择的提交或标记。 - 对于未启用高级部署模式的项目,正式版是在项目设置的项目配置页面中,Git 正式版分支名称字段内配置的分支。
对于开发者模式选项,请注意以下事项,以便在项目中验证开发分支:
- 如需查看 LookML 项目中的分支并识别生产分支和开发者的个人分支,请参阅 Looker IDE 中项目的项目设置中的分支管理页面。
- 如需验证开发分支,必须将开发分支推送到 LookML 代码库。在 Looker IDE 中,这意味着开发者必须点击 Commit Changes & Push(提交更改并推送)按钮,或从 IDE 的 Git Actions(Git 操作)面板中选择 Commit(提交)选项。
手动重新运行之前的 CI 运行
对于已完成的运行(无论运行结果是成功、失败、出错还是已取消),拥有 see_ci 权限的 Looker 用户都可以从 Looker IDE 中手动触发 CI 运行的重新运行:
- 如果您重新运行由 PR 触发的运行作业(由项目代码库或导入的项目中的拉取请求触发),持续集成会针对与原始运行作业相同的提交运行。
- 如果您重新运行手动触发的运行,持续集成会针对重新运行时的生产状态或分支 HEAD 运行,其中将包含自初始 CI 运行以来所做的任何后续提交。
此外,如果您在初始运行后修改了 CI 套件,则重新运行将包含您在初始运行后对 CI 套件所做的任何更改。
如需重新运行 CI 运行,请按以下步骤操作:
- 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
- 点击运行作业以打开运行作业页面。
- 在运行页面上,点击要取消的 CI 运行对应的查看运行按钮。
- 在所选运行作业的运行结果页面上,点击页面顶部的重新运行按钮。
点击重新运行后,内容验证器将启动运行,并返回到新运行的运行页面。
如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。
取消 CI 运行
如果您想取消正在运行的 CI 运行作业,可以按照以下步骤从其运行页面中取消:
- 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
- 点击运行作业以打开运行作业页面。
- 在运行页面上,点击要取消的 CI 运行对应的查看运行按钮。
- 在所选运行对应的运行页面上,点击页面顶部的取消按钮。
点击取消后,持续集成将取消运行,并在运行页面上显示已取消状态。