devtron

README

Heroku-like Platform for Kubernetes.

Devtron leverages popular Open-Source tools to provide a No-Code SaaS like experience for Kubernetes.
Explore documentation »
Website · Blog · Join Discord · Twitter

📖 Menu

• Devtron?
• Features
• Getting Started
• Documentation
• Videos
• Compatibility Notes
• Community
• Love what you see!
• FAQ & Troubleshooting
• Contribute

💡 Devtron?

Why use it?

We have seen various tools that are used to greatly increase the ease of using Kubernetes but using these tools simultaneously is painful and hard to use. As these tools dont talk to eachother for managing different aspects of application lifecycle - CI, CD, security, cost, observability, stabilization. We built Devtron to solve this problem precisely.

Devtron is an OpenSource modular product providing 'seamless', 'implementation agnostic uniform interface' integrated with OpenSource and commercial tools across life cycle. All done focusing on a slick User Experience enabling self-serve model.
You can efficiently handle Security, Stability, Cost and more in a unified experience.

🎉 Features

No code self-serve DevOps platform

• Workflow which understands the domain of Kubernetes, testing, CD, SecOps
• Reusable and composable pipelines so that workflows are easy to construct and visualize

Multi-cloud/Multi-cluster deployment

Built-in SecOps tools and integration

• UI driven hierarchical security policy (global, cluster, environment and application) for efficient policy management
• Integration with Clair for vulnerability scanning

UI-enabled Application debugging dashboard

• Application centric view for K8s components
• Built-in monitoring for cpu, ram, http status code and latency
• Advanced logging with grep and json search
• Access all manifests securely for e.g. secret obfuscation
• Auto issue identification

Enterprise grade security and compliances

Automated Gitops based deployment using argocd

• Automated git repository and application manifest management
• Reduces complexity(configuration, access control) in adopting gitops practices
• Gitops backed by Postgres for easier analysis

🌐 Architecture:

💙 We Support:

In addition to the features, we love supporting platforms that devs find easy to work with.

🚀 Getting Started

You can follow through a detailed installation guide, using Devtron and other key functionalities of devtron in our

Devtron Documentation

Quick installation with default settings

This installation will use Minio for storing build logs and cache.

helm repo add devtron https://helm.devtron.ai
helm install devtron devtron/devtron-operator --create-namespace --namespace devtroncd

For detailed installation instructions and other options, check out:

devtron installation documentation

🔑 Access Devtron dashboard

By default Devtron creates a loadbalancer. Use the following command to get the dashboard url.

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

Devtron Admin credentials

For admin login use username:admin and for password run the following command.

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

📹 Videos:

• Devtron - A Comprehensive Overview
• Viktor Farcic(YouTuber) Review
• Running an application on Devtron
• Devtron Demo

📝 Compatibility notes

Current build:

• It uses modified version of argo rollout
• Application metrics only works for k8s 1.16+

👥 Community

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

• Follow @DevtronL on Twitter
• Raise feature requests, suggest enhancements, report bugs at GitHub issues
• Read the Devtron blog

Join Our Discord Community

💖 Love What You See!

If you are loving what we are doing, Please consider giving us a star.

Or you can tweet about us:

Your token of gratitude will go a long way helping us reach more developers like you. ❤:)

Or you can do one better and Contribute 👏

❓ FAQ & Troubleshooting:

FAQ:

1.How to resolve unauthorized error while trying to save global configurations like hostname, gitops etc. after successful devtron installation
A. This occurs most of the time because any one or multiple jobs get failed during installation. To resolve this, you need to first check which are the jobs that have failed. Follow these steps :-

• Run the following command and check which are the jobs with 0/1 completions:

kubectl get jobs -n devtroncd

• Note down or remember the names of jobs with 0/1 completions and check if their pods are in running state still or not by running the command: kubectl get pods -n devtroncd
• If they are in running condition, please wait for the jobs to be completed as it may be due to internet issue and if not in running condition, then delete those incomplete jobs using: kubectl delete jobs -n devtroncd..Read More
  
  

2.What to do if devtron dashboard is not accessible on browser even after successful completion of all the jobs and all pods are in running mode
A. For this, you need to check if nats-cluster is created or not, you can check it using the following command:

kubectl get natscluster -n devtroncd

• You should see a natscluster with the name devtron-nats and if not, run the given command:

kubectl apply -f https://raw.githubusercontent.com/devtron-labs/devtron/main/manifests/yamls/nats-server.yaml -n devtroncd

• Wait till all the nats pods are created and the pods are in running condition. After that delete devtron and dashboard pods once and then you should be able to access the devtron dashboard without any issues.
• If your problem is still not resolved, you can post your query in our discord channel

Troubleshooting:

• For Installation Troubleshooting, check this Documentation
• For other troubleshooting, Check the Common troubleshooting documentation

🤝 Contribute

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

Our Contributors:

We are deeply grateful for all our amazing contributors!

🐛 Vulnerability Reporting

We at Devtron take security and our users' trust very seriously. If you believe you have found a security issue in Devtron, please responsibly disclose us at security@devtron.ai.

🔖 License

Devtron is available under the Apache License, Version 2.0