Try Devtron Enterprise!
Start Free Trial
LogoLogo
WebsiteDevtron demoGithub RepoJoin Discord
v0.5
v0.5
  • Overview
  • Getting Started
    • Install Devtron
      • Install Devtron with CI/CD integration
      • Install Devtron
      • Install Devtron on Minikube, Microk8s, K3s, Kind
      • Installation Configurations
      • Override Configurations
      • Ingress setup for Devtron Installation
    • Global Configurations
      • GitOps
      • Projects
      • Cluster And Environments
        • Namespaces And Environments
      • Git Accounts
      • Container Registries
      • Chart Repositories
      • Custom charts
      • SSO Login Service
      • Authorization
        • User Permissions
        • Permission Groups
        • API Tokens
      • Manage Notification
      • External links
    • Devtron Upgrade
      • Update Devtron from Devtron UI
      • 0.4.x-0.5.x
      • 0.4.x-0.4.x
      • 0.3.x-0.4.x
      • 0.3.x-0.3.x
      • 0.2.x-0.3.x
  • Usage
    • Applications
      • Create a new application
      • Clone an existing application
      • Deploy a sample application
      • App Configuration
        • Git Repository
        • Docker Build Configuration
        • Deployment Template
          • Deployment
          • Rollout Deployment
          • Job and Cronjob
        • Workflow Overview
        • CI Pipeline
          • Pre-Build/Post-Build Tasks
        • CI Pipeline (Legacy)
        • CD Pipeline
        • Config Maps
        • Secrets
        • Environment Overrides
        • Deleting Application
      • Build and Deploy
        • Triggering CI
        • Triggering CD
      • App Details
        • Debugging Deployment And Monitoring
        • Application Metrics
    • Charts
      • Charts Overview
      • Deploy & Observe
      • Examples
        • Deploying Mysql Helm Chart
        • Deploying MongoDB Helm Chart
      • Chart Group
    • Security
    • Bulk Edit
    • Integrations
  • Resources
    • Troubleshooting
    • Use Cases
      • Devtron Generic Helm Chart To Run CronJob Or One Time Job
      • Connect SpringBoot with Mysql Database
      • Connect Expressjs With Mongodb Database
      • Connect Django With Mysql Database
    • Telemetry Overview
  • Deprecated
    • Hyperion
Powered by GitBook
On this page
  • Why Devtron takes GitOps Configuration?
  • Add Git Configuration
  • 1. Git Host:
  • 2. GitHub Organization Name / GitLab Group ID / Azure DevOps Project Name / BitBucket Workspace ID:
  • 3. BitBucket Project Key:
  • 4. Git access credential

Was this helpful?

Export as PDF
  1. Getting Started
  2. Global Configurations

GitOps

PreviousGlobal ConfigurationsNextProjects

Last updated 2 years ago

Was this helpful?

Why Devtron takes GitOps Configuration?

Devtron uses GitOps and stores configurations in git; Git Credentials can be entered at Global Configuration > GitOps which is used by Devtron for configuration management and storing desired state of the application configuration. In case GitOps is not configured, Devtron cannot deploy any application or charts.

Areas impacted by GitOps are:

  • Deployment Template, to learn more.

  • Charts, to learn more.

Add Git Configuration

Select the GitOps section of global configuration. At the top of the section, four Git providers are available.

  • GitHub

  • GitLab

  • Azure

  • BitBucket Cloud

Select one of the Git providers. To add git account, You need to provide the following inputs as given below:

  1. Git Host / Azure DevOps Organisation Url / BitBucket Host

  2. GitHub Organization Name / Gitlab Group id / Azure DevOps Project Name / BitBucket Workspace ID

  3. BitBucket Project Key (only for BitBucket Cloud)

  4. Git access credential

1. Git Host:

This field is filled by default, Showing the URL of the selected git providers. For example- https://github.com for GitHub, https://gitlab.com for GitLab, https://dev.azure.com/ for Azure & https://bitbucket.org for BitBucket. Please replace them(not available for GitHub & BitBucket) if they are not the url you want to use.

2. GitHub Organization Name / GitLab Group ID / Azure DevOps Project Name / BitBucket Workspace ID:

3. BitBucket Project Key:

4. Git access credential

Provide Git Username and Personal Access Token of your git account.

(a) Username Username for your git account.

(b) Personal Access Token A personal access token (PAT) is used as an alternate password to authenticate into your git accounts.

  • repo - Full control of private repositories(Access commit status , Access deployment status and Access public repositories).

  • admin:org - Full control of organizations and teams(Read and write access).

  • delete_repo - Grants delete repo access on private repositories.

  • api - Grants complete read/write access to the scoped project API.

  • write_repository - Allows read-write access (pull, push) to the repository.

  • repo - Full control of repositories (Read, Write, Admin, Delete access).

Click on Save to save your gitOps configuration details.

Note: A Green tick will appear on the active gitOps provider.

In the case of GitHub provide Github Organization Name*. Learn more about . In the case of Gitlab provide Gitlab group Id*. Learn more about . Similarly in the case of Azure provide Azure DevOps Project Name*. Learn more about . For Bitbucket Cloud, provide Bitbucket Workspace Id*. Learn more about .

This field is non-mandatory and is only to be filled when you have chosen Bitbucket Cloud as your git provider. If not provided, the oldest project in the workspace will be used. Learn more about .

For GitHub :

For GitLab :

For Azure DevOps :

code - Grants the ability to read source code and metadata about commits, change sets, branches, and other version control artifacts. .

For BitBucket Cloud

Github organization Name
Gitlab group Id
Azure DevOps Project Name
Bitbucket Workspace Id
Bitbucket Project Key
Creating a GitHub Personal Access Token
Creating a GitLab Personal Access Token
Creating a Azure DevOps Access Token
More Information on scopes in Azure devops
Creating a Bitbucket Cloud Personal Access Token (App passwords)
click here
click here