Migrar GraphQL para WundGraph

Criar um aplicativo WnderGraph

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

Adicionar scripts npm

Adicione os seguintes scripts ao package.json, para que você possa executar o servidor WnderGraph.

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

Inicie o servidor WUnderGraph MongoDB

npm run start

Depois de iniciar o servidor, o WUnderGraph faz alguma geração de código. Verifique o status do servidor em http://localhost:9991.

Configurar Fonte de Dados do MongoDB Atlas

Você precisa configurar sua fonte de dados do MongoDB Atlas. Dentro do seu arquivo wundergraph.config.ts , adicione o seguinte:

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

Adicionar operações de query

Para trabalhar com seus dados do Atlas, você precisa adicionar operações de consulta. Navegue até a pasta operations e crie um novo arquivo GraphQL chamado Users.graphql e adicione o seguinte:

{
   Mongo_findFirstusers {
      id
      name
      email
   }
}

Navegue pelos dados com a interface do usuário do GraphyQL

Depois de executar o servidor WUnderGraph e adicionar operações de query, você pode usar a interface de usuário do GraphQL para explorar seus dados do Atlas por meio de uma API do GraphQL. Isso pode ser útil quando seu aplicativo estiver em desenvolvimento. Para aplicativos em produção, recomendamos o uso da interface JSON-RPC do WUnderGraph (consulte a próxima etapa).

1. Com seu servidor WUnderGraph em execução, navegue até http://localhost:9991/graphql.

2. Adicione estas queries à interface de usuário do GraphyQL:

   query Users {
      db_findManyusers {
         id
         name
         email
      }
   }

3. Clique no botão Executar.

Use a interface JSON-RPC do WUnderGraph para produção

O GrafiQL é bom para desenvolvimento, mas para a produção, você deve considerar usar a interface JSON-RPC do WUnderGraph para interagir com os dados do Atlas.

Resumindo, o WUnderGraph compila suas operações GraphQL em endpoints JSON-RPC que você pode chamar.

Depois de executar wunderctl up, o WUnderGraph verifica o diretório .wundergraph/operations para arquivos *.graphql e os processa. Para que isso funcione, cada arquivo deve conter exatamente uma Operação GraphQL.

Cada arquivo será compilado em um endpoint JSON-RPC. O nome do endpoint é determinado pelo nome do arquivo.

Aqui está um exemplo de consulta de API JSON-RPC:

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

Atualizar aplicativos do cliente

Atualize todos os aplicativos clientes que interagem com seus pontos de conexão da API GraphQL para apontar para as novas URLs de ponto do WUnderGraph.

Desligar os endpoints do Atlas App Services

Depois de verificar se os pontos de conexão da API GraphQL estão totalmente migrados e operacionais no WUnderGraph, você pode excluir seu aplicativo MongoDB Atlas App Services para evitar custos desnecessários. Lembre-se de que os endpoints do Atlas GraphQL não serão mais suportados a partir de 12 de março de 2025.