如要設定 CI 套件,以便在提取要求時自動觸發,請啟用「在 Looker 發出提取要求時觸發」切換鈕。如要使用提取要求觸發功能,Looker 管理員必須在 Looker 的「持續整合」頁面中設定 Git 存放區。
如果您為 CI 套件啟用提取要求觸發條件,可以選擇指定只有存放區中特定分支的提取要求,才能觸發 CI 套件的執行作業。如要將自動提取要求觸發條件限制為 CI 在儲存庫中執行的特定分支,請在「僅限目標分支」欄位中,輸入以半形逗號分隔的分支清單。
舉例來說,如果存放區有三個分支,分別命名為 main、release_1 和 dev,您可以在「僅限目標分支」欄位中輸入 main, release_1。也就是說,當 Looker 開發人員將提取要求提交至 main 或 release_1 分支時,系統就會觸發 CI 執行作業。如果 Looker 開發人員將提取要求提交至 dev 分支,系統不會觸發 CI 套件的自動執行作業。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-03 (世界標準時間)。"],[],[],null,["# Creating a Continuous Integration suite\n\n| **Preview:** This product or feature is subject to the \"Pre-GA Offerings Terms\" in the [General Service Terms](https://cloud.google.com/terms/service-terms#1) section of the Service Specific Terms. Pre-GA products and features are available \"as is\" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).\n|\n| If you encounter an issue during the Public Preview of Continuous Integration, report it using the [Looker Continuous Integration - Preview Issue Tracker form](https://docs.google.com/forms/d/e/1FAIpQLSed30eICYruU45R8WZQH6hIui28xtdDnejfetzpLHQ5PK0ZeA/viewform?usp=dialog).\n\nA Continuous Integration (CI) suite is a set of validation instructions that is associated with your LookML project. A Looker user with the [`manage_ci`](/looker/docs/admin-panel-users-roles#manage_ci) permission can configure the following in a CI suite:\n\n- How a CI validation run is triggered ([manually from the Looker IDE](/looker/docs/ci-run-suite#manual-run) or [automatically when a pull request is submitted to your repository](/looker/docs/ci-run-suite#pr-run)).\n- Which CI validators to run.\n- Additional options for each validation test. See the documentation pages for each of the validators for details:\n - [SQL Validator](/looker/docs/ci-sql-validator)\n - [Assert Validator](/looker/docs/ci-assert-validator)\n - [Content Validator](/looker/docs/ci-content-validator)\n - [LookML Validator](/looker/docs/ci-lookml-validator)\n\nBefore you begin\n----------------\n\nBefore you can create a CI suite, you need the following:\n\n- A Looker instance that meets the [requirements for CI](/looker/docs/continuous-integration#requirements) and that is [enabled for CI](/looker/docs/continuous-integration#enable-ci).\n- A Looker user account with the [`manage_ci`](/looker/docs/admin-panel-users-roles#manage_ci) permission (this permission is included in the Admin [permission set](/looker/docs/admin-panel-users-roles#permission_sets)).\n\nCreating a CI suite\n-------------------\n\nYou can configure and run the validators on the **Suites** page in the Looker IDE:\n\nTo create a CI suite, follow these steps:\n\n1. From the [Looker IDE](/looker/docs/looker-ide), click the **Continuous Integration** icon from the IDE navigation bar.\n2. Click the **Suites** tab to open the **Suites** page.\n3. On the **Suites** page, you can create a new suite or edit an existing suite:\n - To create a new suite, click the **Create suite** button.\n - To edit an existing suite, click the **Edit suite** button for the suite.\n4. Enter a name for the **Suite name**. If you are editing an existing suite, you can optionally click the pencil icon to edit the suite name.\n5. (Optional) Enable the **Trigger on pull requests from Looker** toggle if you want to set up automatic validation testing whenever a Looker developer submits a pull request to your repository. See the [Triggers](#triggers) section of this page for more information.\n\n If you enable pull request triggering for a CI suite, you can optionally use the **Only for target branch** field to specify that pull requests only to specific branches in the repository should trigger a run of the CI suite. See the [Triggers](#triggers) section of this page for more information.\n6. Optionally, enable the validator toggles to turn on a validator and configure its options. See the documentation pages for each of the validators for details:\n\n - [SQL Validator](/looker/docs/ci-sql-validator)\n - [Assert Validator](/looker/docs/ci-assert-validator)\n - [Content Validator](/looker/docs/ci-content-validator)\n - [LookML Validator](/looker/docs/ci-lookml-validator)\n7. Save your changes:\n\n - If you are creating a new suite, click the **Create suite** button.\n - If you are editing an existing suite, click the **Update suite** button.\n\n### Triggers\n\nCI runs can be triggered in several ways:\n\n- Automatically, when a pull request is submitted to your LookML project's repository by a Looker developer.\n- Manually, [using the **Run suite** button](/looker/docs/ci-run-suite#manual-run) on the **Suites** page in the Looker IDE.\n- Manually, by [rerunning a previous CI run](/looker/docs/ci-run-suite#manual-rerun), from the **Runs** page of the Looker IDE.\n\nTo configure a CI suite for automatic triggering on pull request, enable the **Trigger on pull requests from Looker** toggle. To use pull request triggering, your Git repository must be configured by your Looker admin on the [**Continuous Integration** Admin](/looker/docs/admin-panel-platform-ci#github) page of Looker).\n| **Tip:** Even if you configure the CI suite to run automatically on pull requests, you can still initiate a [manual run](/looker/docs/ci-run-suite#manual-run) or [manually rerun a previous run](/looker/docs/ci-run-suite#manual-rerun) of the CI suite from the Looker IDE.\n\n\nIf you enable pull request triggers for a CI suite, you can optionally specify that pull requests only to specific branches in the repository should trigger a run of the CI suite. To limit automatic pull request triggers of CI runs to specific branches in your repository, enter a comma-separated list of the branches in the **Only for target branch** field.\n\nFor example, if a repository has three branches named `main`, `release_1`, and `dev`, you can enter `main, release_1` in the **Only for target branch** field. This means that CI runs will be triggered when a Looker developer submits a pull request to either the `main` or the `release_1` branch. If a Looker developer submits a pull request to the `dev` branch, this won't trigger an automatic run of the CI suite.\n\nDeleting a suite\n----------------\n\nTo delete a CI suite, perform the following steps:\n\n1. From the [Looker IDE](/looker/docs/looker-ide), click the **Continuous Integration** icon from the IDE navigation bar.\n2. Click the **Suites** tab to open the **Suites** page.\n3. On the **Suites** page, click the **Edit suite** button for the suite.\n4. On the suite's page, click the **Delete suite** button.\n5. In the confirmation dialog, click the **Delete suite** button."]]