Configuring BMC Atrium Orchestrator Development Studio to use GitHub

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

This topic includes the following information:

Before you begin

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

To create a local GitHub repository in  Development Studio

1. In the project tree in the Project Navigator of the  Development Studio Designer view, right-click the name of the grid whose modules you want to manage in GitHub.

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 GitHub 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.

 Development Studio is now configured to work with GitHub and GitHub 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.

Related topic

Troubleshooting problems using GitHub with BMC Atrium Orchestrator Development Studio