GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation deletes a GitLab runner using the GitLab API. It is useful for managing CI/CD runners by removing those that are no longer needed or authorized. For example, a DevOps engineer can automate the cleanup of inactive or compromised runners by specifying the runner's authentication token.

Use Case Examples

  1. Automate deletion of a specific GitLab runner by providing its token.
  2. Remove runners that are no longer in use to maintain a clean CI/CD environment.

Properties

Name Meaning
Skip Authentication Whether to skip the authentication process for the API request.
Authentication The authentication method used for the API request, hidden if Skip Authentication is true.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method to use for the request, default is GET but can be set to DELETE for this operation.
Query Parameters Collection of query parameters for the request, specifically the runner's authentication token required to identify the runner to delete.

Output

JSON

  • success - Indicates whether the runner was successfully deleted.
  • message - Additional information or error message related to the deletion operation.

Dependencies

  • GitLab API credentials

Troubleshooting

  • Ensure the runner's token is correct and has the necessary permissions to delete the runner.
  • If authentication is skipped, the request may fail due to lack of authorization.
  • Verify the baseUrl is correct and accessible.
  • Common error messages include authentication failures, invalid token, or runner not found.

Links

Discussion