You can create an integration with GitHub Enterprise in vRealize Automation Cloud Cloud so that you can manage scripts, templates, and other items using GitHub Enterprise.

You can synch three types of content with a vRealize Automation Cloud Git Hub Enterprise integration: actions, cloud templates, and terraform. In addition, you can use a PEM file if you have a self-signed certificate.

Prerequisites

  • You must have access to a valid GitHub Enterprise deployment. This includes a personal authentication token.
  • You must have access to one or more appropriate vRealize Automation Cloud projects.
  • When you connect the cloud to your on-prem GitHub Enterprise a proxy is required so that the cloud can talk back to the enterprise. See Download and deploy a cloud extensibility proxy.

Procedure

  1. In Cloud Assembly, select Infrastructure > Connections > Integrations and click Add Integration.
  2. Select GitHub Enterprise.
  3. Type a Name and Description for the integration.
  4. Enter the appropriate GitHub Enterprise credentials.
    • Enter the Server URL for the GitHub Enterprise server.
    • Enter the Token for the GitHub Enterprise server.
    • Enter an appropriate Running Environment for the integration.
  5. Click Validate to check the server connection for the integration.
  6. If you need to add tags to support a tagging strategy, enter capability tags. See How do I use tags to manage Cloud Assembly resources and deployments and Creating a tagging strategy.

Results

The GitHub Enterprise integration is created.

What to do next

After you configure a basic integration, you can associate the integration with one or more vRealize Automation Cloud projects and then add one or more repositories for use with the integration. As noted previously, you can add three types of repositories: cloud templates, action-based scripts, and terraform configurations.

  1. In Cloud Assembly, select Infrastructure > Connections > Integrations and open the integration page for the GitHub Enterprise integration.
  2. Click the Projects tab on the integration page.
  3. Click Add Project to open a dialog that enables you to choose a vRA project and then select the desired project.
  4. Click the Add Repository button to add a storage repository.
    1. Select the Type of repository to add.
    2. Select the path to the Repository you are adding.
    3. Select the repository Branch you want to add.
    4. Select the repository Folder you want to add.
  5. After you add one or more repositories, click the SYNC button to sync the repository data.

GitHub Enterprise integration is configured with the specified repository configuration, and you can view and work with ABX actions and cloud templates contained in configured repositories. When you add a project to a GitHub Enterprise integration, a synch operation runs to pull the latest versions of ABX action scripts and cloud template files from the designated repository. The History tab on the GitHub Enterprise integration page shows records of all synch operations for the integration. By default, files are automatically synched every 15 minutes, but you can manually synch a file by selecting it and clicking SYNCH at any time.

You can work with ABX actions on the vRealize Automation Cloud Cloud Assembly Extensibility page, and you can work with cloud templates on the Design page. If you save a changed version of an ABX action on the Extensibility area of vRealize Automation Cloud Cloud Assembly, the new version of the script is created and written back to the repository.