Configuring TrueSight Orchestration Development Studio to use Git

This topic explains how to configure the TrueSight Orchestration Development Studio application to manage the workflows in a grid using Git.

This topic includes the following information:

• • Before you begin
  • To create a local Git repository in TrueSight Orchestration Development Studio
  • To commit files to a local repository
  • To commit files and push them to a remote repository
  • To push files to a remote repository
  • To access the Git staging view
  • To add changes to the staging area
  • To commit changes
  • To push changes to the remote repository

Before you begin

The Git client is not packaged with the TrueSight Orchestration product. Before you can configure TrueSight Orchestration Development Studio to integrate with Git, you must install and configure a Git client and you must have created a Git repository on your Git server. 

To create a local Git repository in TrueSight Orchestration Development Studio

1. In the project tree in the Project Navigator of the TrueSight Orchestration Development Studio Designer view, right-click the name of the grid whose modules you want to manage in Git.
2. In the menu, select Team > Share Project.
3. In the Share Project dialog box, select Git and then click Next.
4. Click Use or create repository in parent folder of project.

5. Select the project <gridName> in the list, where gridName is your grid. 
   The path field next to Create Repository is pre-populated with the path to the workspace, as shown in the following example.
   

   Note

   The Git local repository must be created in the DevStudio workspace. 

6. Click Create Repository.
7. Under Project, select the checkbox next to the local Git repository that you just created.
8. Click Finish.

TrueSight Orchestration Development Studio is now configured to work with Git and Git is set up for the local repository. 

To commit files to a local repository

To commit files you must be connected to your local Git repository.

1. In Project Navigator, right-click on <gridName> in the list, where gridName is your grid. 
2. Select Team.
3. In the window, complete the following steps:
   1. Select Commit.
   2. Enter a Commit Message.
   3. Select the files to commit.
   4. Click Commit at the bottom of the window.

To commit files and push them to a remote repository

1. In Project Navigator, right-click on <gridName> in the list, where gridName is your grid. 
2. Select Team.
3. In the window, complete the following steps:
   1. Select Commit.
   2. Enter a Commit Message.
   3. Select the files to commit.
   4. Click Commit and Push at the bottom the panel.
   5. In the Push to Another Repository panel, enter the following remote Git details:
      • URI: Enter the URI for the remote repository. 
      • Host: Enter the host name for the remote repository.
      • Repository Path: Enter the complete path to the remote repository
      • Protocol: Enter the protocol used for the remote repository.
      • Port: Enter the port number.
      • Authentication: Provide the user name and password to log into the remote repository.
      • Store in Secure Store: This feature is currently not supported. 
   6. Click Next.
   7. Add the push reference specifications in the next panel. Refer to the EGit/User Guide for details.
   8. Click Finish.

To push files to a remote repository

1. In Project Navigator, right-click on <gridName> in the list, where gridName is your grid. 
2. Select Team.
3. In the window, complete the following steps:
   1. Select Remote.
   2. Select Push.
   3. In the Push to Another Repository panel, enter the following remote Git details:
      • URI: Enter the URI for the remote repository. 
      • Host: Enter the host name for the remote repository.
      • Repository Path: Enter the complete path to the remote repository
      • Protocol: Enter the protocol used for the remote repository.
      • Port: Enter the port number.
      • Authentication: Provide the user name and password to log into the remote repository.
      • Store in Secure Store: This feature is currently not supported. 
   4. Click Next.
   5. Add the push reference specifications in the next panel. Refer to the EGit/User Guide for details.
   6. Click Finish.

To access the Git staging view

1. Open DevStudio and make sure your workspace is open.
2. In the Search box, click the search icon.
3. Perform a search for Git staging, and select Git Staging from the search results.

To add changes to the staging area

1. In the Git Staging view, locate the unstaged and staged changes areas.
2. Drag files from unstaged changes to staged changes.
3. Alternatively, right-click on files in the unstaged changes area and select Add to Index to stage them.

To commit changes

1. In the Git Staging view, enter a commit message in the commit message text box.
2. Click Commit to commit changes to your local repository. 

To push changes to the remote repository

1. Click the drop-down next to Commit and select Commit and Push.
2.  Alternatively, once the commit action is completed and you need to push to the origin, click Push to Head.