본문으로 건너뛰기
아우라베이스 로고
아우라베이스

CLI aura — 전체 참조

공식 aura 바이너리를 사용하면 로컬 개발, Kubernetes, SQL 마이그레이션, 저장 기능, Edge Functions WASM, RLS, 저장소 및 인증 등 전체 Aurabase 플랫폼을 제어할 수 있습니다.

레퍼런스12분 읽기레벨 참조2026. 8. 19.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

어디에서나 사용 가능한 독립 실행형 바이너리#

CLI는 독립형 Rust 바이너리입니다. 현재 macOS Apple Silicon의 NPM과 다른 모든 소스의 컴파일을 통해 설치됩니다. Linux, macOS Intel 및 Windows용 사전 컴파일된 바이너리 패키지는 아직 출시되지 않았습니다. npm install -g @aurabase/cli이 실패합니다. 이는 사용자 측의 오류가 아닙니다.

terminalbash
# 1. NPM — 현재 macOS Apple Silicon만 해당
npm install -g @aurabase/cli
aura --help

# 2. 소스에서 — 모든 플랫폼(Rust 1.7x+)
git clone https://github.com/Aurabase-cloud/Aurabase.git
cargo install --path Aurabase/aura-cli
#    ~/.cargo/bin에 `aurabase` 바이너리를 설치하세요.
aurabase --help

CLI 인증#

콘솔 계정으로 로그인하거나 CI/CD 파이프라인에 개인 액세스 토큰을 사용할 수 있습니다.

terminalbash
# 대화형 로그인(브라우저 열기)
aura login

# 비대화형 연결(이메일/비밀번호)
aura login --email dev@example.com --password "secret"

# 개인 액세스 토큰을 통한 연결(GitHub Actions/GitLab CI에 이상적)
aura login --token aura_pat_9a8b7c6d5e4f...

# 계정 및 활성 프로젝트 확인
aura whoami

모듈별 철저한 참조#

aura 바이너리가 지원하는 모든 명령과 하위 명령을 찾으십시오.

프로젝트 설정 및 관리

프로젝트 초기화, 연결 및 진단

  • aura init — 새 Aurabase 프로젝트(구조, 구성, 도커)를 초기화합니다.
  • aura login [--email <email>] [--password <pass>] [--token <pat>] — 콘솔 계정에 로그인하거나 개인 액세스 토큰을 사용하여 로그인합니다.
  • aura register [--email <email>] [--password <pass>] — 새로운 Aurabase 콘솔 개발자 계정을 생성합니다.
  • aura logout — 활성 로컬 세션의 연결을 끊습니다.
  • aura whoami — 로그인한 사용자, 해당 조직 및 활성 프로젝트를 표시합니다.
  • aura link --project-id <uuid> — 현재 디렉터리를 기존 클라우드 프로젝트에 연결합니다.
  • aura status — 프로젝트 상태, 연결 및 서비스 상태를 표시합니다.
  • aura doctor — 로컬 환경(Docker, 포트, 시스템 도구)을 진단합니다.

지역 발전

로컬 스택 관리(Kubernetes/k3d) 및 로그

  • aura start — k3d에서 모든 Aurabase 로컬 마이크로서비스를 시작합니다.
  • aura stop — k3d 클러스터 및 로컬 서비스를 중지합니다.
  • aura restart — 로컬 서비스를 다시 시작합니다.
  • aura dev — 지속적인 개발 모드: 마이그레이션을 모니터링하고 유형을 동기화합니다.
  • aura studio — 브라우저에서 로컬 Studio 인터페이스를 엽니다(localhost:3000).
  • aura logs [-s <service>] [--since 1h] [--tail 100] — 서비스(aura-auth, aura-db, Gateway...)별로 통합되거나 필터링된 로그를 표시합니다.
  • aura connect — 프로젝트의 직접 PostgreSQL 엔드포인트에서 대화형 psql 터미널을 엽니다(psql은 aura db connection --new-password에서 발급한 비밀번호를 요청합니다)

조직 및 클라우드 프로젝트

