"Docs: Mapping table for CI/CD variables and pipeline events"
Here’s the request with a GitLab-style table format suitable for an issue submission:
**Summary**
Requesting an enhancement to the GitLab documentation to include a table mapping CI/CD variables to pipeline events. This will help users understand the availability of variables in different pipeline contexts.
**What is being requested?**
Add a table to the documentation that maps CI/CD variables to their availability across pipeline event types (e.g., push, merge request, trigger). Below is an example format:
| **Variable** | **Push** | **Merge Request (MR)** | **Tag** | **Web** | **API** | **Schedule** | **Trigger** | **Manual** | **External** |
|-----------------------------|----------|------------------------|---------|---------|---------|--------------|-------------|------------|--------------|
| `CI_COMMIT_BRANCH` | ✔ | - | - | - | - | ✔ | ✔ | ✔ | ✔ |
| `CI_COMMIT_TAG` | - | - | ✔ | - | - | - | - | - | - |
| `CI_MERGE_REQUEST_IID` | - | ✔ | - | - | - | - | - | - | - |
| `CI_PIPELINE_SOURCE` | `push` | `merge_request_event` | `tag` | `web` | `api` | `schedule` | `trigger` | `manual` | `external` |
| `CI_JOB_ID` | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
**Why is this needed?**
This table would provide the following benefits:
- Clarity: Quickly identify which variables are available in a specific pipeline event.
- Efficiency: Reduces trial and error and troubleshooting time for developers.
- Comprehensive Reference: Combines variable descriptions and pipeline source contexts into a single table for easy access.
**Relevant links:**
- GitLab CI/CD Variables
- Pipeline Events
issue