ADHAR - The Open Foundation

💡 Adhar aims to revolutionise the software development by providing a comprehensive and integrated IDP(Internal Developer Platform) that seamlessly integrates the leading open-source frameworks and libraries, embraces cutting-edge cloud-native practices, utilises containerization technology, leverages cloud infrastructure, strengthens identity and access management, ensures robust API governance, offers low-code application development capabilities, powers rapid application creation with Artificial Inteligence(AI), and oversees holistic application lifecycle management. ADHAR empowers developers and businesses with an all-encompassing ecosystem to innovate, collaborate, and deliver software solutions of unparalleled quality and efficiency.

Adhar Platform Goals 🎯

Comprehensive All-in-One Integrated Platform: The platform encompasses the entire software development lifecycle, from defining requirements and designing solutions to developing, testing, and deploying applications. This unified approach eliminates the need for switching between disparate tools, improving efficiency and collaboration.
Enhanced Developer and Operator Experience: The platform prioritizes developer and operator experience by providing intuitive interfaces, automated tasks, and streamlined workflows. This user-centric design reduces friction and empowers users to focus on their core responsibilities.
Clear Responsibility Segregation: The platform establishes clear boundaries between application teams and platform teams, promoting a well-defined division of labor. This separation of concerns ensures that each team focuses on their respective areas of expertise, enhancing overall efficiency.
Holistic Governance and Compliance: The platform incorporates robust governance and compliance mechanisms to ensure adherence to regulatory requirements and maintain data integrity. This built-in compliance framework minimizes risk and promotes transparency.
Platform-as-a-Product Approach: The platform adopts a product-centric approach, eliminating the need for each organization to reinvent the wheel. This shared infrastructure model reduces development costs and promotes standardization across the industry.
Polyglot Technology Stack: The platform embraces a polyglot approach, supporting a wide range of programming languages, frameworks, and cloud environments. This flexibility allows developers to choose the tools that best suit their needs, fostering innovation.
Continuous Evolution: The platform remains perpetually evolving, incorporating modern technology trends and industry best practices. This commitment to continuous improvement ensures that the platform remains relevant and cutting-edge.
Optimal Open Source Cloud-Native Integration: The platform involves seamlessly combining open-source tools and technologies to build, deploy, and manage cloud-native applications. This integration enables organizations to leverage the flexibility, scalability, and cost-effectiveness of cloud computing while maintaining control over their infrastructure and data.
GitOps for Infrastructure and Applications: The platform adheres to GitOps principles for managing both infrastructure and applications. This declarative approach ensures consistency, reproducibility, and simplified configuration management.
Self-Service Resource Provisioning: The platform empowers users to provision resources on-demand, eliminating the need for manual intervention. This self-service model enhances agility and reduces administrative overhead.
AI Powered Low-Code Platform: Adhar's low-code application development capabilities can empower non-technical users to create simple applications without extensive coding knowledge, broadening the pool of contributors and accelerating application development. AI can automate repetitive tasks, provide code recommendations, and accelerate application testing, leading to faster and more efficient software development.
Fully Open Source: The platform embraces open-source principles, fostering transparency, collaboration, and continuous improvement. This open-source philosophy aligns with the values of the developer community and promotes innovation.

How Adhar Platform Helps 🚀

💅Design Team - AI-powered design assistance and realistic content generation are rapidly transforming the creative process, making it easier and more efficient for designers and developers to create high-quality products. Additionally, easy design-to-code and code-to-design sync tools are helping to bridge the gap between design and development, ensuring that designs are implemented accurately and efficiently.

Use the Figma design components to build the application design
AI can generate the initial DRAFT version of the design and export to Figma
Designers love Figma, use it with full freedom
Export all visual elements as design-tokens which developers consume directly
Keep the sync between the design and the actual application code
Immidiate feedback look, make the change in design, see it in actual application immidiately
Don't have to depend on Developers for any change, be involve with the proccess
Evolve your design as long as it doesn't break the contract
Easy Collaborate with business team, tech team on same platform

