GraphQL 을 하수라 데이터 전송 네트워크로 마이그레이션
이 페이지의 내용
중요
항상 MongoDB Atlas 와 Hasura 의 공식 문서를 참조하세요. 최신 정보와 정확한 정보를 제공합니다. 구체적인 단계는 프로젝트 의 세부 정보와 사용된 기술에 따라 달라질 수 있습니다.
개발자가 MongoDB에서 GraphQL 및 MongoDB API 를 빠르게 빌드 하고 배포 수 있도록 하수라 지원 및 기타 여러 데이터 소스 . 하수라는 API 개발 시간을 크게 단축함으로써 데이터에 빠르게 액세스 하고, 팀과 서비스 간의 마찰을 줄이며, 엔터프라이즈 이 데이터 기반 제품 및 기능의 출시 시간을 단축할 수 있도록 지원합니다.
시작하기 전에
아직 계정을 생성하지 않았다면 Hasura의 웹사이트 cloud.hasura.io에서 계정을 생성하세요.
하수라로 마이그레이션
MongoDB Atlas App Services 에서 Hasura로 GraphQL API 엔드포인트를 마이그레이션하는 작업은 Hasura에서 환경 설정, 데이터베이스 연결 구성, 스키마 마이그레이션, 권한 부여 및 인증 메커니즘 구현을 포함하는 여러 단계의 프로세스 를 포함합니다. 아래는 Hasura 내의 권한 부여 및 역할 기반 액세스 제어(RBAC)에 중점을 두고 각 단계를 자세히 설명하는 확장 가이드 입니다. 자세한 내용은 Hasura Docs 를 확인하세요.
Hasura로 마이그레이션하려면 다음을 수행합니다.
MongoDB에 Hasura 권한 부여
Hasura는 신규 또는 기존 MongoDB Atlas 데이터베이스에 연결하여 GraphQL API를 생성할 수 있습니다.
cloud.mongodb.com(으)로 Go 하여 Atlas 대시보드의 네트워크 액세스 페이지로 이동합니다.
ADD IP ADDRESS 버튼을 클릭하고 0.0.0.0/0 를 입력합니다. 이 항목을 Hasura로 설명합니다. 고유 IP 주소 는 Hasura 영업팀 에 문의 하세요. 비공개 DDN에 배포에 대해.
이제 하수라 클라우드는 MongoDB Atlas 인스턴스와 통신할 수 있습니다.
데이터베이스 페이지에서 Atlas 에 연결된 cluster를 찾아 을 App Services App Connect클릭합니다. 드라이버 옵션을 선택하고 연결 string 을 복사합니다.
새 프로젝트 를 생성하고 하수라에 연결합니다.
Hasura Docs 에는 다음 단계를 수행하기 위한 세부 정보가 포함되어 있습니다.
CLI 설치(필수 요건)
CLI 를 사용하여 로그인
새 슈퍼 그래프 초기화 빈 디렉토리 에
데이터에 연결
데이터 소스 인트로스펙션
로컬 슈퍼 그래프 구축
슈퍼 그래프 시작
Hasura cloud 프로젝트 만들기
슈퍼 그래프 빌드 및 배포
GraphQL 쿼리 테스트
Hasura 콘솔의 API 탐색기 페이지를 사용하여 일부 GraphQL 쿼리를 테스트할 수 있습니다.
또한 Hasura는 Atlas App Services에서 쿼리를 테스트하는 방법과 유사한 GraphiQL 인터페이스를 사용합니다.
권한 부여 및 인증
하수라는 인증을 직접 처리하지 않습니다. 대신 외부 인증 서비스에서 제공하는 세션 변수를 사용합니다. 이러한 세션 변수에는 데이터 액세스 권한을 결정하는 데 중요한 사용자, 역할 및 조직 정보가 포함됩니다. 자세한 내용은 Hasura 인증 를 참조하세요.Docs
역할 및 규칙 표현식을 포함한 데이터 액세스 권한은 Hasura 역할 기반 권한 규칙으로 변환할 수 있습니다.
Atlas 가 제공하는 모든 인증 방법은 Hasura의 Webhook 및 JSON 웹 토큰 인증 방법과 호환됩니다. 이메일/통과, 익명 또는 API 키 인증을 사용하는 경우 Hasura Webhook를 사용하세요. 사용자 지정 JSON 웹 토큰을 사용하는 경우 Hasura의 JSON web token auth 메서드와 직접 통합합니다.
보안 및 유연성 강화를 위해 인증 프로세스 관리에 외부 IdP를 사용할 것을 권장합니다. 인증0, Firebase 인증, Amazon Web Services Cognito 또는 사용자 지정 솔루션과 같이 원하는 인증 제공자와 Hasura를 통합하여 사용자를 확인하고 필요한 세션 변수를 설정할 수 있습니다. Hasura에서 JSON 웹 토큰 또는 웹훅 인증을 구성하는 방법은 다음 문서를 참조하세요.
사용자 지정 리졸버 또는 비즈니스 로직 설정
기존 GraphQL API 엔드포인트에 사용자 지정 리졸버 또는 비즈니스 로직이 포함된 경우, 이를 Hasura에서 구현 해야 합니다. 하수라는 다음을 지원합니다.
원격 스키마 GraphQL Connector를 통해
사용자 지정 쿼리 MongoDB 용 네이티브 쿼리를 통해
사용자 지정비즈니스 를 통한 로직 Typescript
클라이언트 애플리케이션 업데이트
GraphQL API 엔드포인트와 상호 작용 하는 모든 클라이언트 애플리케이션이 새로운 Hasura 엔드포인트 URL을 점 키도록 업데이트합니다. 기존의 모든 Apollo 클라이언트 는 Hasura와 함께 작동합니다. 애플리케이션 GraphQL 쿼리 및 변형을 Hasura 구문 및 스키마 에 맞게 리팩터링하여 새로운 GraphQL API 구조와의 호환성을 보장합니다.
MongoDB Atlas App Services Endpoints 종료
GraphQL API 엔드포인트가 완전히 마이그레이션되어 Hasura에서 작동하는지 확인한 후에는 불필요한 비용을 방지하기 위해 MongoDB Atlas App Services 앱을 삭제할 수 있습니다. 참고로 Atlas GraphQL 엔드포인트는 12, 2025 3월부터 더 이상 지원되지 않습니다.