Migra GraphQL a WunderGraph

Crea una aplicación 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

Agregar scripts npm

Agregue los siguientes scripts a package.json, para que puedas ejecutar el servidor WunderGraph.

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

Start the WunderGraph Server

npm run start

Tras iniciar el servidor, WunderGraph genera código. Compruebe el estado del servidor en http://localhost:9991.

Configurar la fuente de datos Atlas de MongoDB

Necesita configurar su fuente de datos MongoDB Atlas. Dentro del archivo wundergraph.config.ts, agregue lo siguiente:

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

Agregar operaciones de consulta

Para trabajar con sus datos Atlas, necesita agregar operaciones de consulta. Vaya a la carpeta operations, cree un nuevo archivo GraphQL llamado Users.graphql y agregue lo siguiente:

{
   Mongo_findFirstusers {
      id
      name
      email
   }
}

Browse Data with the GraphiQL UI

After you get your WunderGraph server running and add query operations, you can use the GraphiQL user interface to explore your Atlas data through a GraphQL API. This can be useful when your app is in development. For apps in production, we recommend using WunderGraph's JSON-RPC interface (see next step).

1. Con el servidor WunderGraph en ejecución, navegue a http://localhost:9991/graphql.

2. Agregue estas consultas a la interfaz de usuario de GraphiQL:

   query Users {
      db_findManyusers {
         id
         name
         email
      }
   }

3. Haga clic en el botón Reproducir.

Utiliza la Interfaz JSON-RPC de WunderGraph para Producción

GraphiQL es bueno para el desarrollo, pero en producción debería considerar usar la interfaz JSON-RPC de WunderGraph para interactuar con sus datos Atlas.

En resumen, WunderGraph compila sus operaciones GraphQL en puntos finales JSON-RPC que puede llamar.

Después de ejecutar wunderctl up, WunderGraph verifica en el directorio .wundergraph/operations los archivos *.graphql y los procesa. Para que esto funcione, cada archivo debe contener exactamente una operación GraphQL.

Cada archivo se compilará en un endpoint JSON-RPC. El nombre del endpoint se determina por el nombre del archivo.

A continuación se muestra un ejemplo de consulta API JSON-RPC:

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

Actualizar aplicaciones del cliente

Actualice todas las aplicaciones cliente que interactúan con sus puntos finales de API GraphQL para que apunten a las nuevas URL de puntos finales de WunderGraph.

Cerrar los Endpoints de Atlas App Services

Una vez que haya verificado que sus puntos de conexión de la API GraphQL están completamente migrados y operativos en WunderGraph, puede eliminar su aplicación MongoDB Atlas App Services para evitar costos innecesarios. Le recordamos que los puntos de conexión Atlas GraphQL dejarán de ser compatibles a partir del de septiembre 30 2025de.