Git and Provar projects
Once the Git plugin is installed, you will need a Provar Project to work on.
This can be done in various ways:
- By importing a Provar Project from an existing local repository
- By cloning from an existing Project stored in Git
- By creating a Project locally and linking it to Git
Select one of these options to get started.
Once you have your Project sorted, refer to Working with Git for more best practices on using Git with Provar.
Git plugin information
With Provar version 2.2.0 and future releases, you no longer need to install the Git plugin. We’ve packaged this together with our installer files. As a result, the Provar plugin installer will no longer show Git as an option. You can still enable the Jira, TFS and SVN plugins as previously.
Option 1: Importing a project from an existing local repository
To import a Project from an existing local repository, first ensure that you already have the relevant repository in your local file system and you know where it is located. This could be done by cloning the repository in advance, creating it from scratch or copying it from another location.
Click Import from File on Welcome to Provar screen.
This will display the Select Repository Source screen. Select Existing local repository. Click Next.
On the next screen, specify a directory and click Search to trigger a scan for Git repositories contained in that directory.
If Git repositories are found, they will be listed and you can select one or more to add.
Select the desired repository, then click Finish.
On the next screen, select the desired import process. The default option Import existing Eclipse projects is recommended.
Click the Next.
The next screen will display the available Test Projects in the repository.
Click Finish to import the selected Test Project into the workspace.
Option 2: Cloning a Project from Git
Cloning a remote repository will copy a repository from Git to your local file system.
To clone a remote repository, first click Import from File on Welcome to Provar screen.
Then, select Clone URI and click Next.
The following screen will be displayed.
Enter the information as follows:
- URI: The complete URI of the remote repository or the path on the file system. This field is automatically synchronized with the other fields.
- Host: The name of the remote host
- Repository Path: Path to the remote repository
- Protocol: The following Protocols are supported:
- file: File system access to the repository
- ftp: File Transfer Protocol
- git: The most efficient built-in git protocol (default port 9418). This protocol doesn’t provide authentication. Typically used for anonymous read access to the repository
- http: Hypertext Transfer Protocol can be tunneled through firewalls
- https: Hypertext Transfer Protocol Secure can be tunneled through firewalls
- sftp: SSH File Transfer Protocol
- ssh: Git over secure shell (SSH) protocol. Typically used for authenticated write access to the repository
- Port: Port number
- User: The username used for authentication
- Password: The password used for authentication
- Store in Secure Store: Whether the password is saved in the Eclipse secure store
Click Next.
The Branch Selection screen will display branches available in the repository.
If you have multiple repositories, select the one which contains your project.
Click Next.
Click Browse to select the workspace.
Click Next.
The following screen will display the project for import.
Click Finish to import the project.
Option 3: Linking a local project to Git
To link a local Project to Git, you must first have created a Project in Provar which can be pushed to Git. (Refer to Creating and Importing Projects for information on how to do this.)
Once you have a Project ready to be linked, right-click on the Project Name in the Navigator, then select Team > Share Project.
A Share Project screen is displayed as shown below. Select the repository type and click Next.
Browse a path for the repository field.
Click Finish.
Right-click on the Project and select Team > Commit.
In the next screen, select the files you want to commit and add comments.
Click Commit.
Right-click on Project and select Team > Push Branch ‘master’.
Enter the repository URL, User and Password.
Click Next.
On the next screen, enter your chosen branch (it should be ‘master’ in this case), select the Force Overwrite check box.
Note: Since the Force Overwrite checkbox is selected, this push will overwrite any files on the remote branch which conflict with the ones you are pushing. This option is therefore not recommended for use in general workflow as there is a risk of losing work. For a better practice in resolving conflicts, please refer to to Pull Requests and Resolving Conflicts.
Click Next.
On the next screen, review the details of the push you are about to make.
To confirm the push, click Finish.
Committing work
Once changes have been completed, the work should be committed and pushed to the repository.
To commit work, right-click on the Project in the Navigator view, then select Team > Commit…
This will display the following screen.
Enter a Commit message and select your files, then choose Commit and Push or Commit.
Pushing commits
All committed tasks need to be pushed to the repository.
To push your committed work, right-click on the Project in the Navigator view, then select Team > Repository > Push Branch [BranchName]…:
This will display the following screen.
Specify your preferred settings and click Next.
This will display a Push Confirmation screen.
Click Finish to push to the repository.
The results are displayed as given below.
Click OK to finish.
Once you have your project sorted, refer to Working with Git for more best practices on using Git with Provar.