Skip to content

Commit

Permalink
chore(docs): update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
FalcoSuessgott committed Nov 18, 2024
1 parent d2d41aa commit af8e8a3
Show file tree
Hide file tree
Showing 6 changed files with 12 additions and 14 deletions.
6 changes: 2 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,15 +23,13 @@ To do so, you will have to enable Data at Rest encryption, by configuring the `k

:warning: As a result of that, **the `kube-apiserver` requires the `vault-kubernetes-kms` plugin to be up & running before the `kube-apiserver` starts**. To ensure this, setting a priority class in the plugins manifest (`"priorityClassName: system-node-critical"`) is recommended. :warning:

:warning: **`vault-kubernetes-kms` is in early stage! Running it in Production is not yet recommended. Im looking for early adopters in order to gather important feedback.** :warning:

**[Check out the official documentation](https://falcosuessgott.github.io/vault-kubernetes-kms/)**

## Features
* support [Vault Token](https://developer.hashicorp.com/vault/docs/auth/token), [AppRole](https://developer.hashicorp.com/vault/docs/auth/approle) authentication (Since a static pod cannot reference any other Kubernetes API-Objects, Vaults Kubernetes Authentication is not possible.)
* support Kubernetes [KMS Plugin v1 (deprecated since `v1.28.0`) & v2 (stable in `v1.29.0`)](https://kubernetes.io/docs/tasks/administer-cluster/kms-provider/#before-you-begin)
* automatic Token Renewal for avoiding Token expiry
* Exposes useful Prometheus Metrics
* [automatic Token Renewal for avoiding Token expiry](https://falcosuessgott.github.io/vault-kubernetes-kms/configuration/#cli-args-environment-variables)
* [Exposes useful Prometheus Metrics](https://falcosuessgott.github.io/vault-kubernetes-kms/metrics/#prometheus-metrics)

## Without a KMS Provider
```bash
Expand Down
2 changes: 1 addition & 1 deletion assets/vault-kubernetes-kms.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ spec:
memory: 128Mi
limits:
cpu: 2
memory: 256Mi
memory: 1Gi
volumes:
# mount /opt/kms host directory
- name: kms
Expand Down
2 changes: 1 addition & 1 deletion cmd/plugin.go
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ type Options struct {
HealthPort string `env:"HEALTH_PORT" envDefault:"8080"`

// Disable KMSv1 Plugin
DisableV1 bool `env:"DISABLE_V1" envDefault:"true"`
DisableV1 bool `env:"DISABLE_V1" envDefault:"false"`

Version bool
}
Expand Down
8 changes: 4 additions & 4 deletions docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,7 +151,7 @@ List of required and optional CLI args/env vars. **Furthermore, all of Vaults [E

* **(Optional)**: `-debug` (`VAULT_KMS_DEBUG`)
* **(Optional)**: `-health-port` (`VAULT_KMS_HEALTH_PORT`); default: `":8080"`
* **(Optional)**: `-disable-v1` (`VAULT_KMS_DISABLE_V1`); default: `"false"`
* **(Optional)**: `-disable-v1` (`VAULT_KMS_DISABLE_V1`); default: `"true"`


### Example Vault Token Auth
Expand Down Expand Up @@ -191,7 +191,7 @@ spec:
memory: 128Mi
limits:
cpu: 2
memory: 256Mi
memory: 1Gi
volumes:
- name: kms
hostPath:
Expand Down Expand Up @@ -236,7 +236,7 @@ spec:
memory: 128Mi
limits:
cpu: 2
memory: 256Mi
memory: 1Gi
volumes:
- name: kms
hostPath:
Expand Down Expand Up @@ -293,7 +293,7 @@ spec:
memory: 128Mi
limits:
cpu: 2
memory: 256Mi
memory: 1Gi
volumes:
- name: kms
hostPath:
Expand Down
4 changes: 2 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,5 +28,5 @@ To do so, you will have to enable Data at Rest encryption, by configuring the `k
## Features
* support [Vault Token Auth](https://developer.hashicorp.com/vault/docs/auth/token) (not recommended for production), [AppRole](https://developer.hashicorp.com/vault/docs/auth/approle) and [Vault Kubernetes Auth](https://developer.hashicorp.com/vault/docs/auth/kubernetes) using the Plugins Service Account
* support Kubernetes [KMS Plugin v1 (deprecated since `v1.28.0`) & v2 (stable in `v1.29.0`)](https://kubernetes.io/docs/tasks/administer-cluster/kms-provider/#before-you-begin)
* automatic Token Renewal for avoiding Token expiry
* Exposes useful Prometheus Metrics
* [automatic Token Renewal for avoiding Token expiry](https://falcosuessgott.github.io/vault-kubernetes-kms/configuration/#cli-args-environment-variables)
* [Exposes useful Prometheus Metrics](https://falcosuessgott.github.io/vault-kubernetes-kms/metrics/#prometheus-metrics)
4 changes: 2 additions & 2 deletions scripts/vault-kubernetes-kms.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ spec:
imagePullPolicy: IfNotPresent
command:
- /vault-kubernetes-kms
- -vault-address=http://host.docker.internal:8200
- -vault-address=http://172.17.0.1:8200
- -auth-method=token
- -token=root
volumeMounts:
Expand All @@ -35,7 +35,7 @@ spec:
memory: 128Mi
limits:
cpu: 2
memory: 256Mi
memory: 1Gi
volumes:
# mount /opt/kms host directory
- name: kms
Expand Down

0 comments on commit af8e8a3

Please sign in to comment.