Constellation is the first Confidential Kubernetes. Constellation shields entire Kubernetes clusters from the (cloud) infrastructure using confidential computing.
Go to file
Moritz Sanft 005e865a13
cli: use state file on init and upgrade (#2395)
* [wip] use state file in CLI

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

tidy

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* use state file in CLI

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

take clusterConfig from IDFile for compat

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

various fixes

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

wip

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* add GCP-specific values in Helm loader test

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* remove unnecessary pointer

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* write ClusterValues in one step

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* move stub to test file

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* remove mention of id-file

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* move output to `migrateTerraform`

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* unconditional assignments converting from idFile

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* move require block in go modules file

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* fall back to id file on upgrade

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* tidy

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* fix linter check

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* add notice to remove Terraform state check on manual migration

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* add `name` field

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

fix name tests

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* return early if no Terraform diff

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* tidy

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* return infrastructure state even if no diff exists

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* add TODO to remove comment

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* use state-file in miniconstellation

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* cli: remove id-file (#2402)

* remove id-file from `constellation create`

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* add file renaming to handler

* rename id-file after upgrade

* use idFile on `constellation init`

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* remove id-file from `constellation verify`

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* linter fixes

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* remove id-file from `constellation mini`

* remove id-file from `constellation recover`

* linter fixes

* remove id-file from `constellation terminate`

* fix initSecret type

* fix recover argument precedence

* fix terminate test

* generate

* add TODO to remove id-file removal

* Update cli/internal/cmd/init.go

Co-authored-by: Adrian Stobbe <stobbe.adrian@gmail.com>

* fix verify arg parse logic

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* add version test

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* remove id-file from docs

* add file not found log

* use state-file in miniconstellation

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* remove id-file from `constellation iam destroy`

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* remove id-file from `cdbg deploy`

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

---------

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>
Co-authored-by: Adrian Stobbe <stobbe.adrian@gmail.com>

* use state-file in CI

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>

* update orchestration docs

---------

Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>
Co-authored-by: Adrian Stobbe <stobbe.adrian@gmail.com>
2023-10-09 13:04:29 +02:00
.github cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
3rdparty deps: update go to 1.21.1 (#2389) 2023-09-28 22:29:14 +02:00
bazel cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
bootstrapper bootstrapper: package as tar 2023-09-27 17:58:19 +02:00
cli cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
csi csi: fix concurrent use of cryptmapper package (#2408) 2023-10-05 11:20:22 +02:00
debugd cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
dev-docs image: update README 2023-09-27 17:58:19 +02:00
disk-mapper disk-mapper: package as tar 2023-09-27 17:58:19 +02:00
docs cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
e2e deps: update Terraform azurerm to v3.74.0 (#2368) 2023-09-26 13:17:17 +02:00
hack cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
image image: reimplement and adapt measurement generation in Go 2023-09-27 17:58:19 +02:00
internal cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
joinservice joinservice: cache certificates for Azure SEV-SNP attestation (#2336) 2023-09-29 14:29:50 +02:00
keyservice cli: use Semver type to represent microservice versions (#2125) 2023-07-25 14:20:25 +02:00
measurement-reader measurement-reader: package as tar 2023-09-27 17:58:19 +02:00
nix/shells nix: init flake 2023-09-27 17:58:19 +02:00
operators/constellation-node-operator deps: update golang.org/x/tools (#2396) 2023-09-29 15:49:34 +02:00
rfc cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
rpm deps: downgrade libvirt to 8.10.0 (#1971) 2023-06-27 11:34:07 +02:00
s3proxy s3proxy: add keyservice integration 2023-10-06 11:23:32 +02:00
tools bazel: rewrite pseudo-version stamping in bash (#2020) 2023-07-05 14:42:18 +02:00
upgrade-agent upgrade-agent: package as tar 2023-09-27 17:58:19 +02:00
verify cli: use Semver type to represent microservice versions (#2125) 2023-07-25 14:20:25 +02:00
.bazelrc use toolchains from nixpkgs (with fallback) 2023-09-27 17:58:19 +02:00
.bazelversion deps: update bazel, rules_go and gazelle (#2203) 2023-08-10 10:52:15 +02:00
.dockerignore ci: run versionsapi as docker action 2023-01-13 10:23:43 +01:00
.gitignore bazel: mkosi_image rule 2023-09-27 17:58:19 +02:00
.golangci.yml ci: add e2e-upgrade test 2023-03-23 14:57:38 +01:00
.grype.yaml ci: ignore replaced ghsa (#1392) 2023-03-10 11:13:05 +01:00
.lycheeignore ci: remove Azure portal internal links from docs (#2122) 2023-07-20 15:04:34 +02: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 bazel: allow custom container_prefix (#1693) 2023-04-27 11:52:02 +02:00
CMakeLists.txt operators: use bazel to run operator envtests 2023-08-17 10:46:45 +02:00
CODE_OF_CONDUCT.md Ref/readme (#375) 2022-08-19 14:54:11 +02:00
CODEOWNERS hack: remove pseudo-version tool 2023-09-29 14:09:58 +02:00
CONTRIBUTING.md dev-docs: refactor and add information for newbies (#1912) 2023-06-19 17:39:43 +02:00
flake.lock nix: update flake.lock 2023-09-29 14:09:58 +02:00
flake.nix nix: init flake 2023-09-27 17:58:19 +02:00
go.mod cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
go.sum cli: use state file on init and upgrade (#2395) 2023-10-09 13:04:29 +02:00
go.work deps: update go to 1.21.1 (#2389) 2023-09-28 22:29:14 +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 docs: update govulncheck badge to new workflow (#1531) 2023-03-29 10:26:45 +02:00
renovate.json5 renovate: group core bazel dependencies (Bazel, rules_go, gazelle) (#2204) 2023-08-10 10:49:28 +02:00
SECURITY.md promote new github security reporting feature 2022-11-10 16:31:13 +01:00
version.txt chore: bump version.txt (#2334) 2023-09-14 14:42:16 +02:00
WORKSPACE.bazel image: add kernel rpms 2023-09-27 17:58:19 +02: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

  • If something doesn't work, make sure to use the latest release and check out the known issues.
  • 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.