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, such as when a token is compromised or needs to be rotated regularly.

Use Case Examples

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

Properties

Name Meaning
Skip Authentication Determines whether to skip the authentication process for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, defaulting to GET but can be set to POST, PUT, DELETE, HEAD, or PATCH.

Output

JSON

  • token - The new registration token for GitLab runners returned by the API after reset.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the baseUrl is correctly set to your GitLab instance URL to avoid connection errors.
  • Verify that the API key used for authentication has sufficient permissions to reset runner registration tokens.
  • If the API request fails, check the HTTP method is set to POST as required by the reset registration token endpoint.
  • Common error messages may include authentication failures or permission denied errors, which can be resolved by updating credentials or permissions.

Links

Discussion