gitlab_trigger_pipeline
Trigger a new GitLab CI pipeline on a specified branch or tag with optional CI variables. Each call creates a new pipeline and consumes runner minutes.
Instructions
Create a new pipeline on the given ref, optionally with CI variables.
Not idempotent: each call creates a new pipeline. Consumes minutes on your runners — avoid calling in loops.
Examples:
- "Run the pipeline on master" → default (ref='master')
- "Run the pipeline on feature/x with DEBUG=1" → ref='feature/x', variables={'DEBUG': '1'}
- Don't call to retry — use gitlab_retry_pipeline which keeps the same pipeline ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Branch or tag to run the pipeline on. | master |
| variables | No | Optional CI variables to pass to the pipeline (``{key: value}``). | |
| project_path | No | GitLab project path (e.g. 'my-org/my-repo'). When omitted, the default from GITLAB_PROJECT_PATH env var is used. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pipeline_id | No | ||
| status | No | ||
| web_url | No | ||
| ref | No | ||
| created_at | No | ||
| status_note | No |