Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Orion/Documentation/User Guide/Reference/Repositories page

Repositories page

The Repositories page allows you to view and manage the Git repositories associated with your Orion account. When you visit this page you will see a list of all Git repositories you currently have cloned. Expand a repository to view the local and remote branches available in your clone. The currently checked out local branch is shown in bold.

Orion-repository-page.png


Adding repositories

Create a new empty repository by clicking Init Repository on the tool bar, or click Clone Repository to clone an existing Git repository. Cloning will produce a dialog where you enter the Git repository URL, and optionally any credentials required to access or modify the repository.

Actions on a repository

You can delete an existing repository or navigate to the Navigator page. Hover over the repository name row in the repositories table to pop up actions as below.

Orion-repository-repo-actions.png

Clicking on the Delete action will pop up a confirmation dialog and you can decide if you want to delete it. Clicking on the Show in Navigator navigates to the Navigator page.

Adding branches

Once a repository is created or cloned, the master branch is set as the current branch. You can create your own branch, work on it and merge it back to master. Hover over the Branch row in the repository table to pop up the Add Branch action icon. Then hover over the action.

Orion-repository-page-add-branch.png

Clicking on the action and input the branch name. Hit enter key to create the branch.

Orion-repository-page-add-branch-name.png

Actions on a local branch

Once a new branch is created, it is in the local but not in the remote yet. Hover over the branch name row in the Branch table to pop up actions as below. You can manage the branch by these actions.

Orion-repository-page-branch-actions-not-current.png

Deleting a local branch

From the actions when you hover over the branch, click on the first action to delete the branch. A confirmation dialog will pop up and you can decide if you want to delete it.

Orion-repository-page-branch-actions-delete.png

Navigating to log page

You can navigate to the Log page to see details on the branch. From the actions when you hover over the branch, click on the Show Git Log as the link to the Git log page.

Merging from the remote tracking branch

You can also perform merge action if there is a remote tracking branch. But normally the remote branch does not exist yet for a newly created branch before you push it. From the actions when you hover over the branch, click on the third action to merge from the remote tracking branch.

Orion-repository-page-branch-actions-merge-local.png

Please note that you can achieve the same result by performing the same action in Log page or Status page.

Setting a local branch as current branch

The newly created branch branch is not set as the current branch yet. Let's say you want to work on this branch now. From the actions when you hover over the branch, click on the last action to checkout the branch.

Orion-repository-page-branch-actions-checkout.png

Once a branch is checked out, it is shown as bold. Please note that from now the Git Status page will show the content on this branch.

Orion-repository-page-branch-actions-checkout-bold.png

Pushing a local branch

Once a branch is checked out, the actions change as below when you hover over the branch.

Orion-repository-page-branch-actions-push.png

Clicking on the Push All action will create a remote tracking branch if there is not one yet.

Orion-repository-page-branch-actions-push-result.png

Please note that you can achieve the same result by performing the same action in Log page or Status page.

Fetching remote branches

If some bodies else have pushed their branches into their repository/Remote/origin but those branches do not appear in your repository/Remote/origin yet, you have to fetch them first. Let's say some body has pushed a branch called newBr1 in the remote. Hover over the Remote/origin row in the repository table to pop up the action icons.

Orion-repository-page-fetch-remote.png

Click on the Fetch action and put credentials if required to access the repository. The remote branches are updated.

Orion-repository-page-fetch-remote-result.png

Back to the top