Home

Awesome

<div align="center"> <p></p><p></p> <p> <img src="docs/logo.png"> </p> <h1 style="font-size: 1.5em;"> Intent-Driven Platform Orchestrator </h1> <p align="center"> <a href="https://www.kusionstack.io/docs/" target="_blank"><b>🌐 Website</b></a> β€’ <a href="https://www.kusionstack.io/docs/getting-started/deliver-quickstart" target="_blank"><b>⚑️ Quick Start</b></a> β€’ <a href="https://www.kusionstack.io/docs/" target="_blank"><b>πŸ“š Docs</b></a> β€’ <a href="https://github.com/orgs/KusionStack/discussions" target="_blank"><b>πŸ’¬ Discussions</b></a><br> [English] <a href="https://github.com/KusionStack/kusion/blob/main/README-zh.md" target="_blank">[δΈ­ζ–‡]</a> </p>

Kusion GitHub release Go Report Card Go Reference license

</div>

What is Kusion?

Kusion is an intent-driven Platform Orchestrator, which sits at the core of an Internal Developer Platform (IDP). With Kusion you can enable app-centric development, your developers only need to write a single application specification - AppConfiguration. AppConfiguration defines the workload and all resource dependencies without needing to supply environment-specific values, Kusion ensures it provides everything needed for the application to run.

Kusion helps app developers who are responsible for creating applications and the platform engineers responsible for maintaining the infrastructure the applications run on. These roles may overlap or align differently in your organization, but Kusion is intended to ease the workload for any practitioner responsible for either set of tasks.

<div align="center">

workflow

</div>

How does Kusion work?

As a Platform Orchestrator, Kusion enables you to address challenges often associated with Day 0 and Day 1. Both platform engineers and application engineers can benefit from Kusion.

There are two key workflows for Kusion:

  1. Day 0 - Set up the modules and workspaces: Platform engineers create shared modules for deploying applications and their underlying infrastructure, and workspace definitions for the target landing zone. These standardized, shared modules codify the requirements of stakeholders across the organization including security, compliance, and finance.

    Kusion modules abstract the complexity of underlying infrastructure tooling, enabling app developers to deploy their applications using a self-service model.

    <div align="center">

    workflow

    </div>
  2. Day 1 - Set up the application: Application developers leverage the workspaces and modules created by the platform engineers to deploy applications and their supporting infrastructure. The platform team maintains the workspaces and modules, which allows application developers to focus on building applications using a repeatable process on standardized infrastructure.

    <div align="center">

    workflow

    </div>

Quick Start

This guide will cover:

  1. Install Kusion CLI.
  2. Deploy an application to Kubernetes with Kusion.

Install

Homebrew (macOS & Linux)

# tap formula repository Kusionstack/tap
brew tap KusionStack/tap

# install Kusion 
brew install KusionStack/tap/kusion

Powershell

# install Kusion latest version
powershell -Command "iwr -useb https://www.kusionstack.io/scripts/install.ps1 | iex"

For more information about installation, please refer to the Installation Guide for more options.

Deploy

To deploy an application, you can run the kusion apply command.

To rapidly get Kusion up and running, please refer to the Quick Start Guide.

apply

Contact

If you have any questions, feel free to reach out to us in the following ways:

Contributing

If you're interested in contributing, please refer to the Contributing Guide before submitting a pull request.

License

Kusion is under the Apache 2.0 license. See the LICENSE file for details.

OpenSSF Best Practice Badge

OpenSSF Best Practices