풀 요청당 데이터베이스 미리보기
브랜치는 자체 URL 및 API 키가 있는 프로젝트의 복사본입니다. CI에서 끌어오기 요청당 하나씩 생성하고 미리보기를 가리키며 병합 시 만료되거나 삭제되도록 합니다.
하나의 풀 요청 = 하나의 데이터베이스#
aura branch create는 자체 URL 및 API 키를 사용하여 PostgreSQL 프로젝트(스키마, 행 수준 보안 정책, 함수, 트리거, 보기 및 행)를 새 프로젝트에 복제합니다. 끌어오기 요청은 그곳에서 마이그레이션을 실행할 수 있으며 검토자는 소스 프로젝트에 대한 경합 없이 결과를 시험해 볼 수 있습니다. 복제되는 것과 복제되지 않는 것의 전체 목록과 제한은 데이터베이스 분기에 있습니다.
분기는 생성 시 데이터에 비례하여 생성된 복사본입니다(로컬 테스트 스택에서 333MB의 경우 14초). Copy-On-Write 복제가 아니며 이후에는 소스를 따르지 않습니다.
CI에서는#
설치할 GitHub 작업은 없습니다. CLI가 작업을 수행합니다. 개인 액세스 토큰(aura login --token)으로 인증한 다음 테스트하는 프로젝트에서 분기를 생성하고 미리보기에 필요한 것을 유지하세요. 각 조각을 파이프라인의 스크립트로 저장합니다.
aura login --token "$AURA_PAT"
aura branch create "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --ttl 3d --json > branch.json
# Branch.json: id, slug, url, anon_key, service_role_key,expires_at
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force
키는 분기가 생성될 때 한 번만 인쇄됩니다. 즉시 작업에(또는 미리보기 배포의 비밀로) 저장하세요. 브랜치에서 풀 요청의 마이그레이션을 실행하려면 폴더를 폴더에 연결하고 aura link --project-id <branch id>, aura db push를 푸시합니다.
aura branch 명령은 로컬 스택에 대해 실행되었습니다. aura login --token은 배포에서 CI 레시피의 로그인입니다. 이를 둘러싼 GitHub 또는 GitLab 워크플로는 여러분이 작성하는 것입니다.
지점에 포함된 내용#
분기에는 보유한 개인 데이터를 포함하여 소스 행(스키마에만 --no-data 추가)이 있으며 익명화가 없습니다. 미리 보기에 실제 데이터가 표시되지 않아야 하는 경우 프로덕션이 아닌 스테이징 프로젝트에서 분기를 만듭니다. 인증 사용자, 스토리지 개체, 에지 기능 및 비밀은 복제되지 않습니다. 미리보기 설정에 시드하세요.
TTL 및 할당량#
분기는 기본적으로 72시간, 최대 30일 동안 유지됩니다(--ttl). 만료된 분기는 자동으로 삭제되며 생성에 실패한 분기도 마찬가지입니다. 브랜치는 프로젝트 한도에 포함되지 않습니다. 이는 계획의 활성 분기 제한(무료의 경우 1개, Pro의 경우 10개, 팀의 경우 25개)에 포함됩니다. 제한을 참조하세요. 제한을 초과하면 aura branch create가 BRANCH_LIMIT_REACHED로 실패합니다. 분기를 삭제하거나 해당 TTL을 기다립니다.