Home

Awesome

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./assets/devtron-darkmode-logo.png"> <source media="(prefers-color-scheme: light)" srcset="./assets/devtron-lightmode-logo.png"> <img width="333.333" height="260" src="./assets/devtron-logo-dark-light.png"> </picture> <h1 align= "center">Cloud Native tool integration platform for Kubernetes</h1> </p> <p align="center"> <br> <a href="https://docs.devtron.ai/" rel="nofollow"><strong>Explore documentation »</strong></a> <br> <a href="https://preview.devtron.ai/dashboard/" rel="nofollow"><strong>Try Devtron Demo »</strong></a> <br> <a href="https://devtron.ai/">Website</a> · <a href="https://devtron.ai/blog/">Blogs</a> · <a href="https://discord.gg/jsRG5qx2gp">Join Discord channel</a> · <a href="https://twitter.com/DevtronL">Twitter</a> . <a href="https://www.youtube.com/channel/UCAHRp9qp0z1y9MMtQlcFtcw">YouTube</a> </p> <p align="center"> <a href="https://discord.gg/jsRG5qx2gp"><img src="https://img.shields.io/badge/Join%20us%20on-Discord-e01563.svg" alt="Join Discord"></a> <a href="https://goreportcard.com/badge/github.com/devtron-labs/devtron"><img src="https://goreportcard.com/badge/github.com/devtron-labs/devtron" alt="Go Report Card"></a> <a href="./LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"></a> <a href="https://bestpractices.coreinfrastructure.org/projects/4411"><img src="https://bestpractices.coreinfrastructure.org/projects/4411/badge" alt="CII Best Practices"></a> <a href="http://golang.org"><img src="https://img.shields.io/badge/Made%20with-Go-1f425f.svg" alt="made-with-Go"></a> <a href="http://devtron.ai/"><img src="https://img.shields.io/website-up-down-green-red/http/shields.io.svg" alt="Website devtron.ai"></a> <a href="https://twitter.com/intent/tweet?text=Devtron%20helps%20in%20simplifying%20software delivery%20workflow%20for%20Kubernetes,%20check%20it%20out!!%20&hashtags=OpenSource,Kubernetes,DevOps,CICD,go&url=https://github.com/devtron-labs/devtron%0a"><img src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social" alt="Tweet"></a> <p align="center"> <a href="https://devtron.ai/devops-in-a-box.html">🔥 Want to accelerate K8s adoption? Introducing DevOps in a Box; Leave DevOps on Devtron 🔥 </a> <br> </p> <h1></h1>

Devtron deeply integrates with products across the lifecycle of microservices,i.e., CI, CD, security, cost, debugging, and observability via an intuitive web interface. <br>

<p align="center"><img src="./assets/readme-comic.png"></p>

Devtron helps you deploy, observe, manage & debug existing Helm apps in all your clusters.

Devtron Demo Environment

Please log in the <a href="https://preview.devtron.ai/dashboard/" rel="nofollow">Demo environment</a> using github credentials. Please note the user is granted view access.

Devtron Features

<details><summary><b>Application-level Resource grouping for easier Debugging</b></summary> <br> </details> <details><summary> <b>Centralized Access Management</b></summary> <br> </details> <details><summary> <b>Deploy, Manage and Observe on multiple clusters</b></summary> <br> </details> <br>

Integrations

Devtron is designed to be modular, and its functionality can be easily extended with the help of integrations.

CI/CD Integration

Devtron CI/CD with GitOps integration is used to automate the builds and deployments and enables the software development teams to focus on meeting the business requirements, code quality, and security.

Architecture

<p align="center"><img src="./assets/Architecture.jpg"></p>

Installation

Before you begin, you must create a Kubernetes cluster (preferably K8s 1.16 or higher) and install Helm.

1. Install Devtron with CI/CD Integration

Run the following command to install the latest version of Devtron along with the CI/CD module:

helm repo add devtron https://helm.devtron.ai

helm install devtron devtron/devtron-operator \
--create-namespace --namespace devtroncd \
--set installer.modules={cicd}

Access Devtron

URL: Use the following command to get the dashboard URL:

kubectl get svc -n devtroncd devtron-service -o jsonpath='{.status.loadBalancer.ingress}'

Credentials:

UserName: admin <br> Password: Run the following command to get the admin password for Devtron version v0.6.0 and higher

kubectl -n devtroncd get secret devtron-secret -o jsonpath='{.data.ADMIN_PASSWORD}' | base64 -d

For Devtron version less than v0.6.0, run the following command to get the admin password:

kubectl -n devtroncd get secret devtron-secret -o jsonpath='{.data.ACD_PASSWORD}' | base64 -d

Please refer to the document for more information on how to access the Devtron Dashboard.

Installation Status

The above install command for CI/CD integration starts Devtron-operator, which takes about 20 minutes to spin up all of the Devtron microservices one by one. You can check the status of the installation with the following command:

kubectl -n devtroncd get installers installer-devtron \
-o jsonpath='{.status.sync.status}'

The command executes with one of the following output messages, indicating the status of the installation:

2. Install Devtron with Helm Bundle

helm repo add devtron https://helm.devtron.ai

helm install devtron devtron/devtron-operator --create-namespace --namespace devtroncd

Install Multi-Architecture Nodes (ARM and AMD)

To install Devtron on clusters with the multi-architecture nodes (ARM and AMD), append the Devtron installation command with --set installer.arch=multi-arch

:blue_heart: Technology

Devtron is built on some of the most trusted and loved technologies: <br>

<p align="center"><img width="70%" height="70%" src="./assets/we-support.jpg"></p>

:video_camera: Videos

:memo: Blogs from Community

:muscle: Trusted By

Devtron is trusted by communities all across the globe. The list of organizations using Devtron can be found here.

:question: FAQs & Troubleshooting

:page_facing_up: Compatibility

Current build

Support, Contribution, and Community

:busts_in_silhouette: Community

Get updates on Devtron's development and chat with project maintainers, contributors, and community members

Join us at Discord channel

<p> <a href="https://discord.gg/jsRG5qx2gp"> <img src="https://invidget.switchblade.xyz/jsRG5qx2gp" alt="Join Devtron : Heroku for Kubernetes" > </a> </p>

:handshake: Contribute

Check out our contributing guidelines. Included, are directions for opening issues, coding standards, and notes on our development processes. We deeply appreciate your contribution.

Please look at our community contributions and feel free to create a video or blog around Devtron and add your valuable contribution to the list.

Contributors:

We are deeply grateful to all our amazing contributors!

<a href="https://github.com/devtron-labs/devtron/graphs/contributors"> <img src="https://contrib.rocks/image?repo=devtron-labs/devtron" /> </a>

:bug: Vulnerability Reporting

We at Devtron, take security and our users' trust very seriously. If you believe you have found a security issue, please report it to <b>security@devtron.ai</b>.

:bookmark: License

Devtron is licensed under Apache License, Version 2.0