-
Ultimate and Enterprise plans (Legacy)
Get in touch with Sales for licensing questions.
Git connector allows the downloading of source files and uploading of target files directly from/to the Git repository. Phrase clones the remote repository locally and uses git commands to communicate with the remote repo.
If the repository is hosted by GitHub or GitLab, use the dedicated connector instead of the generic Git connector.
There are a number of use cases for the connector:
-
Project managers can add files directly to projects from an online repository. View changes submitted since the last commit by clicking the show link in the middle of the screen.
-
Set up the submitter portal allowing Submitters to add files to requests directly from the online repository. View changes submitted since the last commit by clicking the show link in the middle of the screen.
-
Use automated project creation to have new projects automatically created when a new commit is detected in monitored files, folder, or an entire subdirectory.
-
This connector supports absolute path setting. Target translation files can be stored in a different branch than the source files.
-
When APC is set to monitor subfolders, the target folder will have the same subfolder structure as the source folder.
-
All files from the monitored folder are imported the very first time APC runs. Newly added files are imported with the next triggered monitoring after their creation.
-
Exception GitLab: If the option is selected, APC does not import any files the first time it runs. If source files are updated or new files are added to those folders, APC creates a project and imports the files.
-
-
-
Set up continuous jobs to have selected files monitored for changes.
Git Settings
No changes are required.
-
From the Settings
page, scroll down to the section.
-
Click on Connectors.
The
page opens. -
Click New connector.
The
page opens. -
Provide a name for the connection and change the Type to Git .
-
Enter the repository address into the Repository URI field.
-
The repository address is the connection string used to clone the repository (e.g. git@gitlab.com:joe.doe/my-repo.git)
-
In order for to access the repository, it has to be reachable from the Internet.
-
-
Select an
.-
For Username and Password or Personal Access Token, if basic authentication is not supported (e.g. GitHub).
access enter the-
If using password access, the https:// (e.g. https://github.com/joe.doe/my-repo.git).
starts with -
The personal access token needs to have appropriate read/write rights.
-
-
For Private key and optionally enter the Private key passphrase.
access load the-
If using a private key, the git@.
starts with -
Only legacy PEM private key format is supported when using the private key for authentication. Use the -m PEM option when generating the private key.
-
-
-
Provide a
if required. -
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.