GitLab connector allows the downloading of source files and uploading of target files directly to/from the GitLab repository. The connector uses the GitLab API to implement the integration and allows access to all repositories associated with a GitLab account.
There are a number of use cases for the connector:
-
Project managers can add files directly to projects from an online repository.
-
Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.
-
Use automated project creation (APC) to have new projects automatically created when a change in file size is detected in monitored files or a folder.
-
Due to limitations in the GitLab API, monitoring an entire folder is not supported.
-
Selected documents are imported the very first time APC runs.
-
Use the Git connector if you need to monitor an entire subdirectory.
-
This connector supports absolute path setting. Target translation files can be stored only in the same branch as the source file.
-
-
Set up continuous jobs to have selected files monitored for changes.
Tip
If requirements are:
-
Limiting Phrase access to a single repository.
-
Using an SSH key for authentication.
-
Detection of file changes based on Last modified date as opposed to just file size.
Use Git connector to connect to GitLab.
Create an access token in the GitLab account.
-
Log in to the GitLab account, navigate to
and click on .The
screen opens. -
Fill in the
and fields. Choose a longer time period so the token doesn't require frequent recreation. -
Under api and read_user checkboxes.
, check the -
Click on Create personal access token.
This generates a token needed to enter into the connector configuration.
-
The token is only visible at this stage and cannot be reached afterward.
-
-
From the Settings
page, scroll down to the section.
-
Click on Connectors.
The
page opens. -
Click New.
The
page opens. -
Provide a name for the connection and change the Type to GitLab .
-
Optionally select
and provide a . -
Enter https://gitlab.com/) and the you have obtained from the GitLab site.
(e.g-
In order to access the repository, it must be accessible from the Internet.
-
-
Click Test connection.
A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Mouse over the icon to see additional details.
-
Click Save.
The connector is added to the list on the
page.