조직 및 프로젝트의 다중 테넌트 관리

  • aura orgs list [--json] — 귀하가 회원으로 속해 있는 조직을 나열합니다.
  • aura orgs create --name <name> --slug <slug> — 새 클라우드 조직을 만듭니다.
  • aura orgs use <slug> — 주문의 기본 조직을 설정합니다.
  • aura projects list [--org <slug>] [--json] — 조직의 프로젝트를 나열합니다.
  • aura projects create <name> [--engine postgres|mongodb] [--org <slug>] — 새 프로젝트 프로비저닝
  • aura projects delete <id> — 프로젝트 및 해당 데이터를 영구적으로 삭제합니다.
  • aura projects api-keys [--project-id <id>] — 프로젝트의 API 키(anon, service_role)를 표시합니다.
  • aura projects rename <id> <name> — 기존 프로젝트의 이름을 바꿉니다.
  • aura projects retry <id> — error에서 프로젝트 프로비저닝을 다시 실행하고 준비되면 해당 URL과 키를 인쇄합니다.
  • aura projects graphql-enable <id> [--wait] — 프로젝트에서 GraphQL 확장(pg_graphql)을 활성화합니다.
  • aura projects graphql-config <id> [--introspection on|off] [--max-rows N] [--inflect-names on|off] [--wait] — pg_graphql 설정을 표시하거나 변경합니다(플래그 없이 적용되는 설정을 인쇄합니다).

데이터베이스 분기(Aura 분기)

분기는 PostgreSQL 프로젝트에서 복제된 새 프로젝트로, 자체 URL과 키가 있으며 TTL이 끝나면 삭제됩니다. 제한 사항과 복제되는 내용은 데이터베이스 분기을 참조하세요.

  • aura branch create <name> [--from <project id|slug|name>] [--org <slug>] [--ttl 72h|3d|2w] [--no-data] [--no-wait] [--json] [--timeout <s>] — 링크된 프로젝트(또는 --from)의 분기를 생성하고 준비될 때까지 기다린 다음 해당 URL과 API 키를 한 번 인쇄합니다. --ttl는 1시간에서 30일(기본값 72시간)로 변경됩니다. --no-data는 스키마만 복사합니다.
  • aura branch list [--from <project>] [--all] [--json] — --all을 사용하여 프로젝트 분기 또는 전체 조직을 나열합니다. 실패한 지점은 이유와 함께 24시간 동안 목록에 유지됩니다.
  • aura branch delete <name> [--from <project>] [--force] — 지점 및 해당 데이터베이스를 삭제합니다.

데이터베이스 및 마이그레이션(aura db)

스키마 관리, 동기화, 푸시/풀 및 SQL 쿼리

  • aura db push — 보류 중인 로컬 SQL 마이그레이션을 적용합니다(+ 연결된 경우 클라우드 동기화).
  • aura db pull — 원격 스키마를 검색하고 로컬 스키마를 업데이트합니다.
  • aura db diff [--name <name>] — 원격 스키마를 로컬과 비교하고 SQL 마이그레이션을 생성합니다.
  • aura db status [--json] — 적용된 마이그레이션 및 보류 중인 마이그레이션의 자세한 상태를 표시합니다.
  • aura db watch — 스키마 변경 사항을 모니터링하고 실시간으로 동기화합니다.
  • aura db reset [--force] — 로컬 데이터베이스를 처음부터 제거하고 다시 생성합니다(확인 요청, 스크립트의 경우 --force).
  • aura db seed — 테스트 데이터를 로드하기 위해 seed.sql 스크립트를 실행합니다.
  • aura db generate [--lang ts|rust] — TypeScript(기본값) 또는 Rust 데이터베이스 유형 정의를 생성합니다.
  • aura db extensions list [--json] / aura db extensions enable <name> — 설치된 확장을 나열하거나 허용된 확장을 활성화합니다.
  • aura db inspect <indexes|tables|locks> [--json] — 인덱스 사용량(사용되지 않은 항목 플래그 지정), 테이블 크기 및 데드 행, 차단 잠금
  • aura db slow-queries [--limit <n>] [--json] — pg_stat_statements를 통해 가장 느린 SQL 쿼리를 나열합니다.
  • aura db stats [--json] — 연결 통계 및 데이터베이스 디스크 사용량을 표시합니다.
  • aura db connection [--new-password] [--yes] [--json] — 직접 PostgreSQL 액세스(psql, Prisma, Drizzle, pg_dump): 호스트, 포트, 데이터베이스 및 역할 --new-password를 사용하면 비밀번호를 발행하고(한 번만 표시되고 명확하게 저장되지 않으며 이전 비밀번호를 취소함) 전체 연결 문자열을 인쇄합니다.
  • aura db raw "<sql>" [--params <p1> <p2>] [--dry-run] [--read-only] [--json] — 시뮬레이션 및 읽기 전용 옵션을 사용하여 직접 SQL 쿼리를 실행합니다.
  • aura db migration new <name> — 타임스탬프가 지정된 새 SQL 마이그레이션 파일을 생성합니다.
  • aura db migration list [--json] — 모든 프로젝트 마이그레이션 및 해당 상태를 나열합니다.
  • aura db migration down [n] — 마지막으로 적용된 n개의 마이그레이션을 취소합니다(기본값: 1).
  • aura db migration repair <file> [--applied|--reverted] — 프로젝트의 마이그레이션 기록에서 마이그레이션을 적용 또는 취소된 것으로 수동으로 표시합니다(동일한 기록 aura db status 및 migration list 읽기).

