Pipeline schedules · Gitlab 中文文檔

# Pipeline schedules > 原文：[https://docs.gitlab.com/ee/ci/pipelines/schedules.html](https://docs.gitlab.com/ee/ci/pipelines/schedules.html) * [Prerequisites](#prerequisites) * [Configuring pipeline schedules](#configuring-pipeline-schedules) * [Using variables](#using-variables) * [Using only and except](#using-only-and-except) * [Advanced configuration](#advanced-configuration) * [Working with scheduled pipelines](#working-with-scheduled-pipelines) * [Running manually](#running-manually) * [Taking ownership](#taking-ownership) # Pipeline schedules[](#pipeline-schedules "Permalink") 版本歷史 * 在 GitLab 9.1 中作為[觸發計劃](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/10533)引入. * 在 GitLab 9.2 中[重命名為 Pipeline Schedule](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/10853) . **注意：** Cron 表示法由[Fugit](https://github.com/floraison/fugit)解析. 管道通常是在滿足某些條件的情況下運行的. 例如，將分支推送到存儲庫時. 管道計劃可以用于以特定間隔運行[管道](index.html) . 例如： * 每個月的 22 號都有特定的分支機構. * 每天一次. 除了使用 GitLab UI 外，還可以使用[Pipeline schedules API](../../api/pipeline_schedules.html)維護[管道時間表](../../api/pipeline_schedules.html) . ## Prerequisites[](#prerequisites "Permalink") 為了成功創建計劃的管道： * 計劃所有者必須具有合并到目標分支的[權限](../../user/permissions.html) . * 管道配置必須有效. 否則，不會創建管道. ## Configuring pipeline schedules[](#configuring-pipeline-schedules "Permalink") 計劃項目的管道： 1. 導航到項目的**CI / CD>計劃**頁面. 2. 單擊**新建計劃**按鈕. 3. 填寫**計劃表中的新管道**表單. 4. 單擊**保存管道計劃**按鈕. [![New Schedule Form](https://img.kancloud.cn/d3/2e/d32ef7472d628c6684cdbea84188132f_1248x658.png)](img/pipeline_schedules_new_form.png) **注意：**管道執行[時間取決于](#advanced-configuration) Sidekiq 自己的時間表. 在" **計劃**索引"頁面中，您可以看到計劃運行的管道的列表. 下次運行由安裝了 GitLab 的服務器自動計算. [![Schedules list](https://img.kancloud.cn/59/7f/597ff0f9cc4189f371b8b16cea5e7fc3_981x207.png)](img/pipeline_schedules_list.png) ### Using variables[](#using-variables "Permalink") 在 GitLab 9.4 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/12328) . 您可以傳遞任意數量的任意變量，它們將在 GitLab CI / CD 中可用，以便可以在您的[`.gitlab-ci.yml`文件中使用](../../ci/yaml/README.html) . [![Scheduled pipeline variables](https://img.kancloud.cn/05/38/0538dbe3ec75836134379817977759e3_941x182.png)](img/pipeline_schedule_variables.png) ### Using only and except[](#using-only-and-except "Permalink") 要配置僅在計劃了管道（或相反）時才可以執行作業，您只能使用[且](../yaml/README.html#onlyexcept-basic)不能使用配置關鍵字. For example: ``` job:on-schedule: only: - schedules script: - make world job: except: - schedules script: - make build ``` ### Advanced configuration[](#advanced-configuration "Permalink") 管道不會完全按計劃執行，因為計劃由 Sidekiq 處理，Sidekiq 根據其間隔運行. 例如，如果滿足以下條件，則每天只會創建兩個管道： * 您設置時間表以每分鐘（ `* * * * *` ）創建一條管道. * Sidekiq 工作者每天在 00:00 和 12:00（ `0 */12 * * *` ）運行. 更改 Sidekiq 工作人員的頻率： 1. 在實例的`gitlab.rb`文件中編輯`gitlab_rails['pipeline_schedule_worker_cron']`值. 2. [重新配置 GitLab，](../../administration/restart_gitlab.html#omnibus-gitlab-reconfigure)以使更改生效. 對于 GitLab.com，請參閱[專用設置頁面](../../user/gitlab_com/index.html#gitlab-cicd) . ## Working with scheduled pipelines[](#working-with-scheduled-pipelines "Permalink") 配置完成后，GitLab 將支持許多用于計劃管道的功能. ### Running manually[](#running-manually "Permalink") 在 GitLab 10.4 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/15700) . 要手動觸發管道計劃，請單擊"播放"按鈕： [![Play Pipeline Schedule](https://img.kancloud.cn/47/36/473657b6e19c8e85884dde9a493316b0_1340x289.png)](img/pipeline_schedule_play.png) 這將安排一個后臺作業來運行管道計劃. 一條簡短消息將提供指向 CI / CD 管道索引頁面的鏈接. **注意：**為避免濫用，限制了用戶每分鐘觸發一次管道的速率. ### Taking ownership[](#taking-ownership "Permalink") 管道以擁有日程表的用戶身份執行. 這影響管道可以訪問哪些項目和其他資源. 如果用戶不擁有管道，則可以通過單擊" **獲取所有權"**按鈕**獲取所有權** . 下次計劃管道時，將使用您的憑據. [![Schedules list](https://img.kancloud.cn/e2/35/e2358e9f8a16294e2a9a2b442fed3aee_1016x59.png)](img/pipeline_schedules_ownership.png) 如果管道計劃的所有者沒有能力在目標分支上創建管道，則該計劃將停止創建新管道. 例如，如果發生這種情況： * 所有者被阻止或從項目中刪除. * 目標分支或標簽受保護. 在這種情況下，具有足夠特權的人必須擁有日程表的所有權.