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.
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.
If the option is selected in APC:
-
If remote and subfolders are monitored, no files are imported the very first time APC runs. If source files are updated or new files are added to those folders, APC creates a project and imports the files.
-
If specific files in a remote folder are selected, the option is ignored and the specified files are imported on the first run.
If the option is not selected in APC:
-
If a remote folder is monitored, all files from that folder are imported.
-
If specific files are monitored, only those files are imported.
-
-
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.
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 access enter the Username and Password or Personal Access Token, if basic authentication is not supported (e.g. GitHub).
-
If using password access, the starts with https:// (e.g. https://github.com/joe.doe/my-repo.git).
-
The personal access token needs to have appropriate read/write rights.
-
-
For access load the Private key and optionally enter the Private key passphrase.
-
If using a private key, the starts with git@.
-
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. Mouse over the icon to see additional details.
-
Click Save.
The connector is added to the list on the page.