Helm/Vault Secrets Operator: Difference between revisions

Latest revision as of 02:25, 24 January 2026

helm repo add hashicorp https://helm.releases.hashicorp.com helm repo update && helm repo list kubectl config get-contexts

Helm » Context

export KUBECONFIG="${HOME}/.kube/aws-kubeconfig.yaml"
export KUBECONFIG="${HOME}/.kube/gcp-kubeconfig.yaml"
export KUBECONFIG="${HOME}/.kube/lke-kubeconfig.yaml"
export KUBECONFIG="${HOME}/.kube/config"

Helm » Install

Helm » Install
helm show values hashicorp/vault-secrets-operator --version=1.1.0\|less helm show values hashicorp/vault-secrets-operator --version=1.2.0\|less
export KUBECONFIG="${HOME}/.kube/shahed-ab-kubeconfig.yaml" kubectl create ns vault-secrets-operator-system \|\| true	kubectl get ns\|grep vault-secrets-operator-system kubectl delete ns vault-secrets-operator-system \|\| true
Install	Notes
cat <<'YML' \| \ helm -n=vault-secrets-operator-system upgrade \ -i vso hashicorp/vault-secrets-operator --version=1.2.0 -f - --- controller: replicas: 1 kubeRbacProxy: image: repository: quay.io/brancz/kube-rbac-proxy tag: v0.18.1 resources: limits: cpu: 500m memory: 128Mi requests: cpu: 5m memory: 64Mi manager: image: repository: hashicorp/vault-secrets-operator tag: 1.2.0 resources: limits: cpu: 500m memory: 128Mi requests: cpu: 10m memory: 64Mi hooks: resources: limits: cpu: 500m memory: 128Mi requests: cpu: 10m memory: 64Mi csi: enabled: false driver: image: repository: hashicorp/vault-secrets-operator-csi tag: 1.0.1 livenessProbe: image: repository: registry.k8s.io/sig-storage/livenessprobe tag: v2.16.0 nodeDriverRegistrar: image: repository: registry.k8s.io/sig-storage/csi-node-driver-registrar tag: v2.14.0 YML
Verify
helm -n=vault-secrets-operator-system status vso helm -n=vault-secrets-operator-system get manifest vso

Helm » Config

Scale » Down

Scale » Up

kubectl -n=vault-secrets-operator-system \
scale deploy/vso-vault-secrets-operator-controller-manager --replicas=0

kubectl -n=vault-secrets-operator-system \
scale deploy/vso-vault-secrets-operator-controller-manager --replicas=1

Helm » Debug

kubectl -n=vault-secrets-operator-system logs -f  svc/vso-vault-secrets-operator-metrics-service -c kube-rbac-proxy
kubectl -n=vault-secrets-operator-system logs -f  svc/vso-vault-secrets-operator-metrics-service -c manager
kubectl -n=vault-secrets-operator-system logs -f  svc/vso-vault-secrets-operator-metrics-service

Helm » Uninstall

helm -n=vault-secrets-operator-system status    vso
helm -n=vault-secrets-operator-system get all   vso
helm -n=vault-secrets-operator-system uninstall vso

kubectl -n=vault-secrets-operator-system delete pvc --all
kubectl                                  delete ns  vault-secrets-operator-system
kubectl                                  delete pv  vso-data-vso-0

Vault » Config

Context Namespace

export KUBECONFIG="${HOME}/.kube/shahed-ab-kubeconfig.yaml"
kubectl get service kubernetes -n default
kubectl config get-contexts
kubectl cluster-info


kubectl get --raw /.well-known/openid-configuration|yq -P
kubectl config view -o=yaml|yq '.contexts[0].name'


kubectl get ns shahed-academia
kubectl     -n=shahed-academia get VaultAuth        auth-shahed-ab
kubectl     -n=shahed-academia get VaultConnection vault-shahed-ab

cat <<'YML' | \
kubectl apply -f -
---
apiVersion: v1
kind: Namespace
metadata:
  name: shahed-academia
  labels:
    app.kubernetes.io/version: 1.0.0
    app.kubernetes.io/managed-by: kubectl
YML

kubectl get namespace shahed-academia -o=yaml

Skipped » Find More 👉 Vault » Auth Skipped » Find More 👉 Vault » Engine » KV

Vault » Policy Vault » Role

cat <<'INI' | vault policy write policy-shahed-ab-vso -
# Mount : shahed/academia/dev
# Secret: audit
path "shahed/academia/dev/data/audit" {
  capabilities = ["read"]
}
INI

vault policy read  policy-shahed-ab-vso

vault kv get -mount=shahed/academia/dev audit
kubectl  get sa -n vault-secrets-operator-system
kubectl  get --raw /.well-known/openid-configuration|yq -P .issuer