💰Business Team - Business team involvement in transparent collaboration with the Tech team is crucial for designing and developing software products that align with business objectives and meet user needs. By providing wireframes, prototypes, and detailed business requirements directly in the system used by the Tech team, businesses can ensure seamless communication and alignment throughout the development process.

Create the prototypes which are part of real application, no through away effort after handing over to developers
Involve in improving the user journey through out the lifecycle
All the tools at your finger tip to create awesome journeys
Don't depend on developers to recreate the jourenies based on your input, you take the ownership
Developers will help to take it forward to next stages of the lifecycle
Always on top of the realistic status for various features, don't have to ask tech team
Improve UI/UX by providing feedback to design team in same system
Improve functionality and app performance by giving feedback to development team
All the analytics in same platform for making any business decission after delivery
Discover the insights and improve the product incrementaly

💻 Application Team - Easy self-service is a crucial aspect of enabling developers and operators to focus on their core responsibilities and reduce the burden of managing infrastructure and resources. By providing self-service capabilities, organizations can empower their technical teams.

Scan source code for vulnerabilities
Build OCI compliant images from application code and store them in a private registry
Deploy containerized workloads using a developer catalog with build-in or BYO golden path templates
Automatically update container images of workloads
Publicly expose applications
Get instant access to logs, metrics and traces
Store charts and images in a private registry
Configure network policies, response headers and CNAMEs
Manage secrets
Create private Git repositories and custom CI/CD pipelines

🔋 Platform Team - Platform engineers play a critical role in enabling developers to build, deploy, and manage applications effectively. By building and managing a Kubernetes-based platform, platform engineers provide developers with a self-service platform that simplifies and streamlines the process of bringing applications to production.

Create your platform profile and deploy to any K8s
Onboard development teams in a comprehensive multi-tenant setup and make them self-serving
Get all the required capabilities in an integrated and automated way
Ensure governance with security policies
Implement zero-trust networking
Change the desired state of the platform based on Configuration-as-Code
Support multi- and hybrid cloud scenarios
Prevent cloud provider lock-in
Implement full observability (metrics, logs, traces, alerts)
Create Golden path templates and offer them to teams on the platform through a catalog

👮 Management Team - It is important for the management team to have access to all the insights and reports to make the best possible business or technical decisions based on actual data points. This is because data can help to identify trends, patterns, and opportunities that would otherwise be invisible. It can also help to track progress, measure performance, and make informed decisions about resource allocation and strategy.

Fully integrated analytics platform
AI powered automated insights and recomendations
Various reports showcasing different aspects of the application
Realtime insights with zero filter
Usage statistics and projection
Easy Technology and Risk goverance
Visibility of end to end process

Getting Started ✨

The following command can be used as a convenience for installing adhar, (be sure to check the script first if you are concerned):

curl -fsSL https://raw.githubusercontent.com/adhar-io/adhar/main/hack/install.sh | bash

or download the latest stable release with the following commands:

version=$(curl -s https://api.github.com/repos/adhar-io/adhar/releases | grep tag_name | grep -o -e '"v[0-9].[0-9].[0-9]"' | head -n1 | sed 's/"//g')
curl -L --progress-bar -o ./adhar.tar.gz "https://github.com/adhar-io/adhar/releases/download/${version}/adhar-$(uname | awk '{print tolower($0)}')-$(uname -m | sed 's/x86_64/amd64/').tar.gz"
tar xzf adhar.tar.gz

./adhar version
# example output
# adhar 0.4.1 go1.21.5 linux/amd64

Alternatively, you can download the latest binary from the latest release page.

Once you have adhar cli installed, the most basic command which creates a Kubernetes Cluster (Kind cluster) with the core packages installed.

./adhar create

What are the core packages?

ArgoCD is the GitOps solution to deploy manifests to Kubernetes clusters. In this project, a package is an ArgoCD application.
Gitea server is the in-cluster Git server that ArgoCD can be configured to sync resources from. You can sync from local file systems to this.
Ingress-nginx is used as a method to access in-cluster resources such as ArgoCD UI and Gitea UI.

Core package versions

Name Version

Argo CD v2.10.7

Gitea v9.5.1

Nginx v1.8.1

Name	Version
Argo CD	v2.10.7
Gitea	v9.5.1
Nginx	v1.8.1

The default manifests for the core packages are available here. See the contribution doc for more information on how core packages are installed and configured.

Once adhar finishes provisioning cluster and packages, you can access GUIs by going to the following addresses in your browser.

ArgoCD: https://adhar.localtest.me:8443/argocd/
Gitea: https://adhar.localtest.me:8443/gitea/
Keycloak: https://adhar.localtest.me:8443/keycloak/
Argo-Workflows: https://adhar.localtest.me:8443/argo-workflows/
Backstage: https://adhar.localtest.me:8443/

Secrets

You can obtain credentials for them by running the following command:

./adhar get secrets

The "get secrets" command

The get secrets command retrieves the following:

ArgoCD initial admin password.
Gitea admin user credentials.
Any secrets labeled with cnoe.io/cli-secret=true.

You can think of the command as executing the following kubectl commands:

kubectl -n argocd get secret argocd-initial-admin-secret
kubectl get secrets -n gitea gitea-admin-secret
kubectl get secrets -A -l cnoe.io/cli-secret=true

In addition, secrets labeled with cnoe.io/package-name can be specified with the -p flag. For example, for Gitea:

./adhar get secrets -p gitea

Contribution Guide 🎓

Learn about integrating, deploying and managing your apps on Adhar platform.

Platform Architecture 🔮

Platform Components

Adhar consists of the following components:

Adhar Console (Self Service Portal)

Adhar Console stands as the centerpiece of our platform, offering a seamless user experience tailored for both developers and platform administrators. It serves as a one-stop solution for a multitude of tasks. Developers can leverage the Adhar Console to build images, deploy applications, expose services, configure CNAMEs, manage network policies, and handle secrets.

On the other hand, platform administrators can use it to enable and configure platform capabilities, as well as onboard development teams. The Adhar Console goes beyond just a web-based self-service portal, providing direct and context-aware access to platform capabilities like code repositories, registries, logs, metrics, traces, and dashboards.

Moreover, it includes a Cloud Shell feature, allowing both developers and admins to run CLI commands. In essence, the Adhar Console is a comprehensive tool designed to streamline and simplify the management of your platform.

Command Line Interface (CLI)

The Adhar Command Line Interface (CLI) provides a powerful tool for developers and administrators to interact with the Adhar platform, enabling them to manage resources, execute tasks, and automate workflows directly from the command line.

Platform Control plane (api-server)

In the Adhar platform, the api-server plays a crucial role in enabling seamless integration. Every alteration made via the Console is first verified by the api-server within the control plane. Once validated, these changes are stored in the state store. This action initiates an automatic process where the platform aligns the actual state with the desired state, thereby ensuring smooth integration and consistency across the platform.

Adhar Assist (AI)

Adhar Assist is an innovative feature of the Adhar platform that integrates AI assistance into your workflow. It leverages advanced machine learning algorithms to provide intelligent recommendations, automate routine tasks, and enhance decision-making processes. Whether you're configuring your platform, troubleshooting issues, or optimizing performance, Adhar Assist is there to guide you. It learns from your platform's data and usage patterns, continually improving its assistance over time. With Adhar Assist, you get a smart companion that helps you make the most of the Adhar platform. As a developer, you will enjoy the assistance provided by Adhar Assist during development.

Git Based Infrastructure

Upon installation of Adhar, the desired state of the platform is captured and preserved in the Git repository, specifically within the adhar/values repository in the Gitea. This Git-based state store plays a pivotal role in infrastructure management, serving as a reliable and version-controlled source of truth. Any modifications made through the Console are promptly mirrored in this repository. This approach not only ensures consistency and traceability but also facilitates collaboration and rollback capabilities, underscoring the importance of a Git-based state store in modern infrastructure.

Golden Templates Catalog

The adhar/helm-charts Git repository houses a collection of built-in Helm charts, which serve as the backbone for creating workloads within the Console. These charts are designed as golden templates, adhering to trending technology standards, ensuring optimal performance and compatibility. In addition to the built-in charts, the platform also offers the flexibility to add custom charts. This allows users to tailor their workloads to specific needs while maintaining the benefits of standardization. Thus, the adhar/helm-charts repository is not just a resource, but a gateway to efficient and standardized workload management on the Adhar platform.

Automation & Self Service

Automation and self-service capabilities are crucial aspects of modern platforms like Adhar. Automation helps in maintaining consistency, reducing human error, and increasing efficiency by automating repetitive tasks. For instance, it can be used to synchronize the desired state with the actual state of applications, ensuring they are always in sync and reducing the need for manual intervention. On the other hand, self-service capabilities empower users by giving them direct control over their services. This not only improves user satisfaction by providing immediate access to services but also reduces the load on support teams. In the context of Adhar, a platform that serves over a billion users, these features are not just beneficial, they are essential for scalability and user satisfaction.

Platform Capabilities

The platform offers a set of Kubernetes applications for all the required capabilities. Core applications are always installed, optional applications can be activated. When an application is activated, the application will be installed based on default configuration. Default configuration can be adjusted using the Console.

Integrated Applications:

Istio: The service mesh framework with end-to-end transit encryption
Keycloak: Identity and access management for modern applications and services
Cert Manager - Bring your own wildcard certificate or request one from Let's Encrypt
Nginx Ingress Controller: Ingress controller for Kubernetes
External DNS: Synchronize exposed ingresses with DNS providers
Argo CD: Declarative continuous deployment
Kaniko: Build container images from a Dockerfile
Paketo build packs: Cloud Native Buildpack implementations for popular programming language ecosystems
Cloudnative-pg: Open source operator designed to manage PostgreSQL workloads
Tekton Pipeline: K8s-style resources for declaring CI/CD pipelines
Tekton Triggers: Trigger pipelines from event payloads
Tekton dashboard: Web-based UI for Tekton Pipelines and Tekton Triggers
Gitea: Self-hosted Git service
Velero: Back up and restore your Kubernetes cluster resources and persistent volumes
Knative: Deploy and manage serverless workloads
Prometheus: Collecting container application metrics
Grafana: Visualize metrics, logs, and traces from multiple sources
Grafana Loki: Collecting container application logs
Harbor: Container image registry with role-based access control, image scanning, and image signing
HashiCorp Vault: Manage Secrets and Protect Sensitive Data
OPA/Gatekeeper: Policy-based control for cloud-native environments
Jaeger: End-to-end distributed tracing and monitor for complex distributed systems
Kiali: Observe Istio service mesh relations and connections
Minio: High performance Object Storage compatible with Amazon S3 cloud storage service
Trivy: Kubernetes-native security toolkit
Falco: Cloud Native Runtime Security
Grafana Tempo: High-scale distributed tracing backend
OpenTelemetry: Instrument, generate, collect, and export telemetry data to help you analyze your software’s performance and behavior

Supported providers ☁️

Adhar Platform can be installed on any Kubernetes cluster. At this time, the following providers are supported:

aws for AWS Elastic Kubernetes Service
azure for Azure Kubernetes Service
google for Google Kubernetes Engine
digitalocean for DigitalOcean Kubernetes
civo for Civo Cloud K3S
custom for any other cloud/infrastructure

Contribution 🙏

If you wish to contribute please read our Contributor Code of Conduct and Contribution Guidelines.

If you want to say thank you or/and support the active development of Adhar:

Star the Adhar project on Github
Feel free to write articles about the project on dev.to, medium or on your personal blog and share your experiences

This project exists thanks to all the people who have contributed

License ❄️

Adhar is licensed under the Apache 2.0 License.

adhar-io/adhar