Migra GraphQL a WunderGraph

Crear 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"
   }
}

Iniciar el servidor WunderGraph

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
   }
}

Explorar datos con la interfaz de usuario de GraphiQL

Después de ejecutar su servidor WunderGraph y agregar operaciones de consulta, puede usar la interfaz de usuario de GraphiQL para explorar sus datos Atlas mediante una API de GraphQL. Esto puede ser útil cuando su aplicación está en desarrollo. Para aplicaciones en producción, recomendamos usar la interfaz JSON-RPC de WunderGraph (ver siguiente paso).

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.

Utilice 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.

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

Cada archivo se compilará en un punto final JSON-RPC. El nombre del punto final se determina a partir del nombre del archivo.

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

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

Actualizar aplicaciones 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.