Git Providers
How to Set Up Git Provider Integration
This guide explains how to integrate your DevPortal with a Git provider (such as GitHub, GitLab, or Azure DevOps) to facilitate catalog import and project generation.
Steps
Step 1: Access Git Provider Settings
- Open Admin UI: Access the Admin UI of your DevPortal.
- Navigate to Git Providers:
- Click on "Go to settings" in the menu.
- Select “Git Providers” from the sidebar menu.
Step 2: Fill in Git Provider Information
- Enter the Required Data:
- Complete the fields based on your chosen Git provider (GitHub, GitLab, Azure DevOps). Below is a table with a description of each field:
| Field | Description |
|---|---|
| Host | The host location. Default is github.com. |
| Token | Authentication token for API and operations (anonymous access if not provided). |
| Organization | The name of your organization on GitHub. |
| Catalog Path | Path to the catalog-info.yaml file. |
| Branch | The branch you wish to use. |
| Repository | The repository you want to integrate with. |
| Frequency | Time (in minutes) for catalog update intervals. |
| Timeout | Time (in minutes) to automatically terminate after update requests. |
| Client ID | Your Client ID from the GitHub account. |
| Client Secret | Your Client Secret from the GitHub account. |
warning
For the full integration and operation of the DevPortal with GitHub, you should create and configure your authentication application(GitHub Oauth) and add the host that has been provided to you in the EC2 console. To configure your GitHub Oauth integration, please follow this step-by-step guide
Step 3: Preview the Configuration
- After filling in the required fields, click on "Preview" in the left-hand menu to review the information.
Step 4: Apply and Redeploy
- On the Preview page, verify the information, then click on "Apply and Re-deploy" to apply the new Git provider settings and redeploy the application.
Additional Important Information
- For complete integration with GitHub, you will need to create and configure a GitHub OAuth application.
- Add the host provided in the EC2 console when setting up the GitHub OAuth.
- Follow the detailed GitHub OAuth configuration guide to complete the setup process.