Git Integration
Git is a distributed version control system that enables developers to track changes made to their code base managing different versions, collaborating with others, and maintaining a record of changes. It's a decentralized system, allowing developers to work offline with a local copy of the project history. It enables independent work on features or fixes, merging changes into a unified codebase.
Git Integration in Avo Assure
Avo Assure Git Integration facilitate efficient and collaborative testing environment. by allowing teams to manage test plans and scripts effectively. This integration ensures that all changes are documented, and multiple users can work on different tasks simultaneously.
The integration of Git with Avo helps:
Version Control: Keep a track of version control and maintains a history of changes to test plans and scripts.
Collaboration: Git integration enhance collaboration of multiple team members to work on test scripts simultaneously.
Backup: Provide a backup mechanism to securely store all tests and configurations in a remote repository.
Branching and Merging: Allows you to create separate branches for new tests or features, enabling testing in isolation. Later, these can be merged into the main branch after thorough review and testing.
Prerequisites
A few prerequisites user must keep ready for logging in Git dashboard page are:
GitHub credentials: Ensure to keep GitHub username and password ready
GitHub Repository: Ensure to create GitHub repository
GitHub URL: Ensure to keep the right GitHub URL ready
GitHub Token: Generate the GitHub API Token required
Avo Assure Client: Ensure Avo Assure Clients successfully connected with Avo Assure
Steps to Obtain Prerequisite
Let’s view the steps to generate GitHub API token.
GitHub API Token Generation
The steps-by-step process to generate token in Git are:
1. Navigate to GitHub's website, login by entering valid username and password provided by organization
2. Click Profile -> Click Setting button
3. Click Developer setting to bring up a new screen
4. Click Personal access Token -> click Tokens (Classic) -> click Generate new token form the left side options present on the screen. To bring up ‘New personal access token’ window on the screen
Fill Note text box with any name -> Select Expiration date form Expiration dropdown -> Select scopes
Note: Scopes are permissions that dictate what an authentication token can do in GitHub. When creating a new token, users can select specific scopes that outline the level of access and actions the token is permitted to perform.
Click Generate token
Note: Copy token and paste it in the notepad for using it later
Git Configuration in Avo Assure
Login into Avo Assure using valid credentials. After successful login, Avo Assure landing page appears on the screen.
1. Select the Project for integration with Git from All Projects section available on the left side of the landing Page.
Click Setting tab -> Click Manage Integrations button to navigate to Manage Integrations window.
2. Navigate to Versioning tab to configure version control settings. Select Git from the left-hand side dropdown as integration option
3. Fill in the necessary configuration fields, including:
User and Project: Select the User and Project from dropdown menu
Configuration: Enter a descriptive name for the configuration
Access Token: Enter token used for authentication with your Git account
Git URL: Provide the URL where the Git repository is hosted
Git Username: Enter Git username associated with the account
Git User Email: Enter Git user email associated with the account
Git Branch: Enter a specific branch that can be used for integration
Click Create button after entering all the required details, to finalize the Git configuration.
After successful configuration a toast message confirming Git integration is active and ready for use.
Git Commit/Push
To commit and push action in Git, directly login to Avo Assure application. After successful login Avo Assure landing page appears on the screen.
1. Select the project from All Projects section for commit or push action.
Click Design Studio button to access the created Mindmap for the project. Click Git icon from the top menu to get a Git Configuration window with the auto-filled data of the selected project.
2. Verify or reset the prefilled data and then navigate back to the Mindmap
3. Select Commit option from the dropdown present in the top menu
This will prompt to a new window. Enter the version name in the Enter Version Name text box. Provide a meaningful version name that reflects the made changes.
4. Select the module that needs to be commit from the list of available modules.
Note: Multiple modules can be chosen if more than one modules are required to commit.
Once selected, click > arrow icon to proceed to the next step
Enter comment regarding the commit in the Enter Your Comment text box This message should provide a summary of the changes or the purpose of the commit.
Click Commit & Push button to execute the commit and push action
A toast message ‘Test Suite(s) pushed to Git’ will confirm that the changes have been successfully pushed to Git.
5. Verify the Commit/Push
Note: After completing the process, it’s advisable to log into your Git repository to verify the commit.
Login to Git repository then navigate to the project to verify that the changes are in the commit history.
Git Restore
Gits restore feature within Avo Assure enables retrieving and reinstating a project configuration from a Git repository. This feature ensures that users can access prior project states.
1. Select Project
Select the Project form All Projects section available on the left side of the landing Page -> Click Design Studio -> Click Select dropdown and select Version History
2. Select the Destination Project
In case if the destination project is an empty project: Select the project from the Select Destination dropdown menu where the Git configuration should be restored.
Steps to Create Project
Enter project name -> Select Web from the Application Type dropdown -> select User -> click > arrow icon -> click Create button
After Creating new Project, Git Configuration window appear
3. Git Configuration
Git configuration helps restore the data that needs to be configure with Avo Assure and Git.
The necessary configuration fields that need to be filled to Restore the project:
Git Configuration: A descriptive name for the configuration
Git Access Token: Token used for authentication with Git account
Git URL: URL where Git repository is hosted
Git Username: Git username associated with the account
Git User Email: Git user email associated with the account
Git Branch: The specific branch use for integration
4. Click Restore
Click Restore button in the confirmation prompt to finalize the restoring.
After confirming the restoration, a toast message appears stating “Git configuration has been restored successfully”. This message confirms that the integration is now active and ready for use and all the restored data can be seen in project.
Select project from the Avo Assure to identify the project that contains the Git configuration that needs to be edited and perform the following steps to edit a Git configuration setting:
1. Select Project -> Click Setting button -> Click Manage Integrations button to navigate to Manage Integration window
2. Select Versioning Tab and select Git from the left-hand side dropdown as your integration option and click Edit button to update those fields that needs to be changed. 3. Edit the fields that needs to be updated and hit the Update button
Delete Git Configuration in Avo Assure
Steps to remove the associated configurations and clear access to the Git repository are:
1. Select project of Git configuration that needs to be deleted:
After select Project -> Click Setting button -> Click Manage Integrations button to navigate to Manage Integration window
2. Select Git from the left-hand side dropdown as your integration option this indicates setting up integration specifically with Git.
And click Edit button
3. Click Delete button
After clicking edit button, this will open the Edit Git window on the screen. Select user from ‘Select User’ dropdown then select project from ‘Select project’ dropdown menu and lastly, click Delete button.
4. Click Yes to Confirm
Click Yes button from the confirmation window. This will remove the Git configuration from Avo Assure.
After confirming the deletion, a toast message confirms that the Git configuration has been deleted successfully from the project.
Last updated
