Constellation is the first Confidential Kubernetes. Constellation shields entire Kubernetes clusters from the (cloud) infrastructure using confidential computing.
Go to file
Felix Schuster ebb8d7ca96
Rewrite install.md and create verify-cli.md (#124)
* Rewrite install.md and create verify-cli

* Small beautification

* Address review comment

* Shorten examples.md

* Quick brush over examples

* Fix broken links in v2.0

* Fix broken links in v2.0

* fix lint errors

Co-authored-by: Thomas Tendyck <tt@edgeless.systems>
2022-09-12 18:35:12 +02:00
.github Rewrite install.md and create verify-cli.md (#124) 2022-09-12 18:35:12 +02:00
3rdparty Update build environment to Fedora 36 & Go 1.19.1 2022-09-09 18:11:33 +02:00
access_manager Update build environment to Fedora 36 & Go 1.19.1 2022-09-09 18:11:33 +02:00
bootstrapper allow default routing in konnectivity 2022-09-12 14:56:40 +02:00
cli Fix manifest url (#128) 2022-09-12 14:33:08 +02:00
conformance fix some doc links 2022-09-12 13:09:55 +02:00
csi add license headers 2022-09-05 09:17:25 +02:00
debugd Deploy Konnectivity 2022-09-09 17:26:02 +02:00
disk-mapper AB#2260 Refactor disk-mapper recovery (#82) 2022-09-08 14:45:27 +02:00
docs Rewrite install.md and create verify-cli.md (#124) 2022-09-12 18:35:12 +02:00
hack Update build environment to Fedora 36 & Go 1.19.1 2022-09-09 18:11:33 +02:00
image Change default branch of constellation-fedora-coreos-config repo (#72) 2022-09-05 12:12:34 +02:00
internal Remove obsolete tpmPath passed to OpenTPM 2022-09-12 14:38:10 +02:00
joinservice Use distroless images for JoinService & KMS 2022-09-09 18:11:33 +02:00
kms Remove obsolete DEBIAN_FRONTEND for KMS build 2022-09-09 18:11:33 +02:00
operators/constellation-node-operator add license headers 2022-09-05 09:17:25 +02:00
proto Update build environment to Fedora 36 & Go 1.19.1 2022-09-09 18:11:33 +02:00
rfc Add docs to repo (#38) 2022-09-02 11:52:42 +02:00
terraform/libvirt AB#2369: Use contributing.md as ToC for dev docs. 2022-09-08 16:08:42 +02:00
verify Update build environment to Fedora 36 & Go 1.19.1 2022-09-09 18:11:33 +02:00
.dockerignore Rename coordinator to bootstrapper and rename roles 2022-07-14 17:25:18 +02:00
.gitignore Rename coordinator to bootstrapper and rename roles 2022-07-14 17:25:18 +02:00
.golangci.yml Update .golangci.yml 2022-09-12 08:49:02 +02:00
.lycheeignore Re-write Intro/Welcome (#97) 2022-09-08 08:43:40 +02:00
.vale.ini Add docs to repo (#38) 2022-09-02 11:52:42 +02:00
CHANGELOG.md Deploy Konnectivity 2022-09-09 17:26:02 +02:00
CMakeLists.txt Use CMake project version across all places & remove obsolete build tags 2022-09-09 15:33:16 +02:00
CODE_OF_CONDUCT.md Ref/readme (#375) 2022-08-19 14:54:11 +02:00
CONTRIBUTING.md AB#2369: Use contributing.md as ToC for dev docs. 2022-09-08 16:08:42 +02:00
Dockerfile.build Update build environment to Fedora 36 & Go 1.19.1 2022-09-09 18:11:33 +02:00
go.mod first implementation of SBOM generation (#50) 2022-09-02 16:49:59 +02:00
go.sum first implementation of SBOM generation (#50) 2022-09-02 16:49:59 +02:00
LICENSE add license 2022-09-05 09:17:25 +02:00
netlify.toml Add docs to repo (#38) 2022-09-02 11:52:42 +02:00
README.md promote issues as support channel (#123) 2022-09-12 13:01:50 +02:00
SECURITY.md Update README (#46) 2022-09-02 16:10:27 +02:00

Constellation

Always Encrypted K8s

Constellation License E2E Test Azure E2E Test GCP Go Report Discord Twitter

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

Concept

Goals

From 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).

From a DevOps perspective, Constellation is designed to work just like what you would expect from a modern K8s engine.

Use cases

Encrypting your K8s is good for:

  • Increasing the overall security of your clusters
  • Increasing the trustworthiness of your SaaS offerings
  • Moving sensitive workloads from on-prem to the cloud
  • Meeting regulatory requirements

Features

🔒 Everything always encrypted

  • Runtime encryption: All nodes run inside AMD SEV-based Confidential VMs (CVMs). Support for Intel TDX will be added in the future.
  • Transparent encryption of network and storage: All pod-to-pod traffic and all writes to persistent storage are automatically encrypted
  • Transparent key management: All cryptographic keys are managed within the confidential context

🔍 Everything verifiable

🚀 Performance and scale

  • High availability with multi-master architecture and stacked etcd topology
  • Dynamic cluster autoscaling with verification and secure bootstrapping of new nodes
  • Competitive performance (see K-Bench comparison with AKS and GKE)

🧩 Easy to use and integrate

  • Constellation is a CNCF-certified Kubernetes. It's aligned to Kubernetes' version support policy and will likely work with your existing workloads and tools.
  • Support for Azure and GCP, more to come.

Getting started

If you're already familiar with Kubernetes, it's easy to get started with Constellation:

  1. 📦 Install the CLI
  2. ⌨️ Create a Constellation cluster
  3. 🏎️ Run your app

Constellation Shell

Documentation

To learn more, see the documentation. You may want to start with one of the following sections.

Support

  • Please file an issue to get help or report a bug.
  • Join the Discord to have a chat on confidential computing and Constellation.
  • Visit our blog for technical deep-dives and tutorials and follow us on Twitter for news.
  • Edgeless Systems also offers Enterprise Support.

Contributing

Refer to CONTRIBUTING.md on how to contribute. The most important points:

License

The Constellation source code is licensed under the GNU Affero General Public License v3.0. 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. You can find more information in the license section of the docs.