NOVA CLI reference 0.5.0 GitHub
  1. nova
  2. nova bootstrap

nova bootstrap ca-certificates

Trust a TLS-inspecting proxy's CA in cluster workloads

Synopsis

Injects one or more proxy CA certificates into the system trust store of workloads in the target namespace.

Useful when the cluster sits behind a proxy that performs SSL inspection: the proxy re-signs TLS connections with its own CA, which workloads would otherwise reject. This installs Kyverno (via the k3s HelmChart controller) and a ClusterPolicy that, for every Pod in the target namespace, merges the system root CAs with the provided proxy CA and mounts the result over /etc/ssl/certs/ca-certificates.crt (also setting SSL_CERT_FILE).

This fixes both the Cryptlex LexActivator (libcurl) license calls and Go's net/http calls (developer portal API, Auth0) in the Service Manager Backend.

Pass one or more PEM or DER certificate files as positional arguments (DER is converted to PEM automatically):

nova bootstrap ca-certificates proxy-root.pem proxy-intermediate.der

Note: if Cryptlex SSL pinning is enabled, CA injection will not help and you must exclude *.cryptlex.com from SSL inspection on the proxy instead.

nova bootstrap ca-certificates <pem-file> [pem-file...] [flags]

Options

      --all-apps              Inject the proxy CA into every Pod in the namespace (overrides the default service-manager-only scope)
  -h, --help                  help for ca-certificates
      --init-image string     Image used to merge system roots with the proxy CA (must ship /etc/ssl/certs/ca-certificates.crt) (default "wandelbots.azurecr.io/docker.io/library/alpine:3")
      --target-apps strings   Restrict CA injection to Pods whose app.kubernetes.io/name is in this list (default: service-manager only)

Options inherited from parent commands

      --debug                      Write diagnostic output to stderr: HTTP requests and responses, external commands, the resolved instance. Known secrets are redacted, but bodies (app environments, kubeconfigs) can still contain some: don't share the output unreviewed (env: NOVA_DEBUG=1)
      --dry-run                    Print manifests to stdout instead of applying via kubectl
      --env string                 (Wandelbots internal) Portal environment for this invocation: prod, stg or dev (default: the environment of the cloud instance, else of the last 'nova login'; env: NOVA_ENV)
      --http-proxy string          HTTP proxy for deployed workloads (global.proxy.httpProxy); does not affect the CLI's own calls
      --https-proxy string         HTTPS proxy for deployed workloads (global.proxy.httpsProxy); does not affect the CLI's own calls
      --insecure-skip-tls-verify   If true, the server's certificate will not be checked for validity (disables TLS verification for all requests)
      --instance string            Name of the instance to work against for this invocation (overrides the selected instance; env: NOVA_INSTANCE)
      --namespace string           Target Kubernetes namespace (default "wandelbots")
      --no-proxy string            Comma-separated NO_PROXY entries (global.proxy.noProxy); does not affect the CLI's own calls
      --use-k3s-proxy-env          Read HTTP_PROXY/HTTPS_PROXY/NO_PROXY from /etc/systemd/system/k3s.service.env on a cluster node (via a transient pod) instead of passing --http-proxy/--https-proxy/--no-proxy; explicit flags take precedence

SEE ALSO