Files
service-catalog/manifests/helm/cloudbeaver/1.1.4/CUSTOM-README.md
T
2026-04-13 13:09:02 +09:00

2.9 KiB

CloudBeaver 배포 가이드

CloudBeaver는 DBeaver가 제공하는 웹 기반 데이터베이스 관리 도구이다. 브라우저에서 PostgreSQL, MySQL, ClickHouse 등 다양한 데이터베이스에 접속하여 쿼리 실행 및 데이터 탐색이 가능하다.


배포 방법

helm upgrade cloudbeaver ./ -f custom-values.yaml --install -n cloudbeaver --create-namespace

custom-values.yaml 설명

1) 이미지 설정

Name 설명 기본값
image.registry 이미지 레지스트리 docker.io
image.repository 이미지 저장소 dbeaver/cloudbeaver
image.tag 이미지 태그 26.0.1
image.pullPolicy 이미지 Pull 정책 IfNotPresent

2) 서비스 설정

Name 설명 기본값
service.type 서비스 타입 ClusterIP
service.ports.http 서비스 포트 8978

3) Ingress 설정

Name 설명 기본값
ingress.enabled Ingress 활성화 여부 true
ingress.ingressClassName IngressClass 이름 kong
ingress.hostname 접속 도메인 cloudbeaver.example.org
ingress.tls TLS 활성화 여부 true

cert-manager를 통한 인증서 자동 발급 및 Kong HTTPS 리다이렉트를 기본으로 사용한다. TLS 시크릿은 cert-manager가 {hostname}-tls 이름으로 자동 생성한다.

ingress:
  annotations:
    cert-manager.io/cluster-issuer: root-ca-issuer
    cert-manager.io/duration: 8760h
    cert-manager.io/renew-before: 720h
    konghq.com/protocols: https
    konghq.com/https-redirect-status-code: "301"
  tls: true

4) 스토리지 설정

CloudBeaver는 DB 접속 정보, 사용자 설정 등을 /opt/cloudbeaver/workspace에 저장한다.

Name 설명 기본값
persistence.enabled PVC 사용 여부 true
persistence.storageClass StorageClass (빈 값이면 기본 사용) ""
persistence.size 볼륨 크기 5Gi
persistence.accessModes 접근 모드 [ReadWriteOnce]

5) 리소스 설정

resources:
  requests:
    cpu: 500m
    memory: 512Mi
  limits:
    cpu: "1"
    memory: 1Gi

6) 보안 컨텍스트

CloudBeaver는 UID/GID 8978로 실행된다. 기본값 그대로 사용을 권장한다.

podSecurityContext:
  enabled: true
  fsGroup: 8978

containerSecurityContext:
  enabled: true
  runAsUser: 8978
  runAsGroup: 8978
  runAsNonRoot: true
  allowPrivilegeEscalation: false
  capabilities:
    drop: ["ALL"]

초기 접속

배포 후 ingress.hostname으로 설정한 URL에 브라우저로 접속한다. 최초 접속 시 관리자 계정(Administrator) 생성 화면이 표시된다.