运行持续集成套件

持续集成 (CI) 运行可通过多种方式触发:

验证测试完成后,您可以查看结果,如查看持续集成运行结果文档页面中所述。

通过拉取请求自动触发

如果您已为 CI 套件启用在收到来自 Looker 的拉取请求时触发,那么当 Looker 开发者向您的 LookML 代码库提交拉取请求时,CI 将自动触发验证运行。(您可以选择指定仅针对代码库中的特定分支的拉取请求应触发自动 CI 运行。)

对于自动拉取请求验证运行,CI 会验证最新的拉取请求提交,并返回该版本代码库中的所有错误。

如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。

通过导入项目的拉取请求自动触发

如果您在下游(spoke)项目中启用了 CI 套件,并选择了在导入的项目中收到拉取请求时触发,那么当开发者在订阅的上游(hub)项目代码库中打开或更新拉取请求时,CI 会自动在 spoke 项目中触发验证运行。

在由导入的项目拉取请求触发的 CI 运行期间,Looker 会执行以下操作:

  1. 验证 spoke 项目的正式版,同时将导入的 hub 项目临时固定到拉取请求提交。
  2. 将 spoke 项目的 CI 运行结果写回 hub 项目代码库中的拉取请求。

如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。

从 dbt Cloud 自动触发

如果您已为 CI 套件启用在收到来自 dbt Cloud 的拉取请求时触发,则当指定的 dbt Cloud CI 作业完成时,CI 将自动触发验证运行。

由 dbt Cloud CI 作业触发的 CI 运行旨在检查 dbt 中的架构更改是否会破坏 LookML 内容。在运行期间,Looker 会执行以下操作:

  1. 在作业完成后接收来自 dbt Cloud 的通知。
  2. 提取 dbt Cloud 为该特定运行创建的临时架构的详细信息。
  3. 使用此临时架构的名称覆盖已配置的用户属性(例如,连接的架构属性)。
  4. 针对此临时架构执行 CI 验证器。

这样,您就可以在 dbt 更改合并到生产环境之前,发现破坏性更改(例如删除的列或重命名的表)。运行完成后,CI 用户的用户属性值会恢复为标准值。

按时间表自动触发

如果您已为 CI 套件启用按时间表触发,CI 将在您指定的时间表自动触发验证运行。

对于自动安排的验证运行,CI 会验证代码库的正式版,并返回该版本中的所有错误。

如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。

手动触发 CI 套件的新运行

拥有 see_ci 权限的 Looker 用户可以从 Looker IDE 手动触发 CI 运行。

如需手动触发 CI 套件的新运行,请按以下步骤操作:

  1. 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
  2. 点击套件以打开套件页面。
  3. 点击要运行的 CI 套件对应的运行套件按钮(如果您的项目没有任何 CI 套件,您可以创建 CI 套件)。
  4. 在手动触发运行对话框中,使用工作区选项选择要验证的分支(如需了解详情,请参阅工作区部分):

    • 如需验证 LookML 项目的正式版,请点击正式版。
    • 如果您想验证 LookML 项目的开发分支,请点击开发模式。使用分支下拉菜单选择要验证的开发分支。
  5. 如需触发 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 运行,请按以下步骤操作:

  1. 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
  2. 点击运行作业以打开运行作业页面。
  3. 在运行页面上,点击要取消的 CI 运行对应的查看运行按钮。
  4. 在所选运行作业的运行结果页面上,点击页面顶部的重新运行按钮。

点击重新运行后,内容验证器将启动运行,并返回到新运行的运行页面。

如需了解如何查看结果,请参阅查看持续集成运行结果文档页面。

取消 CI 运行

如果您想取消正在运行的 CI 运行作业,可以按照以下步骤从其运行页面中取消:

  1. 在 Looker IDE 中,点击 IDE 导航栏中的持续集成图标。
  2. 点击运行作业以打开运行作业页面。
  3. 在运行页面上,点击要取消的 CI 运行对应的查看运行按钮。
  4. 在所选运行对应的运行页面上,点击页面顶部的取消按钮。

点击取消后,持续集成将取消运行,并在运行页面上显示已取消状态。