Skip to Content
Testing관리되는 데이터베이스

관리되는 데이터베이스

가용성

관리형 Postgres는 not available yet입니다. 현재 데이터베이스 서비스는 제어 영역 미리 보기입니다. 요청을 검증하고, 메타데이터를 기록하고, 일회성 자격 증명 형태를 생성하고, DATABASE_URL를 게시할 수 있지만 라우팅할 수 없는 호스트 stub-shared-pg-01.local를 반환합니다. 데이터베이스 서버, 테넌트, 스키마, 백업 또는 복구 지점을 생성하지 않습니다.

상태가 stub인 레코드에는 애플리케이션을 연결하지 마십시오. 성공적인 API 응답을 스토리지가 존재한다는 증거로 취급하지 마십시오.

오늘 테스트할 수 있는 것

미리보기는 계획된 계약에 대한 통합을 테스트하는 데 유용합니다.

  • 앱 소유권은 MCP 래퍼로 확인됩니다.
  • 데이터베이스 기록을 생성하고 나열할 수 있습니다.
  • 생성된 비밀번호는 이후의 메타데이터 읽기에 의해 반환되지 않습니다.
  • DATABASE_URL는 생산자 토큰이 구성될 때 앱 환경 생산자에게 전달될 수 있습니다. 그리고
  • 앱은 반환된 데이터베이스 참조를 기록합니다.

자리표시자 URL을 게시해도 사용할 수 없습니다. 실제 배포 전에 앱 환경에서 제거하세요.

MCP 도구

도구현재 행동
add_app_database(app_id, engine='postgres')stub 레코드를 생성합니다. 자리 표시자 DATABASE_URL를 게시할 수 있습니다.
list_app_databases(app_id)메타데이터만 반환합니다. 비밀번호를 반환하지 않습니다.

다른 작업을 수행하기 전에 반환된 상태를 확인하세요.

add_app_database(app_id='app-12345678', engine='postgres')
{ "db_id": "db-a1b2c3d4e5f6", "engine": "postgres", "status": "stub", "env_published": false, "publish_skipped_reason": "OPENFACTORY_DB_PRODUCER_TOKEN is not configured" }

정확한 응답에는 일회성 연결 필드도 포함될 수 있습니다. 미리 보기에서는 스텁 호스트를 가리키며 실제 워크로드에 대한 자격 증명으로 사용하면 안 됩니다.

REST 계약

플랫폼 측 경로는 다음과 같습니다.

방법경로결과
POST/api/app-infra/databases미리보기 기록을 생성하고 일회성 연결 형태의 데이터를 반환합니다.
GET/api/app-infra/databases/{db_id}비밀번호 없이 메타데이터를 반환합니다.
GET/api/app-infra/databases?app_id={app_id}선택적으로 앱별로 필터링된 메타데이터를 나열합니다.

이러한 하위 수준 경로는 주로 내부 통합을 위한 것입니다. 플랫폼 자체를 개발하지 않는 한 소유자 범위 MCP 도구를 선호합니다.

관리형 Postgres를 호출할 수 있기 전에 준비됨

프로덕션 가능 릴리스에는 다음 모두에 대한 증거가 필요합니다.

  1. 연결 가능한 Postgres 서비스 및 실제 테넌트 프로비저닝
  2. 앱 간의 네트워크 격리;
  3. 자격 증명 순환 및 프로비저닝 해제
  4. 측정된 복구 결과를 사용한 백업 및 복원 훈련
  5. 자원 제한, 모니터링 및 오류 경고; 그리고
  6. 데이터를 쓰고, 재배포하고, 다시 읽는 엔드투엔드 애플리케이션 테스트.

해당 검사가 대상 환경에서 통과될 때까지 자체 데이터베이스를 가져와 실제 연결 문자열을 앱 환경 변수에 배치하세요.