GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation allows importing a project into GitLab from an S3 remote storage. It is useful for automating the import of projects stored in AWS S3 buckets into GitLab, enabling seamless migration or backup restoration workflows. For example, a user can specify the S3 bucket details and project parameters to import a project directly into their GitLab namespace.

Use Case Examples

  1. Import a project from an S3 bucket by providing AWS region, bucket name, file key, and access credentials along with the desired project path and optional override parameters such as project visibility and CI settings.
  2. Automate project imports from S3 storage to GitLab for continuous integration setups or migration tasks.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the request (boolean). Defaults to false.
Authentication The authentication method used, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, defaulting to GET but typically POST for this operation.
Parameter Schema Schema defining the parameters required for the S3 remote import, including AWS region, bucket name, file key, access keys, project path, and various optional override parameters to customize the imported project.

Output

JSON

  • id - The unique identifier of the imported project.
  • name - The name of the imported project.
  • path - The path of the imported project in GitLab.
  • namespace - The namespace into which the project is imported.
  • visibility - The visibility level of the imported project (e.g., private, internal, public).
  • import_status - The status of the import process.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure all required AWS S3 parameters (region, bucket_name, file_key, access_key_id, secret_access_key) are correctly provided to avoid authentication or access errors.
  • Verify that the GitLab base URL is correct and accessible.
  • Check that the user has sufficient permissions in GitLab to import projects into the specified namespace.
  • Common error messages may include authentication failures, permission denied, or invalid parameter errors. Verify credentials and parameter formats to resolve these issues.

Links

Discussion