RLS 테이블 및 정책(aura db 테이블/정책)

선언적 생성, RLS, 실시간 CDC 및 권한

  • aura db table list [--json] — 공개 스키마 테이블을 해당 열 및 유형과 함께 나열합니다.
  • aura db table create <name> "<cols>" — 테이블을 생성합니다(예: "제목:텍스트,태그:텍스트[],임베딩:벡터(1536)")
  • aura db table drop <name> [-f] — 테이블 및 해당 제약 조건을 삭제합니다.
  • aura db table rls <name> <on|off> — 테이블에서 행 수준 보안 보호를 활성화 또는 비활성화합니다.
  • aura db table realtime <name> <on|off> — 테이블에 실시간 CDC 게시를 활성화 또는 비활성화합니다.
  • aura db policy list [--table <name>] [--all] [--json] — 테이블에 정의된 RLS 보안 정책을 나열합니다(--all에는 내부 스토리지 규칙이 포함됨).
  • aura db policy add <table> <name> <cmd> [--using-expr <expr>] [--check-expr <expr>] — 새로운 RLS 정책(SELECT, INSERT, UPDATE, DELETE 또는 ALL)을 생성합니다.
  • aura db policy update <table> <name> [--using-expr <expr>] [--check-expr <expr>] — 위반하지 않고 규칙의 USING / WITH CHECK 표현식을 수정합니다.
  • aura db policy delete <table> <name> [-f] — RLS 보안 규칙을 삭제합니다.

Postgres SQL 함수 및 트리거(aura db 함수/트리거)

PL/pgSQL 저장 프로시저 및 테이블 트리거

  • aura db function list [--json] — 스키마의 Postgres 함수를 나열합니다(이름, 인수, 보안, 권한).
  • aura db function create <name> [--body <sql>|--body-file <f>] [--returns <t>] [--language plpgsql|sql] [--args <a:t>] [--security invoker|definer] [--grant-execute-to <roles>] — 엄격한 액세스 제어로 저장된 SQL 함수를 생성하거나 대체합니다.
  • aura db function drop <name> [-f] — Postgres SQL 함수 삭제
  • aura db trigger list <table> [--json] — 테이블의 모든 트리거를 나열합니다.
  • aura db trigger create <table> <name> --function <fn> [--timing before|after|instead_of] --events insert,update [--for-each row|statement] — 트리거 함수를 테이블 이벤트에 바인딩합니다.
  • aura db trigger drop <table> <name> [-f] — 테이블에서 트리거 삭제

백업 및 API 키(aura db 백업/api-keys)

액세스 토큰의 스냅샷, 복원 및 관리

  • aura db backup list [--json] — 데이터베이스의 수동 및 자동 백업을 나열합니다.
  • aura db backup create [--label <label>] — 데이터베이스의 즉각적인 스냅샷을 생성합니다.
  • aura db backup restore <id> [--verify-only] [--yes] — --yes (또는 --force)는 스크립트 및 CI에 필요한 확인을 건너뜁니다. 지정된 스냅샷에서 데이터베이스를 복원합니다.
  • aura db backup download <id> [-o <path>] — 백업의 전체 SQL 덤프 다운로드
  • aura db backup delete <id> [-f] — 백업 아카이브를 삭제합니다.
  • aura db backup schedule get [--json] — 구성된 자동 백업 일정을 참조합니다.
  • aura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable] — 백업 빈도 및 보존 기간을 구성합니다.
  • aura db apikeys list [--json] — 프로젝트와 연결된 활성 API 키를 나열합니다.
  • aura db apikeys create <name> [--scope anon|authenticated|service_role] — 특정 역할을 가진 새 API 키를 생성합니다.
  • aura db apikeys revoke <id> [-f] — API 키를 즉시 취소합니다.

인증 및 사용자(aura auth)

계정, 세션, 감사 로그 및 이메일 템플릿 관리

  • aura auth users list [--json] — 프로젝트에 등록된 사용자를 나열합니다.
  • aura auth users create [--email <email>] [--password <pass>] [--json] — 비밀번호를 사용하여 새 사용자를 생성합니다(스크립트의 경우--json는 생성된 사용자를 id와 함께 인쇄합니다).
  • aura auth users delete <id> [-f] — 사용자를 영구적으로 삭제합니다.
  • aura auth users ban <id> — 사용자를 금지하고 활성 세션을 취소합니다.
  • aura auth users unban <id> — 사용자 금지 해제
  • aura auth sessions list [--json] — 활성 JWT 세션 나열
  • aura auth audit-log [--limit 50] [--json] — 보안 감사 로그 및 연결 시도 보기
  • aura auth settings get [--json] — 인증 구성 표시(OAuth, MFA, 시간 초과)
  • aura auth settings set KEY=VALUE... — 인증 설정 업데이트
  • aura auth email-templates list [--json] — 이메일 템플릿 목록(확인, 재설정, 매직 링크)
  • aura auth email-templates get <type> — 템플릿의 HTML/텍스트 소스 코드를 표시합니다.
  • aura auth email-templates reset <type> [-f] — 템플릿을 기본값으로 재설정합니다.

