hashicorp vault secret엔진을 v2로 업그레이드하는 방법

 

1. secret엔진 v2의 핵심 기능

v2 핵심기능은 데이터 버전관리입니다. 그리고 데이터 버전관리가 되기 때문에 데이터 롤백기능도 지원합니다. v1에서는 버전관리 기능이 없어 데이터 롤백이 불가능합니다.

 

2. 버전 확인방법

vault CLI또는 UI대시보드에서 secret엔진 버전을 확인할 수 있습닏.

 

CLI에서는 secret list 명령어로 확인이 가능합니다. 명령어를 실행할 때 -detailed옵션을 설정해야 하며 options필드에 version이 표시됩니다.

vault secrets  list -detailed

 

UI대시보드에서는 secret 엔진 정보에 버전이 표시됩니다.

 

 

3. 업그레이드 하는 방법

3.1 데이터가 있는 경우

데이터가 이미 있는 secret 엔진인 경우 버전 업그레이드 명령어인 enable-versioning을 사용합니다. 버전 업그레이드 하는 동안 secret 엔진을 사용할 수 없습니다. 데이터 양에 따라 업그레이드 시간이 달라집니다.

vault kv enable-versioning secret/

 

3.2 데이터가 없는 경우

데이터가 없는 경우라면 secret 엔진을 비활성화 하고 버전 2로 다시 생성하면 됩니다.

vault secrets disable secret
vault secrets enable -path=secret -version=2 kv

 

 

참고자료

• https://tigercoin.tistory.com/369
• https://developer.hashicorp.com/vault/docs/secrets/kv/kv-v2#kv-secrets-engine-version-2

이하공백