CouchDB 란? — Fabric 상태 DB 로 고른 대가는 파드 두 배

한 줄로

Hyperledger Fabric 피어가 현재 상태를 저장하는 DB 다.

기본값이 아니다. 일부러 골랐고, 그 대가로 피어 수만큼 DB 가 늘어난다.

헷갈리기 쉬운 지점이라 먼저 푼다.

블록체인은 거래 기록(원장) 을 이어붙인 사슬이다. “A가 B에게 10을 보냈다” 같은 기록이
순서대로 쌓인다. 그런데 여기서 “지금 A의 잔액은 얼마인가” 를 알려면 처음부터 전부
다시 계산해야 한다.

그래서 Fabric 은 현재 상태만 따로 저장하는 DB 를 둔다. 이걸 상태 DB(state database)
라고 부른다.

원장(블록)      : 거래 기록 전체. 절대 안 바뀜
상태 DB         : "지금 값은 이것" 만. 계속 갱신됨

상태 DB 가 날아가도 원장으로 다시 만들 수 있다. 원본이 아니라 캐시에 가깝다.

Fabric 은 상태 DB 를 두 가지 중에 고를 수 있다.

이 프로젝트는 CouchDB 를 골랐다.

kubectl hlf peer create --statedb=couchdb \
  --couchdb-repository=${COUCHDB_IMAGE} \
  ...

--statedb=couchdb 가 그 선택이다. 안 적으면 LevelDB 로 간다.

CouchDB 를 쓰는 이유는 사실상 하나다. 값의 내용으로 검색할 수 있기 때문이다.
Fabric 문서에서는 이걸 리치 쿼리(rich query)라고 부른다.

LevelDB 는 키-값 저장소라 “키가 car-001 인 것” 은 찾아도, “소유자가 홍길동인 자동차
전부” 는 못 찾는다. 값 안을 들여다볼 수 없기 때문이다.

CouchDB 는 값을 JSON 문서로 저장해서, 그 안의 필드로 조회할 수 있다. 체인코드에서
이런 질의가 가능해진다.

{"selector": {"owner": "홍길동"}}

앱을 만들 때 이 차이가 크다. 목록 화면, 검색, 필터가 필요하면 사실상 CouchDB 를
골라야 한다. 나중에 바꾸려면 네트워크를 다시 세워야 하므로, 처음에 정해야 하는 선택이다.

CouchDB 는 피어 안에 들어가지 않는다. 별도 컨테이너로 뜬다. 그것도 피어마다 하나씩이다.

피어 생성이 이중 반복문 안에 있다.

for ((org=1; org<=ORG_CNT; org++)); do
  for ((peer=1; peer<=PEER_CNT; peer++)); do
    kubectl hlf peer create --statedb=couchdb ...

조직 × 피어 수만큼 피어가 생기고, 그 수만큼 CouchDB 도 생긴다.

조직	피어/조직	피어	CouchDB	파드 총합
2	1	2	2	4
2	2	4	4	8
3	2	6	6	12

컨테이너 수가 두 배가 된다. 회사마다 클러스터를 하나씩 띄우는
구조에서 이건 가볍지 않다. 서버 한 대에 클러스터가 여러 개고, 각 클러스터 안에서 다시
파드가 두 배로 늘어나는 것이다.

모니터링 편에서 본 자원 제한이
왜 그렇게 빡빡한지도 여기서 이해된다. 쓸 수 있는 자원이 애초에 넉넉하지 않다.

이 프로젝트에서 CouchDB 이미지 지정이 두 군데 있는데 서로 다르다.

어디	값
시딩 목록	`couchdb:3.1.1` (태그 명시)
Fabric 배포 스크립트	`localhost:5001/couchdb` (태그 없음)

태그를 안 적으면 latest 로 해석된다. 그런데 시딩은 3.1.1 만 넣는다.

폐쇄망에서 이러면 레지스트리에 latest 태그가 없어 이미지를 못 받는 상황이 생길 수 있다.
지금 동작한다면 어딘가에서 latest 도 같이 올라갔기 때문일 텐데, 스크립트만 봐서는
보장되지 않는다.

--couchdb-repository 에 태그를 붙이거나, 시딩에서 latest 를 함께 채워야 확실해진다.

시딩 목록에 이런 줄도 있다.

["gesellix/couchdb-prometheus-exporter:v30.0.0"]="couchdb-prometheus-exporter:v30.0.0"

CouchDB 지표를 Prometheus 로 보내주는 exporter 다. 그런데 다른 어느 스크립트에서도
참조되지 않는다.

CouchDB 를 모니터링하려던 시도의 흔적으로 보인다. Prometheus 편
에서 본 모니터링 스택은 이 exporter 를 설치하지 않는다.

즉 CouchDB 는 지금 관측 대상이 아니다. 파드 개수는 두 배인데 그중 절반은 지표가 안 잡힌다.