GitHub Integration¶

Overview¶

HPE Morpheus Software provides dedicated GitHub integration that extends the base Git capabilities with GitHub-specific features including organization browsing, repository discovery, and GitHub API integration for enhanced code management workflows.

GitHub integrations allow HPE Morpheus Software to:

• Browse GitHub organizations and their repositories

• Pull Task scripts, templates, and configurations from GitHub repos

• Leverage GitHub authentication (personal access tokens, OAuth)

• Discover and sync repository contents with branch/tag support

Adding a GitHub Integration¶

To add a GitHub integration:

1. Navigate to Provisioning > Code > Integrations (Provisioning > Code > Integrations)

2. Click + ADD

3. Select GitHub as the integration type

4. Complete the configuration:

   • NAME: Descriptive name for the integration

   • ENABLED: Toggle to enable/disable

   • GITHUB API URL: API endpoint URL

     • GitHub.com: https://api.github.com (default)

     • GitHub Enterprise: https://github.yourcompany.com/api/v3

   • ACCESS TOKEN: GitHub Personal Access Token with appropriate scopes

   • ORGANIZATION: (Optional) Default organization to browse

5. Click SAVE

GitHub Personal Access Token¶

A Personal Access Token (PAT) is required for authentication. Generate one in GitHub:

1. Navigate to GitHub Settings > Developer Settings > Personal Access Tokens

2. Click Generate new token

3. Required scopes:

   • repo — Full control of private repositories (or public_repo for public only)

   • read:org — Read organization membership (for org browsing)

4. Copy the generated token and paste it into the HPE Morpheus Software integration configuration

Browsing Organizations¶

With a GitHub integration configured:

1. Navigate to Provisioning > Code > Repositories (Provisioning > Code > Repositories)

2. The integration shows available organizations

3. Select an organization to list its repositories

4. Select a repository to browse its contents

Repository features:

• Browse file trees across branches and tags

• View file contents with syntax highlighting

• Switch between branches using the branch selector

• Search repositories by name

Using GitHub Repositories¶

GitHub repositories integrate with HPE Morpheus Software automation:

Tasks:

• Source scripts from GitHub repositories

• Specify repository, file path, and branch/tag

• Scripts are pulled fresh on each execution

Spec Templates:

• Store Terraform, Kubernetes, Helm, and other IaC templates in GitHub

• Reference specific files and branches

• Changes in GitHub are automatically reflected

Blueprints:

• Terraform blueprints can reference GitHub repos for .tf files

• Multiple environments via branch-based configuration

• Support for Terraform modules in subdirectories

Deployments:

• Application code from GitHub repos can be deployed to Instances

• Supports branch/tag selection for deployment versioning

GitHub Enterprise Support¶

HPE Morpheus Software supports GitHub Enterprise Server installations:

• Custom API URL pointing to your GHE instance

• Same authentication and browsing capabilities as GitHub.com

• SSL certificate verification (ensure GHE certificate is trusted by HPE Morpheus Software appliance)

To configure for GitHub Enterprise:

1. Set the GITHUB API URL to your GHE API endpoint (e.g., https://github.corp.com/api/v3)

2. Ensure network connectivity between HPE Morpheus Software and the GHE server

3. If using a self-signed certificate, add the CA certificate to the HPE Morpheus Software trust store

Webhook Integration¶

GitHub webhooks can be configured to notify HPE Morpheus Software of repository changes:

• Push events trigger repository synchronization

• Enables near-real-time updates for Task scripts and templates

• Webhook URL format: https://<morpheus-url>/api/code/webhooks/github

Differences from Generic Git¶

The GitHub-specific integration provides additional capabilities over the generic Git integration:

Removing a GitHub Integration¶

1. Navigate to Provisioning > Code > Integrations

2. Click the trash icon on the GitHub integration row

3. Confirm deletion