Git Integration for Projects
  • 28 Mar 2024
  • Dark
    Light
  • PDF

Git Integration for Projects

  • Dark
    Light
  • PDF

Article summary

Projects within IAP can be connected to a Git Repository. The primary objective of this feature is to provide a version controlled space to manage, track and store file changes in a Project. Storing a file within Git enables a user to promote a Project between environments using their own pipelines.

See also User Settings for Projects.

Initialize a New Repository

From the Projects homepage, click New Project +.

Figure 1: Projects Homepage
01_Projects_Homepage_23_2

Hover over the Git icon in the top toolbar and select Initialize a New Repository from the dropdown menu.

Figure 2: Initialize a New Repository
02_Initialize_23_2

A dialog will open to input the following required information:

  • Remote connection (access tokens are found in the user settings)
  • Repository path
  • Branch name
  • Path to a project.json file.

Once the connection is located, or a path is entered, click Initialize and Push to establish the Git connection.

Figure 3: Initialize and Push
03_Initialize_Push_23_2

A success banner will appear (upper-right corner) to inform the user if the Project was successfully initialized.

Figure 4: Success Confirmation
04_Success_23_2

Connect to an Existing Repository

From the Projects homepage, open an existing Project by clicking the desired card.

From the top toolbar on the left, hover over the Git icon and click Connect to Existing Repository.

Figure 5: Connect to Existing Repository
05_Existing_Repository_23_2

A dialog will then display where users can select the Remote Connection that has already been saved, or manually enter the settings to make a new connection.

Once all modifications to the connection settings are finalized, click Connect to make the connection to the chosen repository.

Figure 6: Existing Repository Path Options
06_Existing Connection_23_2

A confirmation dialog then displays with the options to Pull Update, Push Changes, or Dismiss the modifications.

Figure 7: Pull Update or Push Changes
07_Push_Pull_23_2

Pull Update

From the Projects homepage, open a Project and then hover over the Git icon in the top toolbar.

Click Pull Update.

Figure 8: Pull Update
09_Pull_Update_23_2

A dialog will then display with a warning to confirm that pulling the latest update for the Project will overwrite all local changes. Click the Pull Update button to continue.

Figure 9: Confirm Pull Update
10_Pull_Confirm_23_2

Push Changes

From the Projects homepage, open a Project and then hover over the Git icon in the top toolbar.

Click Push Changes.

Figure 10: Push Changes
11_Push_Changes_23_2

A Generate Push for Project dialog will then open that shows the following information:

  • Locations where the changes are being pushed to (Branch and Project).
    • If a different branch is needed, click Change Target Branch to open the settings dialog. More information on changing the target branch (destination) is provided in the next section.
  • A text box to enter a Commit Message for the push.
  • A Project Version Change that shows the Current Version of the push and the new Publish to Version number.
  • A Publishing Version and Current Version table, respectively, that displays the version number, a commit message, author of the push, and the destination branch.

Figure 11: Version Table
12_Push_Table_23_2

Change Target Branch

When you click the Change Target Branch button to push a Project, you can select a new branch from the branches that are currently connected, or manually enter a path to the new branch.

After changing the destination branch, type a commit message to explain what change you made and click Push.

Figure 12: Change Target Branch
13_Change_Branch_23_2

Synchronizing a Branch

Sync icons will only be displayed if the local Project is out of sync with the Git repository. The sync icon is displayed next to the Branch name in the side panel, so the user is able to see the version of their local copy versus the version for the repository. Hovering over the icon will display the version information.

Figure 13: Sync Icon
14_Sync_23_2

If a user tries to push an update and the target branch is out of sync, a warning will display. If the user continues, the target branch will be overwritten with the update that is pushed.

Figure 14: Sync Warning
15_Sync_Warning_23_2

⚠ Warning:

Make sure you are in sync with the remote branch before you begin working. If another user updates the branch while you are working, your push will overwrite the work they have done. Pulling will overwite your local project and Pushing will overwrite the remote project.

Manage Branch

From the Projects homepage, open a Project and then hover over the Git icon in the top toolbar.

Click Manage Branch.

Figure 15: Manage Branch
16_Manage_Branch_23_2

From the dialog that opens, you can select to a branch from the dropdown, or manually enter a name to create a new branch.

Click Confirm to connect to the repository.

Figure 16: Manage Branch Confirm
17_Manage_Confirm_23_2

Project Version History

From the Projects homepage, open a Project and then hover over the Git icon in the top toolbar.

Click Project Version History.

Figure 17: Project Version History
18_Version_History_23_2

A dialog displays that shows the current branch being worked on as well as a table showing the history of version changes and the commit messages made to the Project.

Figure 18: Version History Table
19_Version_History_Table_23_2

Remove Git Configuration

From the Projects homepage, open a Project and then hover over the Git icon in the top toolbar.

Click Remove Git Configuration.

Figure 19: Remove Git Configuration
20_Remove_Git_Config_23_2

A warning dialog displys to alert the user that the Git configuration for the Project is about to be removed. If the configuration is removed, the project will need to be re-initialized for it to be shared on Git.

Click Continue to delete the Git connection.

Figure 20: Remove Git Configuration Confirmation
21_Remove_Git_Confirm_23_2

Clone Remote Project

Click Clone Remote Project from the Projects homepage. A dialog will open for you to input the following:

  • Remote connection
  • Repository path
  • Branch name
  • Path to a project.json file.

Click Clone Project. If the clone is successful, a success banner will display in the upper-right corner and the cloned project will now appear in the list of projects on the Project homepage.

Figure 21: Clone Project Connection
08_Clone_Connection_23_2


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.