运行持续集成套件

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

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

通过拉取请求自动触发

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

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

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

手动触发 CI 套件的新运行

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

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

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

    • 如需验证 LookML 项目的正式版,请点击正式版
    • 如果您想验证 LookML 项目的开发分支,请点击开发模式。使用分支下拉菜单选择要验证的开发分支。
  5. 如需触发 CI 套件的运行,请点击开始运行

CI 套件可能需要几分钟才能运行完毕,具体取决于项目的大小、CI 套件中包含的验证器以及 CI 套件的配置。

触发运行后,Looker IDE 会显示您触发的套件的运行页面。验证测试完成后,Run 页面将显示每个验证程序的结果。在验证测试运行期间,您可以离开 Run 页面,稍后再返回 Run 页面查看结果。

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

工作区

手动触发 CI 运行时,您可以使用 Workspace 选项来验证代码库的正式版或代码库的开发分支。

对于生产选项,如果您想确定哪个分支或提交内容用于生产版本,可以在 Looker IDE 的 Project Settings(项目设置)的 Branch Management(分支管理)页面中的 Git Summary(Git 摘要)部分的 Default Production Branch(默认生产分支)字段中查看:

  • 对于使用高级部署模式配置的项目,正式版是具有 deploy 权限的 Looker 开发者在部署管理器中选择的提交或代码标记。
  • 对于未采用高级部署模式的项目,正式版是指在项目设置项目配置页面中的 Git 正式版分支名称字段中配置的分支。

对于 Dev Mode 选项,请注意以下事项,以验证项目中的开发分支:

  • 如需查看 LookML 项目中的分支,以及确定开发者的生产分支和个人分支,请参阅 Looker IDE 中项目的项目设置分支管理页面。
  • 若要验证开发分支,必须将开发分支推送到您的 LookML 代码库。在 Looker IDE 中,这意味着开发者必须点击 Commit Changes & Push 按钮,或从 IDE 的 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. 在所选运行对应的运行页面上,点击页面顶部的取消按钮。

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