Setting up Git repositories

To enable version management of component templates and Network Shell scripts, you can set up an integration between TrueSight Server Automation and Git repository tools (including GitHub, Gitblit, and GitLab). For the Git integration you must set up a local repository in the TrueSight Server Automation environment, as well as the remote Git repository. Changes that you introduce into TrueSight Server Automation objects are first committed into the local repository, and later pushed to the remote Git repository.

The local repository has the following requirements:

• Must reside on a computer that hosts an RSCD agent, preferably on the file server.
• Not located behind a SOCKS proxy server.
• (For Windows only) Git Bash version 1.8 or above installed. (You can download the Git Bash for Windows here.)
  If installing Git Bash version 2.7.4 or later on Windows, do not enable the Git Credential Manager.
• Minimum disk space: 2 GB
• Minimum memory: 1 GB of RAM

To configure Git repositories

1. Select Configuration > Infrastructure Management.
2. In the Infrastructure Management window, right-click Git Repository and select Git Repository Configuration.

3. In the Git Repository Setup dialog box, on the Local Repo Details tab, enter the following information about the local repository:

   Setting	Description
   Repository Server	The name or IP address of the computer that hosts the local repository, a clone of the remote Git repository.
   Repository Path	The path to the local repository, in NSH format. For example: /C/git_local_repo Note: If you use this field to set a new location for a local repository that you have already configured, note the following points: You cannot revert to an existing, non-empty path. If you want to reuse a path, first delete the old directory of the path, if it still exists. A new Validate tab appears, prompting you to commit any uncommitted changes and to push committed changes to the remote Git repository. See step 5.
   Git Installation Location	For Windows only: The path to the folder that contains the Git bash, typically C:\Program Files\Git\bin.
   Email Domain	The email domain to use to generate email IDs of logged-on users. In the case of users that are logged on with an authentication profile that is based on an authentication method of AD/Kerberos or Domain Authentication, if the user name includes the at sign (@), the email domain that you define through this setting overrides the domain specified after the @ sign in the user's name. For example, if the user name is john@myDomain.com and the email domain that you specify here is yourDomain.com, then the email address that will be used as an identifier for Git commits is john@yourDomain.com.

4. On the Remote Repo Details tab, enter the following information about the remote Git repository:

   1. In the Repository URL field, specify the URL for the Git repository, as obtained from your Git repository tool.
      This URL is used to perform an initial cloning of the remote Git repository and to initiate it for use by the local repository.
      The exact format of the URL depends on the Git repository tool. For example:

      • GitBlit: https://server:port/r/repoName.git
      • GitHub: https://github.domain/user/repoName.git
      • GitLab: https://server/root/repoName.Git
        

      Note

      You can use this field to switch to a new remote Git repository. In such a case, before setting a new repository URL, manually clone the Git repository to the new location. By doing so, you ensure that existing data (already stored in the repository) is not lost.

   2. Specify an automation principal that has the proper credentials for access to the Git repository. You can choose between the following options:

      Option	Additional information to enter
      Select an existing automation principal	Name of the existing automation principal Note: Ensure that the automation principal that you specify is not configured to use a private key for authentication.
      Create a new automation principal	Automation principal credentials — user name, password, and domain

   3. If the Git repository is hosted with a self-signed SSL certificate, clear the SSL Verify check box, so that the SSL handshake does not fail.
5. If you changed the name or location of an existing local repository (through the Repository Server or Repository Path fields in step 3), you must commit uncommitted changes and push changes to the remote Git repository before all data from the existing local repository is migrated to the new local repository. The Validate tab lists the changes that need to be committed and pushed.
   On this tab, enter a commit message in the Commit Message field and then click Commit and Push ALL.
6. Click Save.
   Git repository details appear in the Infrastructure Management window on the right when the Git Repository branch is selected on the left.