Skip to main content

Configure Git Integrations

This guide will walk you through the first steps of onboarding to Harness IDP, including enabling the module, configuring Git connectors, populating your catalog, and importing Harness entities.

Prerequisites​

1. Enable the Harness IDP Module​

Ensure your team is ready for IDP 2.0 onboarding by reviewing the breaking changes list and understanding the key essentials of upgrading to IDP 2.0.

⚠️ Rollback is not straightforward, so it's critical to thoroughly understand the scope and impact of these changes.

Once you're confident about upgrading:

  • Submit a Support Ticket: Raise a ticket with Harness Support to enable the IDP_2_0 feature flag on your account.

  • Join an Upgrade Call (Early Access Customers): Our team will schedule a call with you to walk through the upgrade process and enable the feature flag.

  • Enable in a Test Environment First (Recommended): If you have a test or staging environment, enable IDP 2.0 there first. This allows your team to safely explore the new experience before enabling it in production.

2. Provision the IDP Admin Role​

  • Harness IDP must be provisioned for the given account.
  • Only users with the Harness Account Admin role or assigned IDP Admin role can configure IDP. Go to Assign Roles and Resource Groups to assign roles.

Get Started with Harness IDP​

You land on the IDP module by navigating from the sidebar after logging into your Harness account. We strongly recommend users to follow the onboarding guide by selecting Get Started, for a seamless onboarding resulting in a catalog with software components.

Now that you're on the onboarding wizard, let's get started with setting up Git connectors to onboard the software components.

Step 1: Setup Git Connectors​

The software components in IDP are defined using YAML files, which are typically stored in your Git repositories. Configuring a connector for these Git providers is essential to fetch and manage these YAML files.

The following Git providers are supported:

Note: Multiple Connectors with different hostnames can be used for a single Git Provider at once. While setting up the connector, both Account & Repo type URLs are supported. Connection through Harness platform and delegate is supported.

Step 2: Populate Your Catalog​

After setting up the connector, you'll be presented with two onboarding paths to populate your catalog with entities.

Step 3: Import Harness Entities​

Import existing Harness services into your IDP catalog to quickly populate it with your current infrastructure.

Import Harness Services​

This option imports all the services from your Harness account into IDP:

  • Imports all services from all projects in your account
  • Services are imported as Component entities in IDP
  • Metadata is derived from the service configuration in Harness
  • Entities are created with metadata including Name, Description, Owner, Type, and Lifecycle stage
  • Once imported, you can view and manage these entities in the IDP catalog

For Harness Code Repository:

  • Repo Path - Go to the Code Repository and under files select Clone and copy the repository path.

For Other Git Providers:

  • Connector - Select the connector of the Git provider you want to use.
  • Repo - Enter the full path to your repo. Example: https://github.com/user-name/onboarding-test.git
    • The provided repo URL should belong to the same organization/project for which the connector has been setup.
  • Path - Defaults to harness-services. Can be changed as well.

Step 4: Complete the Setup​

Once you've configured your Git connector and chosen your onboarding path, select Complete Setup to finish the initial configuration. Your catalog will now be populated with the entities you've imported or created.

Next Steps​

Now that you've completed the initial setup: