Git and Automation Projects

Once the Git plugin is installed, you will need an Automation Project to work on.

This can be done in various ways:

1. By importing a Automation Project from an existing local repository
2. By cloning from an existing Project stored in Git
3. 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.

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 know its location. 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 the 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 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 the 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 Automation 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.

Select the files you want to commit in the next screen 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 that 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. Please refer to Pull Requests and Resolving Conflicts for better practice in resolving conflicts.

Click Next.

On the next screen, review the details of the push you will 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, select your files, and 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.