Skip to main content
Version: 2.0 🆕

GitOps Configuration

caution

The 'GitOps Configuration' page appears only if the super-admin has enabled 'Allow changing git repository for application' in Application Management → Configurations → GitOps.

Introduction​

This configuration is an extension of the GitOps settings present in Application Management → Configurations of Devtron. Therefore, make sure you read it before making any changes to your app configuration.

The application-level GitOps configuration offers the flexibility to add a custom Git repo (as opposed to Devtron auto-creating a repo for your application).

Adding Custom Git Repo for GitOps​

Who Can Perform This Action?

Users need to have Admin permission or above (along with access to the environment and application) to configure user-defined Git repo.

For Devtron Apps​

  1. Go to Application Management Applications → Devtron Apps (tab) → (choose your app) → Configurations (tab) → GitOps Configuration.

    Figure 1: App-level GitOps Config

  2. Assuming a GitOps repo was not added to your application earlier, you get 2 options:

    • Auto-create repository - Select this option if you wish to proceed with the default behavior. It will create a repository automatically, named after your application with a prefix. Thus saving you the trouble of creating one manually.

    • Commit manifests to a desired repository - Select this option if you wish to add a custom repo that is already created with your Git provider. Enter its link in the Git Repo URL field.

    Figure 2: Repo Creation

caution

GitOps repositories, whether auto-created by Devtron or added manually, are immutable. This means they cannot be modified after creation. The same is true if you have an existing CD pipeline that uses/used GitOps for deployment.

  1. Click Save.

    Figure 3: Saved GitOps Config

Note: In case you skipped the GitOps configuration for your application and proceeded towards the creation of a new CD pipeline (that uses GitOps), you will be prompted to configure GitOps as shown below:

Figure 4: Incomplete GitOps Config

For Helm Apps​

You can deploy a helm chart using either Helm or GitOps. Let's assume you wish to deploy airflow chart.

  1. Select the helm chart from the Chart Store.

    Figure 5: Choosing a Helm Chart

  2. Click Configure & Deploy.

    Figure 6: Configure & Deploy Button

  3. After you enter the App Name, Project, and Environment; an option to choose the deployment approach (i.e., Helm or GitOps) would appear. Select GitOps.

info

The option to choose between 'Helm' or 'GitOps' is only available in

Figure 7a: Deployment Approach

Figure 7b: Selecting GitOps Method

  1. A modal window will appear for you to enter a Git repository. Just like Devtron Apps (step 2), you get two options:

    • Auto-create repository
    • Commit manifests to a desired repository

    Figure 8: Adding a Repo

  2. Enter your custom Git Repo URL, and click Save.

    Figure 9: Saved GitOps Config for Helm App

Next, you may proceed to deploy the chart.

caution

Once you deploy a helm app with GitOps, you cannot change its GitOps repo.