Configuring GitLab integration

Xapi enables the organization owner and organization admins to configure GitLab (opens in a new tab) integration in a project.

To configure an integration:

💡

Before you begin:

Click ADD INTEGRATION.

Note that the Choose Integration pop-up will be appeared.

a. On the Integration Type drop-down, click Git Integration.

b. On the Integration Platform drop-down, click GitLab Sync.
Click Select. Note that the Configure GitLab Integration pop-up appears.
Under the CONNECT GITLAB tab, connect to your GitHub account.

📃
Note: Fields marked with * are mandatory.

Field	Description	Sample Value
Name*	This uniquely identifies the integration.	Production Service
Host*	This is the URL of the host GitLab server. Default is set as https://gitlab.com (opens in a new tab). 📃 Ensure that the URL begins with either http:// or https://.
Personal Access Token*	To connect to your GitLab account, you may enter your GitLab token manulally. ℹ️ To create a GitLab personal access token with selecting api scope, see Create a personal access token (opens in a new tab). Make sure to have the required permissions to access the repository.

a. Click Next.

b. Under DETAILS, enter the configuration details as given below.

📃

Note: Fields marked with * are mandatory.

Feild	Description
Repo Owner*	This lists down the repository owners of the connected GitLab account. You may select a repository owner from the list.
Repository*	This lists down the repositories of the connected GitLab account. 📃 Note: The repository must contain at least one file.
Branch*	This is to specify the synchronizing branch. You may either: Specify an existing branch name Create a new branch by specifying a branch name.
Generate API Code*	This specifies the API specification that you wish to generate, indicating whether global references should be included or excluded. The available file types are as follows: JSON Resolved JSON Unresolved YAML Resolved YAML Unresolved
Output Folder Path	This specifies the folder in which your API specification will be generated in the chosen GitHub repository when pushing the API. It is relative to the root folder of your repository. If the specified folder does not exist, a new folder will be created based on the given path. 📃 Note: Your path will be seperated by '/'. ℹ️ Your output folder path gets created according to the project catalog path in Xapi. Example: `output folder path/catalog/API name/API version`
Default Integration	This designates the integration as 'default'. If this is selected, the API will synchronize with the default integration. ℹ️ If you do not choose a default integration, the system will automatically set the first created integration as the default.

c. Click Next.

d. Under REVIEW, you may review the entered details.

Click Integrate. Upon successfully configuring the GitHub integration, a success message appears.

💡

What’s Next?

GitHub Bitbucket