GitLab

GitLab is a web-based DevOps lifecycle platform designed for source code management (SCM), continuous integration and deployment (CI/CD), and project collaboration. It provides a robust set of tools for version control, issue tracking, code review, security testing, and automation, making it an essential platform for developers and IT teams. GitLab integrates seamlessly with various tools to streamline workflows and improve development efficiency.

How to Integrate GitLab with ZBrain Flow

Integration Steps

1. Initiate GitLab Integration

   • Click the ‘+’ button in ZBrain Flow to add a new integration.

2. Search for GitLab

   • In the search bar, type “GitLab” and select it from the available integrations.

3. Choose an Action

   • Select an action (e.g., Create Issue or Custom API Call) to begin the setup.

How to Create a GitLab Connection in ZBrain Flow

Before using GitLab actions in ZBrain Flow, you need to establish a secure connection between GitLab and ZBrain Flow.

Connection Establishment Steps

1. Enter a Connection Name

   • Provide a unique name to identify the GitLab connection in ZBrain Flow.

2. Click 'Connect'

   • Start the authentication process to establish a link between GitLab and ZBrain Flow.

3. Log in to GitLab

   • A pop-up window will appear, prompting you to log in to your GitLab account.

   • Enter your credentials and proceed with authentication.

4. Grant Permissions

   • Approve the necessary OAuth permissions to allow ZBrain Flow to access GitLab.

   • Permissions may include repository access, issue tracking, and project data retrieval.

5. Save the Connection

   • Click ‘Save’ to complete the setup.

Actions Available in ZBrain Flow

1. Create Issue

Creates a new issue in a selected GitLab project.

Configuration Steps:

• Select an existing GitLab connection or create a new one.

• Select the GitLab project where the issue should be created.

• Enter the title of the issue.

• Enter a detailed description of the issue.

2. Custom API Call

Enables users to send custom API requests to GitLab for advanced operations beyond predefined actions.

Configuration Steps:

1. Select an Existing Connection or Create a New One

   • Choose a previously created GitLab connection or set up a new one.

2. Enter the API Endpoint URL

   • Use a full URL or relative path to the GitLab API base URL.

   • Example: https://gitlab.com/api/v4/projects/{project_id}/issues

3. Select the HTTP Method

   • Choose the appropriate request type:

   • GET – Retrieve issue details, repository information, or user data.

   • POST – Create new issues, comments, or repository events.

   • PATCH – Modify issue metadata, repository settings, or labels.

   • PUT – Update existing records.

   • DELETE – Remove issues, comments, or repositories.

   • HEAD – Fetch response headers without retrieving actual data.

4. Add Headers

   • Define any additional headers required for the API request.

   • Authorization headers are automatically injected.

   • Click ‘+ Add Item’ to include more headers.

5. Add Query Parameters

   • Customize API requests with query parameters to filter results or specify additional options.

   • Click ‘+ Add Item’ to add more parameters.

6. Enter JSON Body

   • Provide structured request data in JSON format.

   • Example:

{
  "title": "New GitLab Issue",
  "description": "Detailed description of the issue",
  "assignee_ids": [12345],
  "labels": "bug, urgent"
}

1. Set Timeout (in Seconds)

• Define the request timeout duration to prevent long-running API calls from stalling the process.

Note: Click 'f' to insert dynamic values for flexible configurations.