-
Ultimate and Enterprise plans (Legacy)
Get in touch with Sales for licensing questions.
Tip
For information about GitLab integration in Phrase Strings, refer to GitLab (Strings).
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.
-
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 , check the api and read_user checkboxes.
-
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 connector.
The page opens.
-
Change the Type to GitLab and provide a name for the connector.
-
Optionally select and provide a .
-
Enter (e.g https://gitlab.com/) and the you have obtained from the GitLab site.
-
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. Hover over the icon to see additional details.
-
Click Save.
The connector is added to the list on the page.
Delete a Connector
To delete a connector:
-
From the page, select the connector to delete.
-
Click Delete.
The window opens.
-
Type "delete" and click Delete.
The connector is deleted and the list of connectors is displayed.
Note
A connector cannot be deleted while it is still linked to incomplete jobs in a project, including jobs sitting in the Recycle bin. Attempting to delete such a connector returns a "Failed to delete connector" error.
Resolution: Open the project associated with the connector and complete or delete any remaining jobs. Go to , and empty it to remove any jobs still linked to the connector. Retry deleting the connector.