持续集成 (CI) 套件是一组与 LookML 项目关联的验证指令。具有 manage_ci 权限的 Looker 用户可以在 CI 套件中配置以下内容：
- CI 验证运行的触发方式（通过 Looker IDE 手动触发或在向代码库提交拉取请求时自动触发）。
- 要运行哪些 CI 验证器。
- 每项验证测试的其他选项。如需了解详情，请参阅每个验证器的文档页面：
准备工作
在创建 CI 套件之前，您需要做好以下准备：
创建 CI 套件
您可以在 Looker IDE 的套件页面上配置和运行验证器：
如需创建 CI 套件，请按照以下步骤操作：
- 在 Looker IDE 中，点击 IDE 导航栏中的持续集成图标。
- 点击套房标签页，打开套房页面。
- 在套装页面上，您可以创建新套装或修改现有套装：
- 如需创建新套装，请点击创建套装按钮。
- 如需修改现有套装，请点击相应套装的修改套装按钮。
- 输入套件名称。如果您要修改现有套装，可以选择点击铅笔图标来修改套装名称。
- （可选）如果您想设置定期自动进行验证测试，请启用按计划触发切换开关。如需了解详情，请参阅本页的按时间表触发部分。
（可选）如果您想在 Looker 开发者向您的代码库提交拉取请求时设置自动验证测试，请启用在收到来自 Looker 的拉取请求时触发切换开关。如需了解详情，请参阅本页的在收到来自 Looker 的拉取请求时触发部分。
如果您为 CI 套件启用了拉取请求触发，则可以选择使用仅针对目标分支字段来指定只有针对代码库中特定分支的拉取请求才应触发 CI 套件的运行。如需了解详情，请参阅本页的在收到来自 Looker 的拉取请求时触发部分。
（可选）如果您想在每次运行 dbt Cloud CI 作业时设置自动验证测试，请开启在收到来自 dbt Cloud 的拉取请求时触发切换开关。如需了解详情，请参阅本页面的在收到来自 dbt Cloud 的拉取请求时触发部分。
（可选）如果您想根据 CI 运行的状态接收电子邮件提醒，请开启启用电子邮件提醒切换开关。如需了解详情，请参阅本页的设置提醒部分。
您可以选择启用验证器切换开关，以开启验证器并配置其选项。如需了解详情，请参阅各个验证器的文档页面：
保存更改：
- 如果您要创建新的套装，请点击创建套装按钮。
- 如果您要修改现有套装，请点击更新套装按钮。
触发器
可以通过多种方式触发 CI 运行：
- 自动按周期性安排。
- 自动运行，当 Looker 开发者向 LookML 项目的代码库提交拉取请求时。
- 在 dbt Cloud CI 作业创建拉取请求时自动执行。
- 手动使用 Looker IDE 中套装页面上的运行套装按钮。
- 手动操作，通过 Looker IDE 的 Runs 页面重新运行之前的 CI 运行。
按时间表触发
您可以启用按时间表触发切换开关，将 CI 套件配置为按时间表自动触发。
启用此切换开关后，您可以选择自动运行 CI 套件的频率和具体时间：
- 每月，在特定日期和时间
- 每周，在特定日期和时间
- 每天，在特定时间
- 每小时或每 2、3、4、6、8 或 12 小时一次，在一天中的特定时间开始和结束
- 分钟：每 5、10、15、20 或 30 分钟一次，在一天中的特定时间开始和结束
- 在一年中的特定月份的特定日期和时间
- 一周中的特定日期的特定时间
在收到来自 Looker 的拉取请求时触发
如需配置 CI 套件以在收到拉取请求时自动触发，请启用在收到来自 Looker 的拉取请求时触发切换开关。如需使用拉取请求触发，您的 Git 代码库必须由 Looker 管理员在 Looker 的持续集成管理页面上进行配置。
如果您为 CI 套件启用拉取请求触发器，则可以选择指定仅当拉取请求发送到代码库中的特定分支时，才触发 CI 套件运行。如需将 CI 运行的自动拉取请求触发器限制为仅适用于代码库中的特定分支，请在仅针对目标分支字段中输入以逗号分隔列表形式的分支。
例如，如果代码库有三个名为 main、release_1 和 dev 的分支，您可以在仅针对目标分支字段中输入 main, release_1。这意味着，当 Looker 开发者向 main 或 release_1 分支提交拉取请求时，系统会触发 CI 运行。如果 Looker 开发者向 dev 分支提交拉取请求，系统不会自动运行 CI 套件。
在收到来自 dbt Cloud 的拉取请求时触发
如果您已在实例上配置 dbt Cloud 集成，则可以配置 CI 套件，以便在 dbt Cloud CI 作业完成时自动触发该套件。CI 套件会在部署 dbt 更改之前，验证 dbt 模型中的更改是否会导致 Looker 探索中的 SQL 错误。
如需配置此触发器，请在创建或修改 CI 套件时启用在收到来自 dbt Cloud 的拉取请求时触发切换开关。
启用此触发器后，请配置以下选项：
dbt Cloud 作业：从下拉字段中选择应触发此套件的 dbt Cloud CI 作业。
架构用户属性：选择包含数据库连接的架构名称的 Looker 用户属性。此列表中只会显示已在“管理”面板中为 CI 启用的用户属性。
保存已启用此触发器的套件后，Looker 会自动在您的 dbt Cloud 账号中注册一个 Webhook，以监听作业完成情况。
对于由 dbt Cloud 触发的运行，Looker 会动态识别由 dbt Cloud 运行创建的临时架构，并在 CI 运行期间使用此临时架构名称替换所选的用户属性。
设置提醒
如需根据 CI 运行的状态接收电子邮件提醒，您可以为 CI 套件设置提醒。这样一来，您无需在 Looker IDE 中查看运行页面，即可监控持续集成运行。
如需为 CI 套件配置电子邮件提醒，请在创建或修改 CI 套件时按以下步骤操作：
- 启用启用电子邮件提醒切换开关。
- 在电子邮件地址字段中，输入应接收提醒的逗号分隔列表电子邮件地址。
- 使用复选框选择应触发提醒的作业状态：
- 失败：当 CI 运行未通过验证测试时，触发电子邮件。
- 错误：当 CI 运行遇到系统或配置错误时，触发电子邮件。
- 通过：在 CI 运行成功完成后触发电子邮件。
- 已取消：在 CI 运行取消时触发电子邮件。
删除套件
如需删除 CI 套件，请执行以下步骤：
- 在 Looker IDE 中，点击 IDE 导航栏中的持续集成图标。
- 点击套房标签页，打开套房页面。
- 在套件页面上，点击相应套件的修改套件按钮。
- 在套装页面上，点击删除套装按钮。
- 在确认对话框中，点击删除套装按钮。