vault write auth/kubernetes/role/role-shahed-ab-vso bound_service_account_names=default \
  bound_service_account_namespaces=shahed-academia policies=policy-shahed-ab-vso \
  audience='https://kubernetes.default.svc.cluster.local' ttl=24h

vault read  auth/kubernetes/role/role-shahed-ab-vso

Config » Init

VaultConnection VaultAuth

cat <<'YML' | \
kubectl -n shahed-academia apply -f -
---
apiVersion: secrets.hashicorp.com/v1beta1
kind: VaultConnection
metadata:
  name: vault-shahed-ab
  labels:
    app.kubernetes.io/version: 1.0.0
    app.kubernetes.io/managed-by: kubectl
spec:
  address: http://vault.vault.svc.cluster.local:8200
YML

kubectl get    clusterrolebinding vault-server-binding
kubectl get    clusterrolebinding vault-server-binding -o=yaml

kubectl create clusterrolebinding vault-server-binding \
  --clusterrole=system:auth-delegator --serviceaccount=vault:vault

kubectl -n=shahed-academia get VaultConnection
kubectl -n=shahed-academia get VaultConnection vault-shahed-ab -o=yaml

cat <<'YML' | \
kubectl -n shahed-academia apply -f -
---
apiVersion: secrets.hashicorp.com/v1beta1
kind: VaultAuth
metadata:
  name: auth-shahed-ab
  labels:
    app.kubernetes.io/version: 1.0.0
    app.kubernetes.io/managed-by: kubectl
spec:
  method: kubernetes
  mount: kubernetes
  vaultConnectionRef: vault-shahed-ab
  kubernetes:
    role: role-shahed-ab-vso
    serviceAccount: default
    audiences: 
      - https://kubernetes.default.svc.cluster.local
YML

kubectl -n=shahed-academia get VaultAuth
kubectl -n=shahed-academia get VaultAuth auth-shahed-ab -o=yaml

VaultStaticSecret VaultStaticSecret » Verify

cat <<'YML' | \
kubectl -n shahed-academia apply -f -
---
apiVersion: secrets.hashicorp.com/v1beta1
kind: VaultStaticSecret
metadata:
  name: academia-audit-vso
spec:
  vaultAuthRef: auth-shahed-ab
  mount: shahed/academia/dev
  refreshAfter: 30s
  path: audit
  type: kv-v2

  destination:
    name: academia-audit-vso
    type: Opaque
    create: true
    labels:
      app.kubernetes.io/component: secret-sync
      app.kubernetes.io/name: vault-secrets-operator
YML

Type	Purpose	Required Keys in Vault
`Opaque` (Default)	General secrets (passwords, keys)	Any keys
`kubernetes.io/dockerconfigjson`	Private registry credentials	Must contain a `.dockerconfigjson` key
`kubernetes.io/tls`	HTTPS/SSL certificates	Must contain `tls.crt` and `tls.key`
`kubernetes.io/ssh-auth`	SSH private keys	Must contain `ssh-privatekey`

kubectl -n=shahed-academia delete Secret            academia-audit-vso
kubectl -n=shahed-academia delete VaultStaticSecret academia-audit-vso

kubectl -n=shahed-academia get    Secret            academia-audit-vso -o=yaml
kubectl -n=shahed-academia get    VaultStaticSecret academia-audit-vso -o=yaml

kubectl -n=shahed-academia describe VaultStaticSecret academia-audit-vso
kubectl -n=shahed-academia label    VaultStaticSecret academia-audit-vso \
 last-sync=$(date +%s) --overwrite

kubectl -n shahed-academia get      VaultStaticSecret academia-audit-vso -w

Playground

Playground
helm -n=vault-secrets-operator-system install vso hashicorp/vault-secrets-operator --version=1.1.0 helm -n=vault-secrets-operator-system upgrade -i vso hashicorp/vault-secrets-operator --version=1.2.0 helm show values hashicorp/vault-secrets-operator --version=1.2.0\|less
kubectl -n=vault-secrets-operator-system exec -it svc/vso-vault-secrets-operator-metrics-service -c kube-rbac-proxy -- bash kubectl -n=vault-secrets-operator-system exec -it svc/vso-vault-secrets-operator-metrics-service -c manager -- bash kubectl -n=vault-secrets-operator-system logs -f svc/vso-vault-secrets-operator-metrics-service -c kube-rbac-proxy kubectl -n=vault-secrets-operator-system logs -f svc/vso-vault-secrets-operator-metrics-service -c manager kubectl -n=vault-secrets-operator-system logs -f svc/vso-vault-secrets-operator-metrics-service kubectl -n=vault-secrets-operator-system get pods --show-labels
kubectl -n=vault-secrets-operator-system delete all --all kubectl -n=vault-secrets-operator-system delete ing --all kubectl -n=vault-secrets-operator-system delete sts --all	kubectl delete pv vault-data-vault-0 kubectl -n=vault-secrets-operator-system delete svc --all kubectl -n=vault-secrets-operator-system delete pvc --all
kubectl -n=vault-secrets-operator-system rollout history deploy/vso-vault-secrets-operator-controller-manager kubectl -n=vault-secrets-operator-system rollout restart deploy/vso-vault-secrets-operator-controller-manager kubectl -n=vault-secrets-operator-system rollout status deploy/vso-vault-secrets-operator-controller-manager
kubectl -n=vault-secrets-operator-system exec -it svc/vso-vault-secrets-operator-metrics-service -c manager -- ash kubectl -n=vault-secrets-operator-system logs -f svc/vso-vault-secrets-operator-metrics-service -c manager kubectl -n=vault-secrets-operator-system logs -f svc/vso-vault-secrets-operator-metrics-service

