GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation retrieves artifacts for a specific job from the GitLab API (version 4). It is useful for scenarios where you need to download or access job artifacts generated during CI/CD pipelines in GitLab. For example, you might use this to fetch build logs, test reports, or compiled binaries associated with a particular job ID.

Use Case Examples

  1. Download artifacts of a CI job to analyze test results.
  2. Fetch build outputs from a specific job for deployment or further processing.

Properties

Name Meaning
Skip Authentication Whether to skip authentication 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 to send the request to.
Method HTTP method to use for the request (GET, POST, PUT, DELETE, HEAD, PATCH).
Query Parameters Optional query parameters for the request, including token and direct_download flag.
Path Parameters Path parameters for the request, specifically the job ID.

Output

Binary

The node outputs the binary data of the job artifacts, allowing downstream nodes to process or save the artifact files.

JSON

  • id - The job ID for which artifacts were retrieved.
  • token - The authentication token used for accessing the job artifacts, if provided.
  • direct_download - Indicates whether the artifacts were downloaded directly from remote storage.

Dependencies

  • GitLab API credentials or an API authentication token are required unless Skip Authentication is enabled.

Troubleshooting

  • Ensure the job ID provided in path parameters is valid and exists in the GitLab project.
  • If authentication fails, verify that the GitLab API credentials are correctly configured and have sufficient permissions.
  • If artifacts are not found, confirm that the job has generated artifacts and they are accessible.
  • Check the baseUrl to ensure it points to the correct GitLab instance, especially if using a self-hosted GitLab server.

Links

Discussion