GIT Integration

Introduction

From Version 1.8.11 onwards, Git integration is supported in Provar. Provar can import an existing Test Project from Git and push work once it is completed.

Enabling the Git Plugin

When using the Git plugin for the first time, or after updating to a new version of Provar, the plugin must be enabled in your Provar instance.

First ensure you are running Provar as an administrator.

In Windows this is done by right-clicking on provar.exe and selecting ‘Run as administrator’:

On a Mac this is done by opening the Terminal, running sudo /Applications/Provar.app/Contents/MacOS/provar then entering the Admin password:

Then go to the toolbar in Provar and click Help > Add/Remove Features:

Tick the checkbox against the EGIT plugin:

Then click the ‘Install’ button.

The following dialog box will appear:

Click ‘OK’. The plugin options will become available for use after a restart.

Importing a Project

On the Provar Welcome Screen, click the link ‘Import a Test Project from Git’:

This will present the following screen:

There are two options for adding a GIT repository: adding an existing repository from your local file system, or cloning a remote repository.

Option 1: Adding an Existing Repository

To add an existing repository, first ensure that you already have the relevant repository in your local file system. This could be done by cloning it in advance, creating it from scratch or copying it from another location.

Select Existing local Repository then and click the ‘Next’ button:

On the next screen, specify a directory and then 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 repositories to add:

Select the desired repositories then click the ‘Finish’ button.

On the next screen, select the desired import process. The default option ‘Import existing Eclipse projects’ is recommended:

Then click the ‘Next’ button.

The next screen will display available Test Projects in the repository:

Click the ‘Finish’ button to import the selected Test Project into the workspace.

Option 2: Cloning a remote repository

Cloning a remote repository will copy a repository to your local file system.

To clone a remote repository, first click the link ‘Import a Test Project from Git’ on the Provar Welcome Screen:

Then select ‘Clone URI’ and click the ‘Next’ button:

The following screen will be presented:

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. (Note that you can use the ‘Local File…’ button to browse for a local directory. The URI field offers content assist by suggesting previously used values
  • Host: The name of the remote host or empty if cloning from the file system
  • Repository Path: Path to the remote repository or on the file system
  • 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

Then click the ‘Next’ button to move onto Branch Selection.

Branch Selection

The following screen will display branches available for selection in the repository.

If you have multiple repositories, select the repository which contains your project:

Then click the ‘Next’ button.

Select the workspace by clicking the ‘Browse’ button:

Then click the ‘Next’ button.

The following screen will display the project for import:

Click the ‘Finish’ button to import the project.

Committing and Pushing to Repository

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 > Push Branch [BranchName]…:

This will display the following screen:

Specify your preferred settings then click the ‘Next’ button.

This will display a Push Confirmation:

Click the ‘Finish’ button to push to repository.

The results will be displayed as follows:

Then click ‘OK’ to finish.

2017-06-08T14:44:11+00:00

Leave A Comment