References

References
Helm » External Secrets Operator Helm » Vault Secrets Operator Helm » Prometheus Stack Helm » Cert Manager Helm » Harbor Helm » Pi-Hole Helm » Vault Helm	Vault » Docs » Secrets management Vault » Docs » Build your CA Vault » Docs » Monitoring Vault » Docs » How Vault » Docs » Why Vault » Install Vault
K8s » Configure Service Accounts for Pods K8s » Restart Pods With Kubectl K8s » Interactive Pod K8s » Restart Pods Docker » Makefile Kubernetes Minikube Kubectl CURL K8s	K8s » `kubectl rollout` K8s » CSI Hostpath Driver Security » Password K8s » Storage K8s » Ingress K8s » Service K8s » Run MinIO CIDR UFW	Bind9 » Authoritative DNS Server Bind9 » Secondary DNS Server Minikube » Ingress DNS Minikube » Systemd Minikube » MetalLB Minikube » Registry Minikube » Tunnel Localtunnel ZA Proxy

@@ Line 217: / Line 217: @@
 </syntaxhighlight>
 |-
-|valign='top' colspan='2'|
+|valign='top'|
 {|class='wikitable'
-|valign='top' style='width:50%'|
+|valign='top'|
 * [[Vault#Auth|Skipped » Find More 👉 Vault » Auth]]
 ----
 * [[Vault#Engine » KV|Skipped » Find More 👉 Vault » Engine » KV]]
-|valign='top' style='width:50%'|
 |}
+|valign='top'|
 |-
 !scope='col'| Vault » Policy
@@ Line 231: / Line 231: @@
 |valign='top'|
 <syntaxhighlight lang='bash'>
-cat <<'INI' | vault policy write policy-shahed-ab -
+cat <<'INI' | vault policy write policy-shahed-ab-vso -
-path "shahed/data/academia/dev/audit" {
+# Mount : shahed/academia/dev
+# Secret: audit
+path "shahed/academia/dev/data/audit" {
    capabilities = ["read"]
 }
 INI
-vault policy read  policy-shahed-ab
+vault policy read  policy-shahed-ab-vso
 </syntaxhighlight>
 |valign='top'|
 <syntaxhighlight lang='bash'>
-kubectl get --raw /.well-known/openid-configuration|yq -P .issuer
+vault kv get -mount=shahed/academia/dev audit
+kubectl  get sa -n vault-secrets-operator-system
+kubectl  get --raw /.well-known/openid-configuration|yq -P .issuer
-vault write auth/kubernetes/role/role-shahed-ab bound_service_account_names=default \
+vault write auth/kubernetes/role/role-shahed-ab-vso bound_service_account_names=default \
-   bound_service_account_namespaces=shahed-academia policies=policy-shahed-ab \
+   bound_service_account_namespaces=shahed-academia policies=policy-shahed-ab-vso \
    audience='https://kubernetes.default.svc.cluster.local' ttl=24h
-vault read  auth/kubernetes/role/role-shahed-ab
+vault read  auth/kubernetes/role/role-shahed-ab-vso
 </syntaxhighlight>
+|-
+|valign='top' colspan='2'|
+{|class='wikitable mw-collapsible mw-collapsed'
+!scope='col' style='text-align:left' colspan='2'|
+Config » Init
 |-
 !scope='col'| VaultConnection
@@ Line 299: / Line 308: @@
    vaultConnectionRef: vault-shahed-ab
    kubernetes:
-     role: role-shahed-ab
+     role: role-shahed-ab-vso
      serviceAccount: default
      audiences:
@@ Line 309: / Line 318: @@
 </syntaxhighlight>
 |-
-!scope='col'| Secret
+!scope='col'| VaultStaticSecret
-!scope='col'| ConfigMap
+!scope='col'| VaultStaticSecret » Verify
 |-
 |valign='top'|
@@ Line 320: / Line 329: @@
 kind: VaultStaticSecret
 metadata:
-   name: academia-audit-sec-sync
+   name: academia-audit-vso
 spec:
-  path: shahed/academia/dev/audit
    vaultAuthRef: auth-shahed-ab
+  mount: shahed/academia/dev
    refreshAfter: 30s
-   mount: shahed
+   path: audit
    type: kv-v2
    destination:
-     name: academia-audit
+     name: academia-audit-vso
-     type: Secret
+     type: Opaque
      create: true
      labels:
-       app.kubernetes.io/version: 1.0.0
+       app.kubernetes.io/component: secret-sync
-       app.kubernetes.io/managed-by: vso
+       app.kubernetes.io/name: vault-secrets-operator
 YML
 </syntaxhighlight>
+|valign='top'|
+{|class='wikitable'
+!scope='col'| Type
+!scope='col'| Purpose
+!scope='col'| Required Keys in Vault
+|-
+| <code>Opaque</code> (Default)               || General secrets (passwords, keys)    || Any keys
+|-
+| <code>kubernetes.io/dockerconfigjson</code> || Private registry credentials         || Must contain a <code>.dockerconfigjson</code> key
+|-
+| <code>kubernetes.io/tls</code>              || HTTPS/SSL certificates               || Must contain <code>tls.crt</code> and <code>tls.key</code>
+|-
+| <code>kubernetes.io/ssh-auth</code>         || SSH private keys                     || Must contain <code>ssh-privatekey</code>
+|}
 <syntaxhighlight lang='bash'>
-kubectl -n=shahed-academia get VaultStaticSecret academia-audit-sec-sync -o=yaml
+kubectl -n=shahed-academia delete Secret            academia-audit-vso
-kubectl -n=shahed-academia get Secret            academia-audit -o=yaml
+kubectl -n=shahed-academia delete VaultStaticSecret academia-audit-vso
 </syntaxhighlight>
-|valign='top'|
+<syntaxhighlight lang='bash'>
-<syntaxhighlight lang='yaml'>
+kubectl -n=shahed-academia get    Secret            academia-audit-vso -o=yaml
-cat <<'YML' | \
+kubectl -n=shahed-academia get    VaultStaticSecret academia-audit-vso -o=yaml
-kubectl -n shahed-academia apply -f -
----
-apiVersion: secrets.hashicorp.com/v1beta1
-kind: VaultStaticSecret
-metadata:
-  name: academia-audit-cfm-sync
-spec:
-  path: shahed/academia/dev/audit
-  vaultAuthRef: auth-shahed-ab
-  refreshAfter: 30s
-  mount: shahed
-  type: kv-v2
-  destination:
-    name: academia-audit
-    type: ConfigMap
-    create: true
-    labels:
-      app.kubernetes.io/version: 1.0.0
-      app.kubernetes.io/managed-by: vso
-YML
 </syntaxhighlight>
 <syntaxhighlight lang='bash'>
-kubectl -n=shahed-academia get VaultStaticSecret academia-audit-cfm-sync -o=yaml
+kubectl -n=shahed-academia describe VaultStaticSecret academia-audit-vso
-kubectl -n=shahed-academia get ConfigMap         academia-audit -o=yaml
+kubectl -n=shahed-academia label    VaultStaticSecret academia-audit-vso \
+ last-sync=$(date +%s) --overwrite
+kubectl -n shahed-academia get      VaultStaticSecret academia-audit-vso -w
 </syntaxhighlight>
+|}
 |}
@@ Line 395: / Line 402: @@
 kubectl -n=vault-secrets-operator-system logs -f  svc/vso-vault-secrets-operator-metrics-service -c manager
 kubectl -n=vault-secrets-operator-system logs -f  svc/vso-vault-secrets-operator-metrics-service
+kubectl -n=vault-secrets-operator-system get      pods --show-labels
 </syntaxhighlight>
 |-
@@ Line 427: / Line 435: @@
 ==References==
-{|class='wikitable mw-collapsible'
+{|class='wikitable mw-collapsible mw-collapsed'
 !scope='col' style='text-align:left' colspan='3'|
 References
 |-
 |valign='top' style='width:33%'|
+* [[Helm/External Secrets Operator|Helm » External Secrets Operator]]
 * [https://artifacthub.io/packages/helm/hashicorp/vault-secrets-operator Helm » Vault Secrets Operator]
 * [[Helm/Prometheus Stack|Helm » Prometheus Stack]]

Helm/Vault Secrets Operator: Difference between revisions

Latest revision as of 02:25, 24 January 2026

Contents

Helm » Context

Helm » Install

Helm » Config

Helm » Debug

Helm » Uninstall

Vault » Config

Playground

References

Navigation menu

Helm/Vault Secrets Operator: Difference between revisions

Latest revision as of 02:25, 24 January 2026

Helm » Context

Helm » Install

Helm » Config

Helm » Debug

Helm » Uninstall

Vault » Config

Playground

References

Navigation menu

Search