Skip to content

Latest commit

 

History

History
95 lines (62 loc) · 2.86 KB

DEVELOPMENT.md

File metadata and controls

95 lines (62 loc) · 2.86 KB
Raw

Development

The Apollo Router is a configurable, high-performance graph router for a federated graph:

Crates

  • configuration - Config model and loading.
  • query planner - Query plan model and a caching wrapper for calling out to the nodejs query planner.
  • execution - Converts a query plan to a stream.
  • server - Handles requests, obtains a query plan from the query planner, obtains an execution pipeline, returns the results

Binaries

  • router - Starts a server.

Development

You will need a recent version of rust (1.63 works well as of writing). Installing rust using rustup is the recommended way to do it as it will install rustup, rustfmt and other goodies that are not always included by default in other rust distribution channels:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Set up your git hooks:

git config --local core.hooksPath .githooks/

Getting started

Use cargo build --all-targets to build the project.

Some tests run against the existing Node.js implementation of the Apollo Router. This requires that the federation-demo project is running.

First, initialize and update required git submodules.

git submodule init
git submodule update

Then, start the service:

docker-compose up -d

Note: -d is for running into background. You can remove -d if you have issues and you want to see the logs or if you want to run the service in foreground.

Run Apollo Router against the docker-compose or Node.js setup

Once the subgraphs are up and running, run Apollo Router with this command:

cargo run --release -- -s ./examples/graphql/local.graphql -c examples/telemetry/jaeger.router.yaml

Go to https://studio.apollographql.com/sandbox/explorer to make queries and http://localhost:16686/ to reach Jaeger.

Strict linting and license compliance

While developing locally doc warnings and other lint checks are disabled. This limits the noise generated while exploration is taking place.

When you are ready to create a PR, run a build with strict checking enabled, and check for license compliance.

Use cargo xtask all to run all of the checks the CI will run.

The CI checks require cargo-deny and cargo-about which can both be installed by running:

  • cargo install cargo-deny
  • cargo install cargo-about

They also need you to have the federation-demo project up and running, as explained in the Getting started section above.

Troubleshoot

  • If you have an issue with rust-analyzer reporting an unresolved import about derivative::Derivative check this solution found in a rust-analyzer issue.

Project maintainers

Apollo Graph, Inc.