Kubernetes Secret


This guide will show you how to use Kubernetes Secret to manage configurations via the Configu interface. Learn about the concept of stores.

Working with the store

CLI installation

1curl https://cli.configu.com/install.sh | sh

CLI usage

Create the store URI as follows:

kubernetes-secret://[path to kubeconfig][?namespace=]


  • If a namespace is not provided, the default namespace named "default" will be used.

CLI Upsert

configu upsert --set "example" --schema "example.cfgu.json" --store "kubernetes-secret:// kubeconfig.yaml" --config "FOO=value" --config "BAR=bar"

CLI Export

configu export --set "example" --schema "example.cfgu.json" --store "kubernetes-secret:// kubeconfig.yaml" --format "Dotenv"

CLI Delete

configu delete --set "example" --schema "example.cfgu.json" --store --store "kubernetes-secret:// kubeconfig.yaml"

SDK installation

Install the node.js SDK

// * Using yarn
yarn add @configu/node
// * Using npm
npm install --save @configu/node

SDK usage

import { Cfgu, Set, UpsertCommand, EvalCommand, DeleteCommand, KubernetesSecretStore} from "@configu/node";
import path from "path";

const store = new KubernetesSecretStore({ kubeconfigFilePath: path.resolve(__dirname, "./service-account.json"), namespace: "default" });
const schema = new Cfgu(path.resolve(__dirname, "./example.cfgu.json"));
const set = new Set("dev");

// * Example upsert command
await new UpsertCommand({ store, set, schema, configs: [{ key: "foo", value: "bar" }] }).run();

// * Example eval command
const configs = await new EvalCommand({ store, set, schema }).run();

// * Example delete command
await new DeleteCommand({ store, set, schema }).run();


To reference a value from this store, use the following reference format: