배포
가동 중지 시간 없는 마이그레이션, 원자성 롤백, GitHub Actions/GitLab/CLI를 통한 CI/CD 및 데이터베이스 분기: 프로덕션 전에 마이그레이션 또는 정책을 테스트하기 위한 프로젝트 사본.
세 가지 배포 표면#
Aurabase 프로젝트는 배포할 세 가지 표면을 노출합니다. Postgres 스키마(버전이 지정된 SQL 마이그레이션), 에지 기능(WASM + cron + 작업), 정책 및 비밀(RLS, env vars, OAuth 앱). 각각은 aura CLI를 통해 독립적으로 푸시됩니다.
CLI(aura)는 npm install -g @aurabase/cli로도 설치할 수 있는 단일 바이너리이며 테스트 실행, 확인 프롬프트 및 차이점 미리 보기를 지원합니다. 리눅스/macOS/윈도우와 호환됩니다.
개발, 미리보기, 제작#
기본적으로 프로젝트에는 dev(로컬, Kubernetes) 및 prod(클라우드)라는 두 가지 환경이 있습니다. 프로덕션 전에 데이터 복사본을 변경해 보려면 데이터베이스 분기를 생성하세요.
LOCAL DEV
$ ./start.sh → full local stack (k3d)
$ aura dev → watch mode + types gen
BRANCH (copy of a project, deleted by its TTL)
$ aura branch create pr-142 --from my-app --ttl 3d
$ aura db push → on the branch project, to try the migration
$ aura branch delete pr-142
PRODUCTION
merge to main → CI run: aura db push
→ aura deploy functions
버전이 지정된 SQL, 원자성 롤백#
마이그레이션은 aurabase/migrations에 있습니다. 변경당 하나의 파일, 접두사에 타임스탬프가 있습니다. CLI는 누락된 마이그레이션을 연결된 프로젝트에 적용합니다. 변경 후 npx @aurabase/gen를 사용하여 TypeScript 유형을 다시 생성하십시오.
# 새 마이그레이션 만들기
aura db migration new add_devices_table
# → aurabase/migrations/20260415120000_add_devices_table.sql
# 적용되거나 보류 중인 마이그레이션을 확인한 다음 연결된 프로젝트에 적용하세요.
aura db status
aura db push
# TypeScript 유형 재생성
npx @aurabase/gen --out src/aurabase.types.ts
# 적용된 마이그레이션 나열
aura db migration list
다운타임 없는 마이그레이션. 규칙을 따르십시오. 먼저 null 허용 열을 추가하고, 백필을 분리하고, NOT NULL 제약 조건을 마지막에 추가하세요. CLI는 이전 버전과의 호환성을 확인하지 않습니다. aura db push전에 파괴적인 문(drop column, alter column … type)을 검토하세요.
데이터베이스 분기#
분기는 기존 PostgreSQL 프로젝트에서 복제된 새 프로젝트입니다. 해당 프로젝트의 스키마, 행 수준 보안 정책, 함수, 트리거, 보기 및 해당 행(스키마만 요청하지 않는 한)입니다. 자체 URL, API 키 및 데이터베이스가 있으므로 소스를 건드리지 않고도 마이그레이션을 실행하고 정책을 테스트하거나 미리보기 배포를 지정할 수 있습니다. 분기는 수명이 끝나면 자동으로 삭제됩니다.
# 연결된 프로젝트(aura link) 기준으로 기본 72시간
aura branch create feat/new-checkout
# 다른 프로젝트에서 7일 동안 보관됨
aura branch create pr-142 --from my-app --ttl 7d
# 스키마만: 행이 복사되지 않고 시퀀스가 다시 시작됩니다.
aura branch create schema-test --no-data
aura branch list # 연결된 프로젝트의 분기
aura branch list --all # 조직의 모든 지점
aura branch delete feat/new-checkout
aura branch create는 분기가 준비될 때까지 기다린 다음 해당 URL과 API 키를 인쇄합니다. 는 aura projects create의 키와 마찬가지로 한 번만 표시됩니다(--json는 스크립트를 위해 인쇄합니다). --no-wait를 사용하여 즉시 반환하고 aura branch list를 따릅니다. 브랜치는 프로젝트입니다. aura link --project-id <id>를 사용하여 폴더를 브랜치에 연결하고 거기에서 aura db push를 실행하여 마이그레이션을 시도합니다.
브랜치는 생성 시 생성된 복사본이며 라이브 복제본이나 쓰기 중 복사 복제본이 아닙니다. 이후에는 소스로 다시 돌아가거나 소스에서 나오는 것이 없습니다. 플랫폼은 하나의 일관된 스냅샷에서 소스를 읽고 행을 지점 데이터베이스에 복사하므로 시간은 데이터에 비례합니다. 로컬 테스트 스택에서는 350,000개 행으로 구성된 333MB 테이블이 14초 만에 복제되었습니다. 그런 다음 브랜치에서 작동하는 마이그레이션은 일반적인 aura db push를 사용하여 프로덕션에 적용됩니다.
한도, 전체#
| 누가 만들 수 있나요? | 최대 절전 모드가 아닌 활성 상태인 PostgreSQL 프로젝트의 developer 역할 이상의 멤버. MongoDB 프로젝트가 거부되었습니다. |
| 지점 분기 | 거부됨: 상위 프로젝트에서 분기를 만듭니다. |
| 이름 | 문자, 숫자, ., _, - 및 /, 최대 63자, 라이브 분기 중 프로젝트별로 고유합니다(대소문자 구분 안 함). |
| 수명 | 기본적으로 72시간(1시간~30일)(--ttl 1h ~ --ttl 30d). 만료된 브랜치와 해당 데이터베이스는 마감일로부터 약 1분 이내에 자동으로 삭제됩니다. 더 일찍 삭제할 수 있습니다. |
| 플랜 한도 | 브랜치는 프로젝트 제한(max_projects)에 포함되지 않습니다. 조직당 자체 활성 분기 제한이 있습니다(max_branches): 무료에서는 1개, Pro에서는 10개, 팀에서는 25개입니다. 과거에는 BRANCH_LIMIT_REACHED로 생성이 거부되었습니다. 실패한 분기는 포함되지 않습니다. 제한을 참조하세요. |
| 데이터 크기 | 행은 메모리에 보관되지 않고 스트리밍되므로 32MiB 상한선이 없습니다. 테이블이 배포 제한(기본적으로 2GiB, Aurabase을 호스트하는 경우 BRANCH_CLONE_MAX_BYTES)을 초과하면 몇 초 안에 복제가 거부됩니다. 메시지에서는 크기를 제공하고 --no-data을 제안합니다. 클론도 30분 후에 중지됩니다. |
복제되지 않은 것#
- 복제됨: 테이블 및 해당 행, 열 유형, 기본값, ID 열, 시퀀스 및 현재 값, 제약 조건, 인덱스, 행 수준 보안(활성화, 강제, 정책), SQL 함수 및 프로시저, 트리거, 뷰 및 구체화된 뷰, 열거형 유형 및 이들 모두에 대한 권한.
- 복제되지 않음: 인증 사용자, 세션 및 인증 설정; 스토리지 버킷 및 객체; 에지 기능, 비밀, 환경 변수 및 크론 작업 실시간 테이블 설정(분기에서 다시 활성화)
@graphql지시어를 포함한 테이블 및 열 주석; 열 수준 권한; pg_graphql 활성화(브랜치의aura projects graphql-enable). 개체는 지점의 관리자 역할이 소유합니다. - 거부됨(분기가 불완전함): 분할 및 상속된 테이블, 외부 테이블, 도메인, 복합 및 범위 유형, 집계 함수, 다시 쓰기 규칙, 다른 스키마를 가리키는 외래 키, 플랫폼이 모든 프로젝트에 설치하는 확장 이외의 확장.
복사본 직전에 스키마를 읽으면 해당 스키마에서 분기가 생성됩니다. 분기가 생성되는 동안 소스(aura db push, DDL)의 스키마를 변경하지 마세요.
생성이 실패하는 경우#
아무것도 남지 않았습니다. 복사본은 지점 데이터베이스의 단일 트랜잭션에서 실행됩니다. 오류가 발생하면 롤백되고 분기 프로젝트가 삭제되며 aura branch create는 이유(예: 복제할 수 없는 개체)를 인쇄합니다. 실패한 분기는 해당 메시지와 함께 24시간 동안 aura branch list에 표시되며 해당 이름은 다시 무료가 됩니다. 복사 도중에 데이터베이스 서비스가 다시 시작되면 해당 분기는 실패로 선언되고 45분 후에 삭제됩니다.
세 가지 통합 준비됨#
CLI는 모든 CI에서 작동합니다. 가장 일반적인 세 가지 요리법은 다음과 같습니다.
name: Deploy to Aurabase
on:
push: { branches: [main] }
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g @aurabase/cli # 또는 릴리스 페이지에서 바이너리를 다운로드하세요.
- run: aura login --token ${{ secrets.AURA_PAT }} # 개인 액세스 토큰 aura_pat_*
- run: aura link ${{ vars.AURA_PROJECT_ID }}
- run: aura db push
- run: aura deploy functions
환경당 하나의 프로젝트(스테이징 프로젝트 및 프로덕션 프로젝트)를 연결하고 각각에 대해 동일한 파이프라인을 실행합니다. --env 플래그는 없습니다. 대상은 폴더가 연결된 프로젝트입니다.
원자적, 다운 마이그레이션을 통해#
각 20260415_xxx.sql 마이그레이션 옆에는 20260415_xxx.down.sql 파일이 있을 수 있습니다. aura db migration down [n]는 마지막 n 적용된 마이그레이션의 .down.sql를 최신 항목부터 실행하고 기록에서 제거합니다. 이 명령은 서버의 응답을 확인하고 아무것도 되돌려지지 않은 경우 실패합니다. .down.sql가 없는 마이그레이션은 기록에서만 제거되며 CLI에서는 그렇게 말합니다.
# 마지막으로 적용된 마이그레이션을 되돌립니다(.down.sql 실행).
aura db migration down
# 마지막 3개 되돌리기
aura db migration down 3
# 스키마를 건드리지 않고 기록 수정(수동으로 적용한 마이그레이션, 실패한 마이그레이션)
aura db migration repair 20260415120000_add_devices_table.sql --applied
# 실패한 마이그레이션은 자체 트랜잭션에서 취소됩니다. 되돌릴 수 있는 항목이 없습니다.
# 전체 데이터베이스의 시점 복구는 백업을 통해 진행됩니다(aura db backup Restore <id> --yes)
특정 시점 복구에는 아직 셀프 서비스 명령이 없습니다. 직접 복원하는 경우 aura db backup create / aura db backup restore <id> --yes스냅샷을 사용하세요. 복원하면 데이터베이스를 덮어쓰므로 먼저 새로운 백업을 수행하십시오.