Constellation is the first Confidential Kubernetes. Constellation shields entire Kubernetes clusters from the (cloud) infrastructure using confidential computing.
Go to file
Moritz Sanft a2096c2e33
docs: add docs on general Terraform usage (#1263)
* add docs on general tf usage

* reminder to not delete terraform dir

* fix spelling check

* add to sidebar

* reference terraform page

* embed link into natural language

* mention iam folder

* separate hack tools from official tf docs

* assume familiarity with tf
2023-02-28 10:36:20 +01:00
.github ci: use iam destroy command for resource destruction (#1272) 2023-02-28 09:52:32 +01:00
3rdparty deps: update to Go 1.20 2023-02-20 12:08:24 -05:00
apko deps: update apk package hashes (#1261) 2023-02-24 11:53:31 +01:00
bootstrapper helm: retry on connection refused (#1245) 2023-02-22 09:58:28 +01:00
cli cli: upgrade errors for microservice (#1259) 2023-02-28 10:23:09 +01:00
csi Enable cryptsetup read/write workqueue bypass (#1150) 2023-02-08 12:01:14 +01:00
debugd cli: add basic support for constellation create on OpenStack (#1283) 2023-02-27 18:19:52 +01:00
dev-docs docs: mention 'needs-backport' label in release process (#1216) 2023-02-20 10:44:16 +01:00
disk-mapper cli: add basic support for constellation create on OpenStack (#1283) 2023-02-27 18:19:52 +01:00
docs docs: add docs on general Terraform usage (#1263) 2023-02-28 10:36:20 +01:00
e2e dev-docs: Go package docs (#958) 2023-01-19 15:57:50 +01:00
hack deps: update module github.com/google/certificate-transparency-go to v1.1.4 (#1290) 2023-02-28 10:14:09 +01:00
image cli: add basic support for constellation create on OpenStack (#1283) 2023-02-27 18:19:52 +01:00
internal internal: add custom version type (#1256) 2023-02-28 10:36:04 +01:00
joinservice deps: update fedora:37 Docker digest (#1274) 2023-02-24 17:46:17 +01:00
keyservice deps: update fedora:37 Docker digest (#1274) 2023-02-24 17:46:17 +01:00
operators/constellation-node-operator deps: update module github.com/spf13/afero to v1.9.4 (#1269) 2023-02-24 15:54:01 +01:00
proto deps: update to Go 1.20 2023-02-20 12:08:24 -05:00
rfc cli: add basic support for constellation create on OpenStack (#1283) 2023-02-27 18:19:52 +01:00
rpm deps: temporarily remove unused RPMs 2023-02-20 12:08:24 -05:00
toolchains deps: update dependency io_bazel_rules_go to v0.38.1 (#1147) 2023-02-06 13:18:25 +01:00
tools build: add Bazel workspace and toolchains 2023-01-31 17:55:09 +01:00
upgrade-agent dev-docs: Go package docs (#958) 2023-01-19 15:57:50 +01:00
verify deps: update fedora:37 Docker digest (#1274) 2023-02-24 17:46:17 +01:00
.bazelrc deps: update dependency io_bazel_rules_go to v0.38.1 (#1147) 2023-02-06 13:18:25 +01:00
.bazelversion build: pin bazel version 2023-01-31 17:55:09 +01:00
.dockerignore ci: run versionsapi as docker action 2023-01-13 10:23:43 +01:00
.gitignore build: add shell.nix 2023-01-31 17:55:09 +01:00
.golangci.yml deps: vendor node-maintenance-operator api (#1172) 2023-02-14 18:46:48 +01:00
.grype.yaml ci: ignore GHSA-r2h5-3hgw-8j34 in grype (#1248) 2023-02-21 16:28:25 +01:00
.ko.yaml ko: update apko base images 2023-02-24 09:41:33 -05:00
.lycheeignore Fix links and clean lycheeignore (#1219) 2023-02-19 21:45:20 +01:00
.shellcheckrc Fix shellcheck warnings 2022-11-11 13:40:13 +01:00
.vale.ini Add docs to repo (#38) 2022-09-02 11:52:42 +02:00
BUILD.bazel build: set test timeout 2023-01-31 17:55:09 +01:00
CMakeLists.txt build: introduce pseudoversion for cli versions 2023-02-27 16:06:35 +01:00
CODE_OF_CONDUCT.md Ref/readme (#375) 2022-08-19 14:54:11 +02:00
CODEOWNERS Propose new code owners. (#1249) 2023-02-22 11:18:11 +01:00
CONTRIBUTING.md dev-docs: move into top-level dir (#924) 2023-01-10 14:18:41 +01:00
Dockerfile.build deps: update fedora:37 Docker digest (#1274) 2023-02-24 17:46:17 +01:00
go.mod deps: update module github.com/google/certificate-transparency-go to v1.1.4 (#1290) 2023-02-28 10:14:09 +01:00
go.sum deps: update module github.com/google/certificate-transparency-go to v1.1.4 (#1290) 2023-02-28 10:14:09 +01:00
go.work ci: add missing Go setup 2023-02-21 08:50:11 -05: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 docs: update security issue warning to use Github warning banner (#1050) 2023-01-20 16:17:39 +01:00
renovate.json renovate: update transitive Go dependencies 2023-02-21 03:08:12 -05:00
SECURITY.md promote new github security reporting feature 2022-11-10 16:31:13 +01:00
shell.nix build: add shell.nix 2023-01-31 17:55:09 +01:00
WORKSPACE.bazel deps: update to Go 1.20 2023-02-20 12:08:24 -05:00

Constellation

Always Encrypted Kubernetes

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

Live demos

We're running public instances of popular software on Constellation:

These instances run on CVMs in Azure and Constellation keeps them end-to-end confidential.

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:

Warning

Please report any security issue via a private GitHub vulnerability report or write to security@edgeless.systems.

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.