As an administrator, you can configure a connection between your vRealize Orchestrator deployment and a Git repository or project.

To use Git for management of your vRealize Orchestrator object inventory, you must configure a connection to your Git repository by using the vRealize Orchestrator Client.

Note: You cannot add multiple Git repositories from different accounts over SSH because vRealize Orchestrator creates one SSH key for each instance. To add multiple Git repositories, you can add them over HTTP as described in this documentation.

Prerequisites

  • Verify that your vRealize Orchestrator environment uses a vRealize Automation license.
  • Generate an access token for your GitLab project and copy it to your clipboard for use during the configuration process. See Creating a personal access token.
    Note: For this use case, you are using a GitLab project. If you are more familiar with GitHub, you can use a GitHub repository. For information generating a GitHub token, see Creating a personal access token for the command line.

Procedure

  1. Log in to the vRealize Orchestrator Client as an administrator.
  2. Navigate to Administration > Git Repositories.
  3. Click Add Repository.
  4. Enter the URL address of your Git repository.
    For example, https://gitlab.com/ myusername/ my-vro-repo.
    Note: You can also establish a connection with the SSH protocol.
  5. Enter the user name for your Git profile.
  6. Enter the access token of your Git repository.
  7. To validate the connection to the Git repository, click Validate.
  8. (Optional) Change the name used to identify the repository in the vRealize Orchestrator Client.
  9. (Optional) Add a short description for the connected Git repository.
  10. To activate the connected Git repository, click Make active repository.
    Note: Only one Git repository can be active at a time. You can change the active Git repository from the Git Repositories page.
  11. Select the branch to which you want to push your changes. For this use case, you are using Python-branch. See Prepare Your GitLab Environment.
    Note: You can change the selected Git branch at any time after you finish the initial Git configuration.
  12. To finish the configuration process, click Save.

What to do next

Navigate back to the Git Repositories menu and confirm that the status of the repository is Active.