GraphQL을 WunderGraph로 마이그레이션

WunderGraph 애플리케이션 만들기

# Init a new project
npx create-wundergraph-app my-project --example simple
# Move to the project directory
cd my-project
# Install dependencies
npm i

npm 스크립트 추가

다음 스크립트를 package.json 에 추가하여 WunderGraph 서버를 실행할 수 있도록 합니다.

{
   "scripts": {
      "start": "wunderctl up --debug",
      "build": "wunderctl generate"
   }
}

WunderGraph MongoDB 서버 시작

npm run start

서버를 시작한 후 WunderGraph는 몇 가지 코드 생성을 수행합니다. http://localhost:9991 에서 서버 상태를 확인합니다.

MongoDB Atlas 데이터 소스 구성

MongoDB Atlas 데이터 소스를 구성해야 합니다. wundergraph.config.ts 파일 내에 다음을 추가합니다.

const Atlas = introspect.mongodb({
   apiNamespace: 'my_db',
   databaseURL: 'YourAtlasURL',
});
configureWunderGraphApplication({
   apis: [Atlas],
});

쿼리 작업 추가

Atlas 데이터로 작업하려면 쿼리 작업을 추가해야 합니다. operations 폴더로 이동하여 Users.graphql 라는 새 GraphQL 파일을 만들고 다음을 추가합니다.

{
   Mongo_findFirstusers {
      id
      name
      email
   }
}

GraphiQL UI로 데이터 찾아보기

WunderGraph 서버를 실행하고 쿼리 작업을 추가한 후에는 GraphiQL 사용자 인터페이스를 사용하여 GraphQL API를 통해 Atlas 데이터를 탐색할 수 있습니다. 이는 앱을 개발 중일 때 유용할 수 있습니다. 프로덕션 앱의 경우 WunderGraph의 JSON-RPC 인터페이스를 사용하는 것이 좋습니다(다음 단계 참조).

1. WunderGraph 서버가 실행 중인 상태에서 http://localhost:9991/graphql 로 이동합니다.

2. GraphiQL 사용자 인터페이스에 다음 쿼리를 추가합니다.

   query Users {
      db_findManyusers {
         id
         name
         email
      }
   }

3. 재생 버튼을 클릭합니다.

프로덕션에 WunderGraph의 JSON-RPC 인터페이스 사용

GraphiQL은 개발에는 유용하지만 프로덕션 환경에서는 WunderGraph의 JSON-RPC 인터페이스를 사용하여 Atlas 데이터와 상호 작용하는 것을 고려해야 합니다.

즉, WunderGraph는 GraphQL 작업을 호출할 수 있는 JSON-RPC 엔드포인트로 컴파일합니다.

wunderctl up 를 실행한 후 WunderGraph는 .wundergraph/operations 디렉토리에서 *.graphql 파일을 확인하고 처리합니다. 이 작업을 수행하려면 각 파일에 정확히 하나의 GraphQL 작업이 포함되어야 합니다.

각 파일은 JSON-RPC 엔드포인트로 컴파일됩니다. 엔드포인트의 이름은 파일 이름에 따라 결정됩니다.

다음은 JSON-RPC API 쿼리의 예시입니다.

curl http://localhost:9991/operations/Users

클라이언트 애플리케이션 업데이트

GraphQL API 엔드포인트와 상호 작용하는 모든 클라이언트 애플리케이션이 새로운 WunderGraph 엔드포인트 URL을 가리키도록 업데이트합니다.

Atlas App Services 엔드포인트 종료

GraphQL API 엔드포인트가 완전히 마이그레이션되어 WunderGraph에서 작동하는지 확인한 후에는 불필요한 비용을 방지하기 위해 MongoDB Atlas App Services 앱 삭제 수 있습니다. 참고로 Atlas GraphQL 엔드포인트는 9월 30 부터 더 이상2025 지원되지 않습니다.