엣지 기능 WASM 및 비밀(아우라 기능/비밀)

Edge 기능 및 암호화된 환경 변수 배포

  • aura functions new <name> — 새로운 Edge Function의 뼈대를 생성합니다.
  • aura functions deploy <name> — WASM 바이너리로 컴파일하고 함수를 글로벌 네트워크에 배포합니다.
  • aura functions list [--json] — 로컬 및 배포된 기능을 해당 상태와 함께 나열합니다.
  • aura functions logs <name> — 함수의 실시간 로그 스트림을 표시합니다.
  • aura functions serve — 기능에 대한 로컬 테스트 서버를 시작합니다.
  • aura functions invoke <name> [--data '<json>'] — 페이로드와 함께 배포된 함수 호출 및 테스트
  • aura functions download <name> — 원격 함수의 소스 코드 다운로드
  • aura functions delete <name> [-f] — 배포된 Edge 기능을 삭제합니다.
  • aura secrets list --function <name> [--json] — 함수에 대해 구성된 비밀 변수를 나열합니다.
  • aura secrets set --function <name> KEY=VALUE... — 함수에 삽입된 암호화된 비밀을 정의합니다.
  • aura secrets unset --function <name> KEY... — 함수에서 하나 이상의 비밀을 제거합니다.

객체 스토리지(오라 스토리지)

버킷 관리 및 파일 전송

  • aura storage ls [path] — 폴더의 버킷 또는 파일을 나열합니다.
  • aura storage cp <src> <dst> — 파일 전송(로컬 ← 버킷)
  • aura storage rm <path> — 버킷에 저장된 파일을 삭제합니다.
  • aura storage mb <name> [--public] — 새 버킷을 생성합니다(기본적으로 비공개 또는 공개).
  • aura storage buckets list [--json] — 프로젝트의 모든 스토리지 버킷을 나열합니다.
  • aura storage buckets create <name> [--public] — 스토리지 버킷을 생성합니다.
  • aura storage buckets delete <name> [-f] — 버킷을 삭제하고 해당 객체를 모두 제거합니다.

지역 환경 및 유틸리티

.env 변수, TUI 인터페이스, 자동 업데이트 및 자동 완성

  • aura env list [--json] — 로컬 .env에 정의된 변수를 표시합니다.
  • aura env set KEY=VALUE... — 로컬 .env에 하나 이상의 변수를 설정합니다.
  • aura env unset KEY... — 로컬 .env 파일에서 변수 제거
  • aura ui — 완전한 대화형 TUI(터미널 사용자 인터페이스)를 시작합니다.
  • aura update — CLI를 자동으로 확인하고 최신 안정 버전으로 업데이트합니다.
  • aura completions <bash|zsh|fish|powershell|elvish> — 쉘에 대한 자동 완성 스크립트를 생성합니다.

터미널의 대화형 인터페이스#

Aurabase는 Ratatui에서 제공하는 텍스트 모드 인터페이스(aura ui)를 통합합니다. 이를 통해 터미널을 떠나지 않고도 데이터베이스를 탐색하고, SQL을 실행하고, 테이블을 검사하고, 로그를 따라갈 수 있습니다.

terminalbash
# TUI 인터페이스 실행
aura ui

전역 옵션 및 설정#

  • --json — 구조화된 JSON 출력(스크립팅, jq 및 CI/CD 자동화에 이상적)
  • --dry-run — 데이터를 변경하지 않고 제약 조건을 검증하기 위해 마지막에 롤백된 트랜잭션에서 명령을 실행합니다.
  • --read-only — Postgres 엔진에서 트랜잭션을 읽기 전용으로 엄격하게 잠급니다.
  • -f, --force — 파괴적인 작업에 대한 대화형 확인 요청을 무시합니다.
  • --project-id <uuid> — 로컬 연결 파일을 무시하고 특정 원격 프로젝트를 대상으로 합니다.
팁


aura completions zsh > ~/.zfunc/_aura 또는 aura completions bash > /etc/bash_completion.d/aura명령을 자동으로 탭하려면 셸에서 자동 완성을 활성화하세요.

더 나아가려면#