Configuring BMC Atrium Orchestrator Development Studio to use GitHub

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

This topic includes the following information:

• • Before you begin
  • To create a local GitHub repository in BMC Atrium Orchestrator 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
  • Related topic

Before you begin

The GitHub client is not packaged with the BMC Atrium Orchestrator product. Before you can configure BMC Atrium Orchestrator 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 BMC Atrium Orchestrator Development Studio

1. In the project tree in the Project Navigator of the BMC Atrium Orchestrator 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.
   
   

   Warning

   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.

BMC Atrium Orchestrator 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