GitLab Push Trigger

See GitLab Triggers for an overview and Event Triggers for generic options like title, target, and if.

Placing the following snippet at the top of an RWX file will result in all tasks in the file running on every GitLab push.

on:
  gitlab:
    push:

It's common to pass values from the event as init parameters into tasks.

on:
  gitlab:
    push:
      init:
        commit-sha: ${{ event.git.sha }}

base:
  image: ubuntu:24.04
  config: rwx/base 1.0.0

tasks:
  - key: code
    call: git/clone 2.0.3
    with:
      repository: [email protected]:YOUR_ORG/YOUR_REPO.git
      ref: ${{ init.commit-sha }}
      ssh-key: ${{ gitlab['YOUR_ORG/YOUR_REPO'].ssh-key }}

Event Fields

The following values are available in the event context for GitLab push triggers:

Path	Description
`event.git.sha`	The SHA of the commit that triggered the event.
`event.git.ref`	The ref that was pushed (e.g., `refs/heads/main`).
`event.gitlab.push.after`	The SHA of the commit after the push.
`event.gitlab.push.project.id`	The ID of the GitLab project.
`event.gitlab.push.project.path_with_namespace`	The full path of the project (e.g., `group/subgroup/project`).
`event.gitlab.push.project.web_url`	The web URL of the project.
`event.gitlab.push.user_id`	The ID of the user who pushed.
`event.gitlab.push.user_username`	The username of the user who pushed.

For all values available in the event.gitlab context for GitLab push triggers, see GitLab's documentation on push events.