gitlab-jobs

Overview

Covers job execution and logs.

Available Tools

• •get_project_jobs: Retrieve a list of jobs for a specific GitLab project, optionally filtered by scope or a single job by id.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •job_id (Optional[int]): Optional. - Job ID
    • •scope (Optional[str]): Optional. - Filter jobs by scope (e.g., 'success', 'failed')
    • •include_retried (Optional[bool]): Optional. - Include retried jobs
    • •include_invisible (Optional[bool]): Optional. - Include invisible jobs (e.g., from hidden pipelines)
• •get_project_job_log: Retrieve the log (trace) of a specific job in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •job_id (int): Optional. - Job ID
• •cancel_project_job: Cancel a specific job in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •job_id (int): Optional. - Job ID
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •retry_project_job: Retry a specific job in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •job_id (int): Optional. - Job ID
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •erase_project_job: Erase (delete artifacts and logs of) a specific job in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •job_id (int): Optional. - Job ID
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •run_project_job: Run (play) a specific manual job in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •job_id (int): Optional. - Job ID
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •get_pipeline_jobs: Retrieve a list of jobs for a specific pipeline in a GitLab project, optionally filtered by scope.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •pipeline_id (int): Optional. - Pipeline ID
    • •scope (Optional[str]): Optional. - Filter jobs by scope (e.g., 'success', 'failed')

Usage Instructions

1. •Use job_id for actions.
2. •Filters: scope, status.

Examples

• •Get log: get_project_job_log with project_id="123", job_id=456.
• •Retry: retry_project_job with project_id="123", job_id=456.

Error Handling

• •Job not found: Verify IDs.