Skip to main content
Jump to: navigation, search

Difference between revisions of "Orion/Documentation/User Guide/Reference/Repositories page"

(Actions on a repository)
(Adding branches)
Line 27: Line 27:
  
 
== Adding branches ==
 
== Adding branches ==
Once a repository is created or cloned, the <b>master</b> 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 <b>Branch</b> row in the repository table to pop up the <b>Add Branch</b> icon.  
+
Once a repository is created or cloned, the <b>master</b> branch is set as the current branch. You can create your own branch, work on it and merge it back to master. Go to the <b>Branches</b> section and click <b>Add Branch</b> icon.  
  
 
[[Image:Orion-repository-page-add-branch.png]]
 
[[Image:Orion-repository-page-add-branch.png]]
  
Click on the action and input the branch name. Hit 'Enter' to create the branch.
+
Input the branch name. Hit 'Enter' to create the branch.
  
 
[[Image:Orion-repository-page-add-branch-name.png]]
 
[[Image:Orion-repository-page-add-branch-name.png]]

Revision as of 12:53, 27 February 2012

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.

Orion-repository-page.png

To see detailed information about a repo click its name. The detailed view includes all the usual Git repository details as name and url. You can find the index state and list of incoming and outgoing commits for the active branch. You may also see the list of the latest branches and tags. To see full lists, click View All links.

Orion-repository-page details.png

Repository configuration

The repository page shows the configuration of the repository. On the main page you will see just user.*. To see the full list, click View All. From here you can add additional configuration properties to the repository, and change or delete properties.

Orion-repository-page-config.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, navigate to the Navigator page or to Git Status page using actions in the Repository section.

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 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. Go to the Branches section and click Add Branch icon.

Orion-repository-page-add-branch.png

Input the branch name. Hit 'Enter' 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 repository 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 branches using these actions.

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

Deleting a local branch

From the branch actions, click Remove Branch to delete a local 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 a merge action if there is a remote tracking branch. But normally the remote branch does not exist for a newly created branch until you push it. From the actions when you hover over the branch, click the Merge icon to merge from the remote tracking branch into your local working copy.

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.

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

Fetching remote branches

If somebody else has 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 somebody 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 Fetch, and enter your credentials if required to access the repository. The remote branches are updated.

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

Actions on a remote branch

Actions on a remote branch are different from those on a local branch. But the Show Git Log and Merge actions are same. The Show Git Log action will navigate to the same log page but with the remote branch content. You can also switch to the local branch content there. Hover over the remote branch name row in the Remote table to pop up actions as below. You can manage the remote branch by these actions.

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

Checking out a remote branch

Normally a newly fetched remote branch is not in your local branches yet. You have to checkout in order to work on it. From the actions when you hover over the branch, click the Checkout icon.

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

The remote branch is checked out as the current local branch.

Orion-repository-branch-actions-remote-checkout-result.png

Please note that if you try to check out a remote branch that already has a local branch in your repository, you will get a warning message : "the local branch already exists".

Fetching and merging content of a remote branch

You can fetch a remote branch and merge it to a local branch which is tracked by this remote branch. From the actions when you hover over the branch, click on the second and third action to fetch and merge from the remote tracking branch.

Orion-repository-branch-actions-fetch-merge.png

Orion-repository-branch-actions-fetch-merge commitsection.png

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

Resetting local index from a remote branch

You can also reset a local branch to replace with the contents of the remote tracking branch.

Orion-repository-branch-actions-remote-reset.png

From the actions when you hover over the remote branch, click the Reset Index icon to reset the local branch content. A dialog will pop up asking for confirmation.

Orion-repository-branch-actions-remote-reset-confirm.png

Back to the top