View: Git Remotes

Symbol:

Corresponding Git command: git remote

Function: The view is used to manage the remote repositories, which are used to manage CODESYS projects on where multiple users should be able to work. Local repositories of individual users can establish a link to a shared remote repository and synchronize/merge their commits there.

Call: Git → Remotes menu

Requirement: A project is open and managed in Git.

The view is refreshed.

Add

Opens the Add new Remote dialog to specify the remote repository with which the CODESYS project should be linked

Alias name

Note: The usual name in Git for the remote repository is origin.

URL: URL or file path of the remote repository

The following protocols are currently supported: HTTP, HTTPS, local.

Examples: file:///D:/GitRep/Remote/<repository name>, https://dockerhostpde/testuser1/publicproject.git

Remove

The user is prompted whether to remove the link to the remote repository from the project.

Note: All remote branches that belong to the deleted remote repository are deleted. The local branches are retained, but no longer track the deleted remote branches. This action cannot be undone.

Rename

The Alias name of the remote repository can be changed.

Set URL

Opens the Set URL for Remote <remote> dialog

Here, the path specification (URL or file path) for the currently used remote repository can be changed.

Changing the path information and therefore the link to the remote repository can cause remote branches to disappear. Therefore, the user has to reassign the mappings from local branches to remote branches (tracking). The local branches are not changed.

Fetch

Fetch (prune)

The local representative of the remote repository (example: origin/master) is updated with the status of the remote repository used by all users. All changes are applied from the remote repository. These are all new branches and new commits in the remote branches. However, the commits are not applied to the tracking branches.

Note: To update a local branch with the current status from the remote branch, a Pull operation also has to be performed in the Git Branches view.

As an option, you get the Fetch (prune) command by means of the button. This fetch command has the effect that remote branches which no longer exist in the remote repository are deleted from the local repository.

Credentials

The button opens the Edit Credentials dialog. The User name and Password for access to the remote repository can be specified and edited here. The Remote name and URL are displayed, and the user name and password can be edited.

This replaces the editing in the Windows Credential Manager.

Note: A PAT (personal access token) is required when working with GitHUb. Then the PAT has to be specified instead of the password. Example of a PAT in GitHub: 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

Table

Name:

Alias name of the remote repository

URL

URL or file path of the remote repository