SourceTree Installation and Configuration

Install SourceTree and Configure Credentials

In order to start working with your Bitbucket repositories, you must first install and configure sourceTree. 

1. Download and install SourceTree.
2. Post installation, launch SourceTree.
3. From the Tools menu, select Options.
4. In Authentication, click Add.
   1. Set Hosting Service as Bitbucket.
   2. Set Prefered Protocol as HTTPS.
   3. Authentication as Basic.
   4. In Username, enter your Bitbucket account username.
   5. Click Refresh Password to authenticate username.
      
      An Authentication window appears.
   6. Enter your Bitbucket password.
      
   7. Select the Remember Password option and then click Login.
      SourceTree is now configured for working with the Bitbucket repositories.

Creating and Cloning Repository

After you configure SourceTree, you can now create a repository and clone it on the local system.

This activity needs to be performed by Qualitia Administrator who is responsible for creating projects. 

To create and clone repository:

1. Launch SourceTree.
2. Click Create.
3. In the Destination Path, select a folder path where you would like to save and work on your local repository.
4. Enter the prefered repository name.
5. Select GIT.
    Qualitia supports GIT repositories only. Support for Mercurial is not yet added.
6. Select the Create Repository on Account option.
   In Repository Settings, Bitbucket account details appear that are added while configuring SourceTree. 
7. Add Description, if required.
8. Select Is Private option to mark this repository as a private repository. 
   Keeping repositories private enables you to control who can access and update data from your repository. This is important to avoid discrepancy in the project data.  
   
   
9. After the repository is created and cloned, add a sample text file into the repository and commit it.
10. To commit sample file, 
    1. Navigate into the folder where you have cloned the repository on the local system.
    2. Create a new sample.txt file with sample text in it.
    3. From SourceTree, stage the file and add comment, if required.
    4. Select Push changes immediately option and click Commit.

Adding Existing Qualitia Projects to Bitbucket Repository

After you clone the repository, you can now add your existing Qualitia projects to the Bitbucket repository.

To add existing projects to Bitbucket repository:

1. Navigate into the folder where you have cloned the repository.
2. Move your existing project folder (<ProjectName>_projectdb) to this location.
   You can get this folder at the location specified in Qualitia Configuration Setting > Dependency > Project Path.
3. Launch SourceTree.
4. Create a new branch with your Qualitia Project name.
   To create a new branch:
   1. Click Branch > New Branch.
   2. Enter New Branch name.
   3. Ensure that Checkout New Branch option is selected.
   4. Click Create Branch.
      
5. After creating a branch, right-click the branch and select Push > Origin.
   
6. Stage all files and add comments, if required.
7. Select Push changes immediately option and click Commit.
8. Now copy the directory path of the repository (from local system) and set it as Qualitia Project Path (in Configuration Setting > Dependency).
9. Also, in Configuration Setting > General, select Version Control as GIT and add Bitbucket username and password.
10. Restart Qualitia to start working on the projects that are integrated with Bitbucket repository.