HomeContact
Archive
Using SourceTree and Git for Research (Part 2): Bitbucket
Jon Page
June 06, 2013
2 min

Table Of Contents

01
Making a remote version on Bitbucket
02
Inviting a collaborator
03
Viewing a collaborator's commit
04
Conclusion

In the first part of this tutorial we created a local git repository with SourceTree, committed a change, and reviewed the commit history. Make sure you have either already completed the previous part of this tutorial, or that you already have a repository on SourceTree you want to link up with Bitbucket.org.

Making a remote version on Bitbucket

While you can create a new remote repository to connect to on Bitbucket.org, here we will do this from within SourceTree.

Open SourceTree and click the “Settings” button.

Settings
Settings

Click “Add”.

Remotes
Remotes

Click the button with a globe icon.

Globe
Globe

Click the “Create New Repository …” button.

create_new_button
create_new_button

Fill out the new repository dialog. Set “Name” to ”itn_project”, add a description if desired, and make sure to uncheck the “Publicly Visible” option. Finally, click “Create Repository”.

Create new dialog
Create new dialog

Notice that now you have an entry in your list for “itn_project” that is hosted by Bitbucket. Click “OK”.

link_repository
link_repository

Set “Remote Name” to ”itn_remote” and click “OK”.

remote_name
remote_name

lick “OK” one last time. Finally, click the “Push” button to push the repository you have been working on to the remote one you just created.

push_repo
push_repo

Make sure the “Local Branch” “master” is checked. Then click “OK”. Enter your password if requested to push the repository.

push_repo2
push_repo2

Inviting a collaborator

Go to Bitbucket.org and login. Click on the “Repositories” menu at the top and choose your newly created repository.

online_repo
online_repo

You should now see something like the following screenshot. This shows that your repository has been setup on Bitbucket.org.

online_repo_overview

Click the “Share” button.

bitbucket_share

Next, enter the email address (or Bitbucket username if you know it) of the collaborators you want to add to this repository (i.e. your coauthors) and then click the “Add” button. Here, I’m going to add Joseph Page.

bitbucket_share2
bitbucket_share2

Before clicking “Share”, set the permissions of this new user of your repository. I set Joseph’s permissions to “WRITE” because I want him to be able to push commits to the repository (see the documentation for more details on permissions).

bitbucket_share3
bitbucket_share3

Click “Share” to invite your new collaborator. This will send a link which your collaborator can use to access the repository. Once they login to Bitbucket they will be able to access your repository.

Viewing a collaborator’s commit

Once your collaborator has pushed a commit (i.e. made changes and updated the repository) you will see this on the main page for your repository.

collab_edit
collab_edit

You can see Joseph left the following commit message:

made a few edits and added author name

Click on the link to the commit (see picture below).

collab_edit2
collab_edit2

This pulls up the summary of the latest commit. Scroll down to view the changes that were made.

collab_edit3
collab_edit3

Conclusion

This tutorial (and the previous one) merely scratched the surface of how leveraging DVCSs, such as git and hg, can enhance your research productivity. Using SourceTree, integrating these tools is easier than ever.

Have fun with Bitbucket and let me know if you have any questions in the comments below!


Tags

#bitbucket", "#git", "#sourcetree

Related Posts

Using SourceTree and Git for Research (Part 1)
May 31, 2013
3 min
© 2022, All Rights Reserved.

Quick Links

About UsContact Us

Social Media