Configuring Connect for Version Control using Git

Owned by Akash Kumar Jaiswal (Unlicensed)
Last updated: Dec 16, 2021 by Rohan Dhanwade (Deactivated)Version comment
3 min read

This section covers the steps that you need to follow to enable versioning in Adeptia Connect.

This page contains the following information:

Prerequisites

You must login as Admin user to change the system properties. 

Installing Git Version Control system

To download installer, refer to the website https://git-scm.com/downloads. 
Download Git from any of the distributor of your choice. Run the downloaded Git Installer and complete the installation by referring to https://git-scm.com/book/en/v2/Getting-Started-Installing-Git.

Configuring Version Control using Git

  1. Click Account > Settings.
  2. Expand Microservice Settings, and then select WebRunner in the left panel.
  3. Expand the property category, Version Control.

  4. Double-click the corresponding value fields for the following properties to change their values.

    The default value of the abpm.versionControl.enable property is false. To configure Git and enable versioning in the Adeptia Connect, you need to enter values for all the Version Control properties.
    1. Set the value of the abpm.versionControl.enable property to true.

    2. Set the value of the abpm.versionControl.client property to GIT.

    3. You can set the value of the abpm.versionControl.repository.access.protocol property to HTTPS or HTTP.

    4. In the abpm.versionControl.repository.url property, enter the IP address of the Bitbucket server. This action enables you to connect the Git server with the Adeptia Connect by using the protocol mentioned in the previous step. 

      You need to define the hostname or IP address of Bitbucket server as per the syntax below: 
       <access protocol>://<hostname >:<port> 
      where 
       <access protocol> is the protocol that you will select to access the Bitbucket server. You access Bitbucket server by using the HTTPS or HTTP protocol.
       <hostname> is the IP address of the Bitbucket server. 
       <port> is the port at which Bitbucket server is running. By default, the Bitbucket server uses the 7990 port. 

      To get the Bitbucket Server Repository Link, follow the steps: 

      • On Bitbucket Repository page, select the Repository.
      • Click Clone icon and copy the link.





      Enter this link in the abpm.versionControl.repository.url property.
    5. In the abpm.versionControl.username property, enter the username that you want to use to access host repository.
    6. In the abpm.versionControl.password property, enter the password of the username that you have mentioned in the previous steps.

    7. In the abpm.versionControl.projectPath property, enter the path where you want to create the local copy of the Git project. This path must exist on the machine, where you have installed the Adeptia Connect. 

      Ensure that Repository URL is changed accordingly in case you are updating the Project URL for seamless operation of Version Control System.

      When you Check-In the activity of the Adeptia Connect for the first time, Adeptia Connect creates a local copy of the project on the path that you have specified in the abpm.versionControl.projectPath property. At the same time the Adeptia Connect also creates a project with the same name as in Git. 

    8. Enter the Keystore path for client authentication in the abpm.versionControl.keystore.path property.

    9. Enter the password of the Keystore for client authentication in the abpm.versionControl.keystore.password property.

      You need to enter the values in the abpm.versionControl.keystore.path and abpm.versionControl.keystore.password properties only when you use a HTTPS or HTTP protocol on an Bitbucket server which is client authenticated.

  5. Click Update.
    You'll see a message saying 'Properties saved successfully'.

Creating and performing operations on a branch in version control system

The versions of Adeptia Connect services can be managed on a branch other than the master branch in Git. For this, you need to create a branch in Git and then configure the following properties in Adeptia Connect to enable version control operations on that branch.

Prerequisites
  • Ensure that you have created a branch in Git before you proceed to configure the version control system properties.

Configuring the version control system properties

Follow the steps below to configure the version control system properties in Adeptia Connect:

  1. Follow the steps from 1 through 3 given in the previous section.
  2. Double-click the corresponding value fields for the following two properties to change their values.

    1. Enter the branch name, which you have created earlier, as a value for the abpm.versionControl.repository.branch property. This is where all the version control operations will be performed.

      By default, the version control operations are performed at the master branch.
    2. Enter the path (folder name) where you want to create the local copy of the Git project in the abpm.versionControl.projectPath property.
      This path must exist on the machine, where you have installed the Adeptia Connect.
  3. Click Update.
    You'll see a message saying 'Properties saved successfully'.

Removing a checked-in version of an activity from version control system

You can remove the checked-in version of an activity from version control system by using the Uncheck option for that activity under More menu.