Constellation is the first Confidential Kubernetes. Constellation shields entire Kubernetes clusters from the (cloud) infrastructure using confidential computing.
Go to file
Fabian Kammel 0d12e37c96
Document exported funcs,types,interfaces and enable check. (#475)
* Include EXC0014 and fix issues.
* Include EXC0012 and fix issues.
Signed-off-by: Fabian Kammel <fk@edgeless.systems>
Co-authored-by: Otto Bittner <cobittner@posteo.net>
2022-11-09 15:57:54 +01:00
.github Only publish release AMIs 2022-11-09 14:29:58 +01:00
3rdparty/gcp-guest-agent Update ubuntu:22.04 Docker digest to 817cfe4 (#451) 2022-11-04 11:58:01 +01:00
access_manager docker: cache go compiler 2022-11-07 16:17:28 +01:00
bootstrapper Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
cli Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
csi Upgrade go module to v2 2022-09-22 09:10:19 +02:00
debugd Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
disk-mapper Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
docs release docs for v2.2 (#482) 2022-11-08 18:25:56 +01:00
hack Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
image Only publish release AMIs 2022-11-09 14:29:58 +01:00
internal Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
joinservice Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
kms Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
operators/constellation-node-operator Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
proto Update ubuntu:22.04 Docker digest to 817cfe4 (#451) 2022-11-04 11:58:01 +01:00
rfc AB#2566 RFC for image discoverability (description of image version uid) (#416) 2022-11-08 14:04:14 +01:00
verify Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
.dockerignore Rename coordinator to bootstrapper and rename roles 2022-07-14 17:25:18 +02:00
.gitignore Add .idea to .gitignore 2022-11-04 12:57:24 +01:00
.golangci.yml Document exported funcs,types,interfaces and enable check. (#475) 2022-11-09 15:57:54 +01:00
.lycheeignore Add www.linux-kvm.org to Lychee ignore list (temporarily) 2022-11-03 18:10:13 +01:00
.vale.ini Add docs to repo (#38) 2022-09-02 11:52:42 +02:00
CHANGELOG.md Bring in changes from release branch (#479) 2022-11-08 18:32:59 +01:00
CMakeLists.txt Bring in changes from release branch (#479) 2022-11-08 18:32:59 +01: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 docker: cache go compiler 2022-11-07 16:17:28 +01:00
go.mod Update Azure SDK (#493) 2022-11-09 12:09:22 +01:00
go.sum Update Azure SDK (#493) 2022-11-09 12:09:22 +01:00
go.work Upgrade Go version to 1.19 2022-10-28 16:06:53 +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
package-lock.json Release docs for v2.1 (#222) 2022-10-07 12:14:55 +02:00
README.md Add demo section to README (#441) 2022-11-03 17:03:26 +01:00
renovate.json Upgrade Go version to 1.19 2022-10-28 16:06:53 +02:00
SECURITY.md Update README (#46) 2022-09-02 16:10:27 +02:00

Constellation

Always Encrypted Kubernetes

Constellation License Daily E2E Tests Weekly E2E Tests Govulncheck 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

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 in the cloud or locally
  3. 🏎️ Run your app

Constellation Shell

Demo

We're running a Rocket.Chat server on Constellation at https://rocket.edgeless.systems/.

This blog post gives details on the setup.

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, evaluation purposes, or non-commercial use. You can find more information in the license section of the docs.