GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation interacts with the GitLab API to reset the registration token for GitLab runners. It is useful in scenarios where you need to invalidate the current registration token and generate a new one for security or operational reasons. For example, if a runner's token is compromised or needs to be rotated, this operation allows you to reset it programmatically.

Use Case Examples

  1. Resetting the registration token for GitLab runners to enhance security.
  2. Automating the rotation of runner registration tokens in CI/CD pipelines.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used for the request, hidden unless Skip Authentication is false.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET with options including POST, PUT, DELETE, HEAD, PATCH.
Parameter Schema Schema for request parameters, hidden and not set by default.
Request Body Schema Schema for the request body, hidden and not set by default.
Request Path The API endpoint path for resetting the registration token, fixed to /api/v4/runners/reset_registration_token.

Output

JSON

  • response - The JSON response from the GitLab API after resetting the registration token, typically containing the new token details.

Dependencies

  • GitLab API authentication token

Troubleshooting

  • Ensure the GitLab API authentication token is valid and has sufficient permissions to reset runner registration tokens.
  • Verify the baseUrl is correctly set to the GitLab instance you are targeting.
  • Check that the HTTP method is set to POST as required by the reset registration token endpoint.
  • Common error messages may include authentication failures, permission denied, or invalid endpoint errors. Verify credentials and endpoint path to resolve these.

Links

Discussion