Skip to content

Latest commit

 

History

History
263 lines (189 loc) · 11.5 KB

README.md

File metadata and controls

263 lines (189 loc) · 11.5 KB

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

Join Discord Go Report Card License CII Best Practices made-with-Go Website devtron.ai Tweet

📖 Menu

💡 Devtron?

Why use it?

We have seen various tools that are used to greatly increase the ease of using Kubernetes. However, using these tools simultaneously is painful, and hard to use. This is due to the fact these tools don't talk to each other for managing different aspects of application lifecycle; including CI, CD, security, cost, observability, stabilization.

Thus, we built Devtron to solve this problem!

Devtron is an open source modular product providing 'seamless', 'implementation agnostic uniform interface', integrated with open source, and commercial tools across the entire life cycle. This is all achieved while focusing on a slick User Experience, including a 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 our 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 the username:admin. And for the password, run the following command:

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

📹 Videos:

📝 Compatibility notes

Current build:

  • Devtron 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.

Join Our Discord Community

Join Devtron : Heroku for Kubernetes

💖 Love What You See!

If you are loving what we are doing, please consider giving us a star.
GitHub stars
Or you can tweet about us:
Tweet
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/s, 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'll need to first check which jobs 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 the names of the jobs with 0/1 completions and check if their pods are in running state 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. This may be due to internet issue. If the job is not in running condition, 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 jobs and all pods are in running mode?
A. 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. If not, run the following command:
kubectl apply -f https://raw.githubusercontent.com/devtron-labs/devtron/main/manifests/yamls/nats-server.yaml -n devtroncd
  • Wait util all nats pods are created, and the pods are in running condition. Once complete, delete devtron and dashboard pods. 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:

🤝 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.

Also please checkout our community contributions and feel free to create a video or blog around Devtron and add your valuable contribution in the list.

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 this to us at [email protected].

🔖 License

Devtron is available under the Apache License, Version 2.0.