Chart Provenance

As of Workflow v2.8.0, Deis has released Kubernetes Helm charts for Workflow and for each of its components.

Helm provides tools for establishing and verifying chart integrity. (For an overview, see the Provenance doc.) All release charts from the Deis Workflow team are now signed using this mechanism.

The full Deis, Inc. (Helm chart signing key) <security@deis.com> public key can be found here, as well as the pgp.mit.edu keyserver and the official Deis Keybase account. The key's fingerprint can be cross-checked against all of these sources.

Verifying a signed chart

The public key mentioned above must exist in a local keyring before a signed chart can be verified.

To add it to the default ~/.gnupg/pubring.gpg keyring, any of the following commands will work:

$ # via our hosted location
$ curl https://deis.com/workflow/docs/security/1d6a97d0.txt | gpg --import

$ # via the pgp.mit.edu keyserver
$ gpg --keyserver pgp.mit.edu --recv-keys 1D6A97D0

$ # via Keybase with account...
$ keybase follow deis
$ keybase pgp pull

$ # via Keybase by curl
$ curl https://keybase.io/deis/key.asc | gpg --import

Charts signed with this key can then be verified when fetched:

$ helm repo add deis https://charts.deis.com/workflow
"deis" has been added to your repositories

$ helm fetch --verify workflow/workflow --version v2.12.0
Verification: &{0xc4206124b0 sha256:f64d945a6755c7a0e3165d59a91226dc0fdadb0cc7eac2fb0463c86a74ed3649 workflow-v2.12.0.tgz}

One can then inspect the fetched workflow-v2.12.0.tgz.prov provenance file.

If the chart was not signed, the command above would result in:

Error: Failed to fetch provenance "https://charts.deis.com/workflow/workflow-v2.12.0.tgz.prov"

Alternatively, the chart can also be verified at install time:

$ helm install --verify deis/workflow --namespace deis
NAME:   exiled-mink
LAST DEPLOYED: Wed Mar  8 08:22:16 2017
NAMESPACE: deis
STATUS: DEPLOYED
...

$ helm ls
NAME        REVISION    UPDATED                     STATUS      CHART
exiled-mink 1           Wed Mar  8 08:22:16 2017    DEPLOYED    workflow-v2.12.0

Having done so, one is assured of the origin and authenticity of any installed Workflow chart released by Deis.