CLI aura — 전체 참조
공식 aura 바이너리를 사용하면 로컬 개발, Kubernetes, SQL 마이그레이션, 저장 기능, Edge Functions WASM, RLS, 저장소 및 인증 등 전체 Aurabase 플랫폼을 제어할 수 있습니다.
어디에서나 사용 가능한 독립 실행형 바이너리#
CLI는 독립형 Rust 바이너리입니다. 현재 macOS Apple Silicon의 NPM과 다른 모든 소스의 컴파일을 통해 설치됩니다. Linux, macOS Intel 및 Windows용 사전 컴파일된 바이너리 패키지는 아직 출시되지 않았습니다. npm install -g @aurabase/cli이 실패합니다. 이는 사용자 측의 오류가 아닙니다.
# 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 파이프라인에 개인 액세스 토큰을 사용할 수 있습니다.
# 대화형 로그인(브라우저 열기)
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을 실행하고, 테이블을 검사하고, 로그를 따라갈 수 있습니다.
# 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명령을 자동으로 탭하려면 셸에서 자동 완성을 활성화하세요.