dl-breadcrumbs__homedl-breadcrumb-item__separatorConfiguration and programmingdl-breadcrumb-item__separatorEngineering interfaces and toolsdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorCODESYS Gitdl-breadcrumb-item__separatorReferences, User Interfacedl-breadcrumb-item__separatorViews and Dialogsdl-breadcrumb-item__separatorView: Git Remotes
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
View: Git Remotesdl-permalink__symbolPermalink

Symbol: _git_icon_remotes

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.

_git_icon_add_remote  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

_git_icon_delete_remote 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.

_git_icon_rename_remote Rename

The Alias name of the remote repository can be changed.

_git_icon_set_url 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.

_git_icon_fetch Fetch

_git_icon_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 _cds_icon_arrow_down button. This fetch command has the effect that remote branches which no longer exist in the remote repository are deleted from the local repository.

edit_credentials  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.

For the selected remote repository (remote name), the list box provides every URL for which the repository can provide credentials. The credentials for the selected URL can then be saved, deleted, or changed. It is recommended that you store the credentials for the first URL in the list box because they can then also be reused for other projects within the "domain". ⮫ “Dialog: Credentials needed”

Editing in the dialog 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.

Table

Name

Alias name of the remote repository

URL

URL or file path of the remote repository