Helm/Vault Secrets Operator: Difference between revisions

Latest revision as of 10:25, 6 February 2026

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

Diagram

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 Skipped » Find More 👉 Vault » Config » Reloader

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 » Reloader 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 7: / Line 7: @@
 </syntaxhighlight>
 |valign='top' style='width:50%'|
+|-
+|valign='top' colspan='2'|
+{|class='wikitable mw-collapsible mw-collapsed'
+!scope='col' style='text-align:left'|
+[https://editor.plantuml.com/uml/TLJBRjim4BppAxOkq2Q7E8yshH70HL8xHXvDOjIkUoaGhAcrJ9WY1P9Iudvzbv8jAqsh8pcpCxixuhaFw4AHQV4cB2aZo3Kg8yHxc8IrLYQ5XNKmTMXyZewCN0EQ1BxXsXP1-9KoV8mPp56kKcSBamoiPaPe66tKa1POw32o9jmZYrsHBYaeYIsCj5bk3VEY0G9m90EQL5CBaxCQfhH1_1k3CbZN803mYRpDsWY_nCG-nHxhRu7Qj--_skSn9aa3E3uIGipjCtHkYpavGu4y37JX0xaEl1qTZNgZaQYqeZPqXbIIjdcyHGy9bTKb5-UMLOucG6SMvp49o2SJaex2BxCtu8esW-_ijt2IzYjswVr_s50JFJom4h8mbvXD7hOq-vfss_FGg0t91sNOW3KrPTNpZvwa8DupTxjf-GhzKWsiow4IZVsEHgUNbw-hNnHX2NSKbZRXyhjHRGn5zYCofc8c672EdjZKx61s0fScLOQOL_lZ55h7csvpL-NEMhyFrqO5XLhzhbg0Vb_meE7WIvmOdC6AzMNGW7ckrx2Nq8BhUtOSbeSPvpNiYmYiy9RnKwVIb1nFNreZ5KSgYiIUE9ASrAr8H4TIqmvpZximTkGP2FM8NQaaNKWPTU3cvrIqu7-JJxem8wSMwmY4Tp2sMl7VTiV6EO4lc8tP3rts6GfdwgN0rAx8L8QturiRkNJMjARpmlYgv2eVOnLCmDSS3DLqOA_mCVeXrjmN3NwdVjgetqmUxc78gsogLu1FtVhbu2Sag_KFOKePFp6XQgd6RlB6-CzT63Z2G8S_SWu6mIweOekAyd71Pz3hmaM9IkESV_7uIerjueKuvt3mU_O7 Diagram]
+|-
+|valign='top'|
+<kroki lang='plantuml'>
+@startuml
+!theme plain
+' Styling for Transparency and Layout
+skinparam backgroundColor transparent
+skinparam DefaultFontName Helvetica
+skinparam componentStyle  rectangle
+skinparam packageStyle    rectangle
+skinparam actorStyle      awesome
+skinparam shadowing       false
+skinparam BoxPadding      10
+box "Kubernetes Cluster" #F0F8FF
+    actor "Developer" as dev
+    participant "VaultStaticSecret\n(Custom Resource)" as vss
+    participant "Vault Secrets Operator\n(VSO)" as vso
+    participant "K8s Secret\n(Destination)" as k8s_sec
+end box
+box "HashiCorp Vault" #FFF5EE
+    participant "Auth Method\n(Kubernetes)" as vault_auth
+    database "KV-V2 Engine\n(Secret Storage)" as vault_kv
+end box
+== Initialization ==
+dev -> vss : kubectl apply (defines path/mount)
+vss -> vso : Trigger Reconcile
+== Authentication ==
+vso -> vault_auth : 1. Present K8s ServiceAccount JWT
+vault_auth -> vault_auth : 2. Verify JWT & Policy Mapping
+vault_auth --> vso : 3. Return Vault Token
+== Secret Synchronization ==
+vso -> vault_kv : 4. Read secret at path (using token)
+vault_kv --> vso : 5. Return JSON Data
+vso -> vso : 6. Transformation / Templating
+vso -> k8s_sec : 7. Create/Update K8s Secret
+k8s_sec --> dev : 8. Available for Pods
+@enduml
+</kroki>
+|}
 |}
@@ Line 223: / Line 275: @@
 ----
 * [[Vault#Engine » KV|Skipped » Find More 👉 Vault » Engine » KV]]
+----
+* [[Helm/Reloader#Reloader » Config|Skipped » Find More 👉 Vault » Config » Reloader]]
 |}
 |valign='top'|
@@ Line 254: / Line 308: @@
 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 313: / Line 372: @@
 </syntaxhighlight>
 |-
-!scope='col'| Secret
+!scope='col'| VaultStaticSecret
-!scope='col'| Verify
+!scope='col'| VaultStaticSecret » Verify
 |-
 |valign='top'|
@@ Line 365: / Line 424: @@
 kubectl -n=shahed-academia get    Secret            academia-audit-vso -o=yaml
 kubectl -n=shahed-academia get    VaultStaticSecret academia-audit-vso -o=yaml
+</syntaxhighlight>
+<syntaxhighlight lang='bash'>
+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
 </syntaxhighlight>
+|}
 |}
@@ Line 421: / Line 489: @@
 ==References==
-{|class='wikitable mw-collapsible'
+{|class='wikitable mw-collapsible mw-collapsed'
 !scope='col' style='text-align:left' colspan='3'|
 References
@@ Line 430: / Line 498: @@
 * [[Helm/Prometheus Stack|Helm » Prometheus Stack]]
 * [[Helm/Cert Manager|Helm » Cert Manager]]
+* [[Helm/Reloader|Helm » Reloader]]
 * [[Helm/Harbor|Helm » Harbor]]
 * [[Helm/Pi-Hole|Helm » Pi-Hole]]

Helm/Vault Secrets Operator: Difference between revisions

Latest revision as of 10:25, 6 February 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 10:25, 6 February 2026

Helm » Context

Helm » Install

Helm » Config

Helm » Debug

Helm » Uninstall

Vault » Config

Playground

References

Navigation menu

Search