Openclaw용 PostgreSQL Manager

컨테이너 영속성, 데이터베이스 생성 및 인스턴스 간 스냅샷을 포함한 공유 PostgreSQL Docker 수명 주기를 관리하기 위한 전문 도구입니다.

pereirajair
v1.0.2
May 10, 2026
0
782
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install postgres-manager

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 postgres-manager 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

PostgreSQL Manager란 무엇인가요?

PostgreSQL Manager는 로컬 개발 환경에서 데이터베이스 관리를 간소화하도록 설계된 Openclaw Skills 생태계 내의 강력한 솔루션입니다. PostgreSQL 16 Alpine 컨테이너의 수명 주기를 자동화하여, 명명된 Docker volume을 통해 세션 간 데이터가 유지되도록 보장하고 일반적인 관리 작업을 위한 간소화된 CLI를 제공합니다.

공유 Docker 네트워크에 참여함으로써 이 skill을 통해 여러 애플리케이션 컨테이너가 일관된 호스트 이름을 사용하여 중앙 데이터베이스 인스턴스와 통신할 수 있습니다. 수동 SQL 개입 없이 데이터베이스 인스턴스를 빠르게 시작, 스냅샷 또는 제거해야 하는 개발자를 위해 특별히 설계되었으며, Openclaw Skills 워크플로의 필수 구성 요소입니다.

PostgreSQL Manager 활용 사례

  • 여러 로컬 마이크로서비스 또는 프로젝트 작업 트리를 위한 중앙 집중식 PostgreSQL 서비스 구축.
  • 격리된 환경에서 새로운 기능을 테스트하기 위해 기본 데이터베이스의 즉각적인 스냅샷 생성.
  • 통합 CLI를 통한 로컬 데이터베이스 수명 주기(시작, 중지, 상태) 관리.
  • 임시 개발 브랜치를 위한 데이터베이스 생성 및 삭제 자동화.

PostgreSQL Manager 작동 원리

  1. 사용자가 proxy-manager를 통해 공유 네트워크를 시작하여 프로세스를 시작합니다.
  2. start 명령을 실행하면 Docker Compose가 고정된 PostgreSQL 16.4-alpine 이미지를 가져오고 영속적 volume을 생성합니다.
  3. 컨테이너가 외부 nginx-proxy_net 네트워크에 가입하여 다른 컨테이너가 codai_postgres 호스트 이름으로 접근할 수 있게 합니다.
  4. 개발자는 제공된 shell 래퍼를 사용하여 데이터베이스 생성이나 pg_dump를 사용한 인스턴스 간 덤프와 같은 관리 작업을 실행합니다.
  5. 모든 작업에는 데이터베이스 이름에 대한 엄격한 regex 검증이 포함되며, 데이터베이스 삭제와 같은 파괴적인 작업에는 대화형 확인이 필요합니다.

PostgreSQL Manager 설정 가이드

이 도구를 Openclaw Skills 환경에 통합하려면 다음 단계를 따르십시오:

# 1. proxy-manager가 실행 중인지 확인하여 공유 네트워크 생성
# 2. postgres-manager 디렉토리로 이동
cd postgres-manager

# 3. PostgreSQL 컨테이너 시작
./run.sh start

# 4. 상태 및 데이터베이스 목록 확인
./run.sh status

PostgreSQL Manager 데이터 스키마 및 분류 체계

이 skill의 환경 및 데이터 영속성은 다음과 같이 구성됩니다:

구성 요소 유형 설명
Docker Volume 영속적 컨테이너 수명 주기와 독립적으로 모든 PostgreSQL 데이터 파일을 저장합니다.
codai_postgres 컨테이너 공유 네트워크에서 실행되는 메인 서비스 인스턴스.
codai_main 데이터베이스 모든 스냅샷의 주요 진실 소스(source-of-truth) 데이터베이스.
구성 환경 POSTGRES_USER 및 POSTGRES_PORT(기본값 5433)와 같은 변수를 통해 관리됩니다.

PostgreSQL Manager 고급 기능

  • 소스 데이터베이스에서 대상 인스턴스로 데이터를 직접 덤프할 수 있는 인스턴스 간 스냅샷.
  • 자동화된 설정 스크립트 중 오류를 방지하기 위한 멱등성 데이터베이스 생성.
  • 127.0.0.1 포트 바인딩 및 덤프에 대한 shell 주입 방지를 포함한 엄격한 보안 기본값.
  • 종속 서비스가 시작되기 전에 데이터베이스가 완전히 초기화되었는지 확인하는 wait 명령을 통한 자동화된 준비 상태 확인.
  • 더 넓은 Openclaw Skills 제품군, 특히 proxy-manager 및 worktree-manager와의 원활한 통합.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*