open-vault/website/content/docs/platform/k8s/helm/examples/enterprise-with-raft.mdx

63 lines
2.1 KiB
Plaintext

---
layout: 'docs'
page_title: 'Highly Available Vault Enterprise Cluster with Raft'
sidebar_current: 'docs-platform-k8s-examples-enterprise-with-raft'
description: |-
Describes how to set up a highly available Vault Enterprise cluster with Integrated Storage (Raft)
---
# Highly Available Vault Enterprise Cluster with Integrated Storage (Raft)
@include 'helm/version.mdx'
Integrated Storage (raft) can be enabled using the `server.ha.raft.enabled` value:
```shell
helm install vault hashicorp/vault \
--set='server.image.repository=hashicorp/vault-enterprise' \
--set='server.image.tag=1.12.0-ent' \
--set='server.ha.enabled=true' \
--set='server.ha.raft.enabled=true'
```
-> For license configuration refer to [Running Vault Enterprise](/docs/platform/k8s/helm/enterprise).
Next, initialize and unseal `vault-0` pod:
```shell
kubectl exec -ti vault-0 -- vault operator init
kubectl exec -ti vault-0 -- vault operator unseal
```
Finally, join the remaining pods to the Raft cluster and unseal them. The pods
will need to communicate directly so we'll configure the pods to use the internal
service provided by the Helm chart:
```shell
kubectl exec -ti vault-1 -- vault operator raft join http://vault-0.vault-internal:8200
kubectl exec -ti vault-1 -- vault operator unseal
kubectl exec -ti vault-2 -- vault operator raft join http://vault-0.vault-internal:8200
kubectl exec -ti vault-2 -- vault operator unseal
```
To verify if the Raft cluster has successfully been initialized, run the following.
First, login using the `root` token on the `vault-0` pod:
```shell
kubectl exec -ti vault-0 -- vault login
```
Next, list all the raft peers:
```shell
kubectl exec -ti vault-0 -- vault operator raft list-peers
Node Address State Voter
---- ------- ----- -----
a1799962-8711-7f28-23f0-cea05c8a527d vault-0.vault-internal:8201 leader true
e6876c97-aaaa-a92e-b99a-0aafab105745 vault-1.vault-internal:8201 follower true
4b5d7383-ff31-44df-e008-6a606828823b vault-2.vault-internal:8201 follower true
```