GitHub Integration Setup
This guide explains how to configure GitHub integration in Dr Migrate to enable the Application Assessment feature with GitHub Copilot.
Before you begin: This configuration is required before you can use the "Assess with copilot" option in Application Assessment.
Prerequisites¶
System Requirements¶
| Requirement | Details |
|---|---|
| GitHub Account | A GitHub account with access to the repository where you want to create issues |
| GitHub Repository | A repository where application assessment issues will be created |
| Admin Access | Administrator access to Dr Migrate to configure the integration |
Required Permissions¶
| Permission | Scope |
|---|---|
| Repository Write Access | Ability to create issues in the target GitHub repository |
| OAuth App Creation | Permission to create OAuth apps in your GitHub account or organization |
Configure GitHub OAuth App¶
Before you can use the GitHub integration, you need to create a GitHub OAuth App and configure it in Dr Migrate.
Navigate to GitHub Settings¶
Go to your GitHub account and click your profile picture → Settings. In the left sidebar, click Developer settings.
For organization accounts, navigate to Settings → Developer settings → OAuth Apps.
Create OAuth App¶
Click OAuth Apps → New OAuth App.
Configure Application Settings¶
Fill in the following details:
- Application name: DrMigrate Integration (or your preferred name)
- Homepage URL: Your Dr Migrate application URL (e.g.,
https://yourdomain.com) - Authorization callback URL:
https://yourdomain.com/auth/github/callback - Application description: (Optional) Integration for migration management
Generate Client Secret¶
After creating the app, click Generate a new client secret.
Copy the secret immediately. It will only be shown once.
Copy Credentials¶
Copy both the Client ID and Client Secret from the GitHub OAuth App page.
Configure GitHub Integration in Dr Migrate¶
Navigate to Admin → GitHub Integration in Dr Migrate and enter the Client ID and Client Secret you copied from GitHub.
Your Client Secret will be securely stored in Azure Key Vault. Never share or commit these credentials to source control.
For detailed instructions, refer to the GitHub documentation on creating OAuth apps.
Verification¶
After configuring the GitHub integration:
- Navigate to an application with Java or .NET detected technology
- Go to the 6R Treatments menu
- Verify that the "Assess with copilot" option is available
If the option is not available or you encounter errors when creating issues, verify that:
- The OAuth app credentials are correctly entered in Admin → GitHub Integration
- The callback URL matches your Dr Migrate application URL
- Your GitHub account has write access to the target repository
Next Steps¶
Once GitHub integration is configured, you can use the Application Assessment feature. See Application Assessment with GitHub Integration for instructions on using the feature.