{"id":13561686,"url":"https://github.com/edgelesssys/constellation","last_synced_at":"2025-05-14T13:06:49.915Z","repository":{"id":59297853,"uuid":"529896509","full_name":"edgelesssys/constellation","owner":"edgelesssys","description":"Constellation is the first Confidential Kubernetes. Constellation shields entire Kubernetes clusters from the (cloud) infrastructure using confidential computing.","archived":false,"fork":false,"pushed_at":"2025-05-12T06:18:12.000Z","size":47356,"stargazers_count":1035,"open_issues_count":28,"forks_count":53,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-05-12T07:28:45.122Z","etag":null,"topics":["cloud-security","confidential-computing","data-encryption","kubernetes","kubernetes-security"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edgelesssys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-08-28T15:08:34.000Z","updated_at":"2025-05-12T06:18:14.000Z","dependencies_parsed_at":"2023-10-11T09:01:27.170Z","dependency_job_id":"93e7c1c5-2a04-446b-8feb-6995040ae949","html_url":"https://github.com/edgelesssys/constellation","commit_stats":{"total_commits":4118,"total_committers":46,"mean_commits":89.52173913043478,"dds":0.8382710053423992,"last_synced_commit":"69048e430e11d85ed64b6f703c0c6161cb656c7d"},"previous_names":[],"tags_count":55,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgelesssys%2Fconstellation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgelesssys%2Fconstellation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgelesssys%2Fconstellation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgelesssys%2Fconstellation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edgelesssys","download_url":"https://codeload.github.com/edgelesssys/constellation/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149955,"owners_count":22022851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-security","confidential-computing","data-encryption","kubernetes","kubernetes-security"],"created_at":"2024-08-01T13:00:59.963Z","updated_at":"2025-05-14T13:06:44.894Z","avatar_url":"https://github.com/edgelesssys.png","language":"Go","readme":"![Constellation](docs/static/img/BannerConstellationanimated.svg)\n\n# Always Encrypted Kubernetes\n\n\u003cp\u003e\n    \u003ca href=\"https://github.com/edgelesssys/constellation/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/edgelesssys/constellation\" alt=\"Constellation License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/edgelesssys/constellation/actions/workflows/test-tidy.yml/badge.svg?branch=main\"\u003e\u003cimg src=\"https://github.com/edgelesssys/constellation/actions/workflows/test-tidy.yml/badge.svg?branch=main\" alt=\"Govulncheck\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://goreportcard.com/report/github.com/edgelesssys/constellation/v2\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/edgelesssys/constellation/v2\" alt=\"Go Report\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://discord.gg/rH8QTH56JN\"\u003e\u003cimg src=\"https://img.shields.io/discord/823900998606651454?color=7389D8\u0026label=discord\u0026logo=discord\u0026logoColor=ffffff\" alt=\"Discord\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://twitter.com/EdgelessSystems\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/EdgelessSystems?label=Follow\" alt=\"Twitter\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nConstellation is a Kubernetes engine that aims to provide the best possible data security. It wraps your K8s cluster into a single *confidential context* that is shielded from the underlying cloud infrastructure. Everything inside is always encrypted, including at runtime in memory. For this, Constellation leverages confidential computing (see the [whitepaper]) and more specifically Confidential VMs.\n\n\u003cimg src=\"docs/static/img/concept.svg\" alt=\"Concept\" width=\"85%\"/\u003e\n\n## Goals\n\nFrom a security perspective, Constellation is designed to keep all data always encrypted and to prevent access from the infrastructure layer (i.e., remove the infrastructure from the TCB). This includes access from datacenter employees, privileged cloud admins, and attackers coming through the infrastructure (e.g., malicious co-tenants escalating their privileges).\n\nFrom a DevOps perspective, Constellation is designed to work just like what you would expect from a modern K8s engine.\n\n## Use cases\n\nEncrypting your K8s is good for:\n\n* Increasing the overall security of your clusters\n* Increasing the trustworthiness of your SaaS offerings\n* Moving sensitive workloads from on-prem to the cloud\n* Meeting regulatory requirements\n\n## Features\n\n### 🔒 Everything always encrypted\n\n* Runtime encryption: All nodes run inside Confidential VMs (CVMs) based on AMD SEV or Intel TDX.\n* Transparent encryption of network: All [pod-to-pod traffic is automatically encrypted][network-encryption]\n* Transparent encryption of storage: All writes to persistent storage are automatically encrypted.\n  This includes [nodes' state disks][storage-encryption], [persistent volumes via CSI][csi], and [S3 object storage][s3proxy].\n* Transparent key management: All cryptographic [keys are managed within the confidential context][key-management]\n\n### 🔍 Everything verifiable\n\n\u003ca href=\"https://slsa.dev/\"\u003e\u003cimg src=\"docs/docs/_media/SLSA-Badge-full-level3.svg\" align=\"right\" width=\"225px\"\u003e\u003c/a\u003e\n\n* \"Whole cluster\" [attestation][cluster-attestation] based on the remote-attestation feature of CVMs\n* Confidential computing-optimized [node images][images]; fully measured and integrity-protected\n* [Supply chain protection][supply-chain] with [sigstore](https://www.sigstore.dev/) and [SLSA Level 3](https://slsa.dev/spec/v0.1/#security-levels).\n\n### 🚀 Performance and scale\n\n* High availability with multi-master architecture and stacked etcd topology\n* Dynamic cluster autoscaling with verification and secure bootstrapping of new nodes\n* Competitive [performance]\n\n### 🧩 Easy to use and integrate\n\n\u003ca href=\"https://landscape.cncf.io/?selected=constellation\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/cncf/artwork/1c1a10d9cc7de24235e07c8831923874331ef233/projects/kubernetes/certified-kubernetes/versionless/color/certified-kubernetes-color.svg\" align=\"right\" width=\"100px\"\u003e\u003c/a\u003e\n\n* Constellation is a [CNCF-certified][certified] Kubernetes. It's aligned to Kubernetes' [version support policy][k8s-version-support] and will likely work with your existing workloads and tools.\n* Support for AWS, Azure, GCP, and STACKIT.\n* Support for local installations with [MiniConstellation][first-steps-local].\n* Support for [Terraform][terraform-provider]\n\n## Getting started\n\nIf you're already familiar with Kubernetes, it's easy to get started with Constellation:\n\n1. 📦 [Install the CLI][install] or use the [Terraform provider][terraform-provider]\n2. ⌨️ Create a Constellation cluster in the [cloud][first-steps] or [locally][first-steps-local]\n3. 🏎️ [Run your app][examples]\n\n![Constellation Shell](docs/static/img/shell-windowframe.svg)\n\nLearn more: [\"Getting started with Constellation\" videos series](https://www.youtube.com/playlist?list=PLEhAl3D5WVvRYxO_yI7KzmtJ7rJUyQgNu).\n\n## Documentation\n\nTo learn more, see the [documentation](https://docs.edgeless.systems/constellation).\nYou may want to start with one of the following sections.\n\n* [Confidential Kubernetes][confidential-kubernetes] (Constellation vs. AKS/GKE + CVMs)\n* [Security benefits][security-benefits]\n* [Architecture][architecture]\n\n## Support\n\n* If something doesn't work, make sure to use the [latest release](https://github.com/edgelesssys/constellation/releases/latest) and check out the [known issues](https://github.com/edgelesssys/constellation/issues?q=is%3Aopen+is%3Aissue+label%3A%22known+issue%22).\n* Please file an [issue][github-issues] to get help or report a bug.\n* Join the [GitHub discussions](https://github.com/edgelesssys/constellation/discussions) if you have questions or would like to discuss an idea.\n* Visit our [blog](https://www.edgeless.systems/blog/) for technical deep-dives and tutorials and follow us on [LinkedIn] for news.\n* Edgeless Systems also offers [Enterprise Support][enterprise-support].\n\n## Contributing\n\nRefer to [`CONTRIBUTING.md`](CONTRIBUTING.md) on how to contribute. The most important points:\n\n* Pull requests are welcome! You need to agree to our [Contributor License Agreement][cla-assistant].\n* Please follow the [Code of Conduct](/CODE_OF_CONDUCT.md).\n\n\u003e **Warning**\n\u003e Please report any security issue via a [private GitHub vulnerability report](https://github.com/edgelesssys/constellation/security/advisories/new) or write to \u003csecurity@edgeless.systems\u003e.\n\n## License\n\nThe Constellation source code is licensed under the [GNU Affero General Public License v3.0](LICENSE). Edgeless Systems provides pre-built and signed binaries and images for Constellation. You may use these free of charge to create and run services for internal consumption, evaluation purposes, or non-commercial use. You can find more information in the [license] section of the docs.\n\n\u003c!-- refs --\u003e\n[architecture]: https://docs.edgeless.systems/constellation/architecture/overview\n[certified]: https://www.cncf.io/certification/software-conformance/\n[cla-assistant]: https://cla-assistant.io/edgelesssys/constellation\n[cluster-attestation]: https://docs.edgeless.systems/constellation/architecture/attestation#cluster-attestation\n[confidential-kubernetes]: https://docs.edgeless.systems/constellation/overview/confidential-kubernetes\n[enterprise-support]: https://www.edgeless.systems/products/constellation/\n[first-steps]: https://docs.edgeless.systems/constellation/getting-started/first-steps\n[first-steps-local]: https://docs.edgeless.systems/constellation/getting-started/first-steps-local\n[examples]: https://docs.edgeless.systems/constellation/getting-started/examples\n[github-issues]: https://github.com/edgelesssys/constellation/issues\n[images]: https://docs.edgeless.systems/constellation/architecture/images\n[install]: https://docs.edgeless.systems/constellation/getting-started/install\n[k8s-version-support]: https://docs.edgeless.systems/constellation/architecture/versions#kubernetes-support-policy\n[key-management]: https://docs.edgeless.systems/constellation/architecture/keys\n[license]: https://docs.edgeless.systems/constellation/overview/license\n[network-encryption]: https://docs.edgeless.systems/constellation/architecture/keys#network-encryption\n[storage-encryption]: https://docs.edgeless.systems/constellation/architecture/keys#storage-encryption\n[csi]: https://docs.edgeless.systems/constellation/workflows/storage\n[s3proxy]: https://docs.edgeless.systems/constellation/workflows/s3proxy\n[supply-chain]: https://docs.edgeless.systems/constellation/architecture/attestation#chain-of-trust\n[security-benefits]: https://docs.edgeless.systems/constellation/overview/security-benefits\n[linkedin]: https://www.linkedin.com/company/edgeless-systems\n[whitepaper]: https://content.edgeless.systems/hubfs/Confidential%20Computing%20Whitepaper.pdf\n[performance]: https://docs.edgeless.systems/constellation/overview/performance\n[terraform-provider]: https://docs.edgeless.systems/constellation/workflows/terraform-provider\n","funding_links":[],"categories":["Go","Build techniques","kubernetes"],"sub_categories":["Supply chain beyond libraries"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedgelesssys%2Fconstellation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedgelesssys%2Fconstellation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedgelesssys%2Fconstellation/lists"}