rover

please see the latest release candidate

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

please see the latest release candidate

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

please see the latest release candidate

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

please see the latest release candidate

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

please see the latest release candidate

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

please see the latest release candidate

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

please see the latest release candidate

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

🐛 Fixes

• Fixes superfluous output in npm installer - @EverlastingBugstopper, #1200 fixes #1197 and #1198

  In 0.8.0, we released a fix for our npm installer that makes it compatible with yarn workspaces by reinstalling Rover if it doesn't exist. Unfortunately, that means that steps that rely on printing to stdout contained information about the installs in those invocations. This has been fixed.

📚 Documentation

• Adds documentation for the async checks feature introduced in 0.8.1 - @EverlastingBugstopper, #1193

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

🚀 Features

• Add new commands to use asynchronous checks API - @Y-Guo, #1139

  If you want to kick off a check without waiting for it to complete you can provide the --background flag to rover graph check or rover subgraph check. This will start the check in Apollo Studio. If your GitHub repo integrates with the Apollo Studio GitHub App, the check status will be updated on your GitHub branch. Using this flag can save you time and money with your CI provider.

• Improved error messages and logs for filesysten read/write - @EverlastingBugstopper, #1183

  Start using the saucer create for file system read/writes. This will provide better errors than the ones provided by std::fs e.g. permission denied os error (2) by providing context about which file rover is trying to read/write to. Every read/write/other filesystem operation will now be included in the --log info output.

🐛 Fixes

• Install rover before run if missing in npm package - @trevor-scheer, #1184 fixes #1178

• Don't retry 400 Bad Request errors - @EverlastingBugstopper, #1166

🛠 Maintenance

• Refactor command line argument parsing - @EverlastingBugstopper, #1155

• Improve schema downloading for codegen, when building rover - @EverlastingBugstopper, #1166

• Update rover to clap v3 - @EverlastingBugstopper, #1170 fixes #1165

• Add Apollo Studio integration tests - @EverlastingBugstopper, #1188

  We now run integration tests against Apollo Studio's platform API as part of our release pipeline.

📚 Documentation

• Update help message for rover subgraph introspect - @EverlastingBugstopper, #1169

  Previously the help message for rover subgraph introspect claimed to introspect from Apollo Studio Registry but it really introspects from a running subgraph endpoint.

• Add Jenkins CI/CD Documentation - @StephenBarlow, #1151

• Update, restructure, and add missing docs for existing rover commands - @StephenBarlow, #1154, #1157

• Update rover version in CI/CD docs - @rajington, #1177

• Fix broken anchors for fetching schema - @tchupp, #1176

🚀 Features

• Adds readme fetch and readme publish - @cy, #1128, #1141

  Adds support for fetching and publishing Apollo Studio graph variant READMEs with rover readme publish and rover readme fetch commands. Usage for these commands can be found by running rover readme --help and documentation can be found on our docs site.

🐛 Fixes

• Fix the endpoint rover-client uses to fetch Apollo Studio's GraphQL schema- @EverlastingBugstopper, #1126

  As of v0.6.0, Rover sends all Apollo Studio requests to the new public platform API. When this change was introduced, we changed where we issued our GraphQL requests, but did not update the build step that fetches the schema which could lead to mismatched types. This is now fixed, fields in the public platform API match codegen.

• Fix typo in the environment variable rover-client uses to fetch Apollo Studio's GraphQL schema - @EverlastingBugstopper, #1125
  s/APOLLO_GPAPHQL_SCHEMA_URL/APOLLO_GRAPHQL_SCHEMA_URL

📚 Documentation

• Schema checks are now free - @StephenBarlow, #1131

  Update the documentation to remove references to schema checks being a paid feature, since they are now free!

• Update ARCHITECTURE.md - @cy #1129

  Update and clarify a few points in ARCHITECTURE.md.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

Important: 1 breaking change below, indicated by ❗ BREAKING ❗

❗ BREAKING ❗

• Use Apollo's Platform API - @pcarrier, #1074

  Rover now uses Apollo's Platform API instead of the old Studio API. The breaking change is that the hostname is now api.apollographql.com where it used to be graphql.api.apollographql.com, you may need to update your firewall rules. Other behavior should remain unchanged.

🐛 Fixes

• Fixes Input Value Definition block string encoding for descriptions. - @lrlna, #1116 fixes #1088

  Input values are now multilined when a description is present to allow for a more readable generated SDL.

🛠 Maintenance

• Removes upper bound on Node engines for npm installer - @EverlastingBugstopper, #1120 fixes #1119

  Previously, Rover required that your node engine was between v14 and v17. We have removed the upper bound on this limit so you can now use Node 18 and any future versions.

• Adds cargo xtask docs - @EverlastingBugstopper, #1118

  Developers of the Rover project can now run cargo xtask docs to spin up a local netlify server with your local docset. After running the command, you can navigate to http://localhost:8000/rover in your browser and changes you make to ./docs/source/**.md files will be updated automatically on save.

• Updates dependencies - @renovate-bot, #1117

  node 16.14.2 -> 16.15.0
  npm 8.7.0 -> 8.8.0
  os_info 3.2 -> 3.3

• Removes unused dependencies - @EverlastingBugstopper, #1113

• Separate Studio client code from generalized GraphQL client code - @Geal, #1061

  Introduces the launchpad workspace crate which contains operations not specific to Apollo Studio such as:

  • launching GraphQL queries using reqwest
  • running an introspection query on a graph
  • transforming a JSON SDL to a schema

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

🚀 Features

• Default rover supergraph compose to Federation 2 if a @link directive is found in a subgraph schema - @EverlastingBugstopper, #1097 fixes #1090

  When running rover supergraph compose, if supergraph.yaml refers to a subgraph that contains an @link directive and you haven't set the federation_version key, then Rover will use Federation 2 composition by default.

• Output Federation version information when running rover supergraph compose - @EverlastingBugstopper, #1102

  When running rover supergraph compose, Rover will print the Federation version number that it is using. You can access this version string programatically by running the command with the --output json argument and accessing the federation_version field.

• Accept - as valid supergraph.yaml to read config from stdin - @EverlastingBugstopper, #1092 fixes #525

  You can now run commands like cat supergraph.yaml | rover supergraph compose --config - much like you've always been able to do with the --schema argument in other Rover commands.

🐛 Fixes

• Really fixes v0.5.2/v0.5.3 broken npm installs - @EverlastingBugstopper

  It turns out that it's hard to test changes to npm installers without actually publishing to npm. In order to save burning another patch version I released v0.5.4-rc.0 to ensure that my changes would actually fix things.

• Hides rover-fed2 from rover --help - @EverlastingBugstopper, #1091 fixes #1085

🛠 Maintenance

• Address Rust 1.60.0 lints - @EverlastingBugstopper, #1098

• Updates binary-install to v1.0.0 for the npm installer - @EverlastingBugstopper, #1099

📚 Documentation

• Fixes some broken Federation 2 links - @StephenBarlow, #1084

• Documents dynamic composition versions - @EverlastingBugstopper, #1087

note: the release notes for 0.5.2 have been copied here because 0.5.2 and 0.5.3 were both broken on npm

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

This was a test release. Please refer to v0.5.4.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

Sorry! This release did not work on npm. Please refer to v0.5.4. You can still download these binaries, they are functionally equivalent to v0.5.2 and v0.5.4.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

Sorry! This release did not work on npm. Please refer to v0.5.4. You can still download these binaries, they are functionally equivalent to v0.5.3 and v0.5.4.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

🐛 Fixes

• Return a hard error in CI when the ELv2 license is not accepted instead of hanging for eternity - @EverlastingBugstopper, #1082 fixes #1081

  If you ran rover supergraph compose with federation_version: 2 in CI - it would prompt you to accept the ELv2 license and hang waiting for the input for eternity. This is no longer the case and you will get a helpful error message detailing exactly what you need to do to never see the error again. For more details on the license, see our FAQ.

• Removes extraneous debug statement - @EverlastingBugstopper, #1079

  In my rush this morning I missed the removal of an eprintln statement. It's gone now.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

Important: X breaking changes below, indicated by ❗ BREAKING ❗

❗ BREAKING ❗

• rover-fed2 has been deprecated - @EverlastingBugstopper, #1058

  rover fed2 supergraph compose has been deprecated. You should instead set federation_version: 2 in your supergraph.yaml to use Federation 2 with the rover supergraph compose command.

🚀 Features

• rover supergraph compose optionally updates automatically - @EverlastingBugstopper, #1058 fixes #2046

  When running rover supergraph compose, Rover will automatically download the correct version of composition to use. In your supergraph.yaml files, you can specify federation_version: 1 or federation_version: 2 to always get the latest updates. You can pass the --skip-update flag to skip checking for an update. You can also specify an exact version if you'd like to pin your federation version, like so: federation_version: =2.0.0.

  Additionally, you can run rover install --plugin supergraph@latest-2 or rover install --plugin [email protected] to install a plugin ahead of time, which may be helpful in CI. For Federation 2, you'll have to accept the ELv2 license one time per machine. You likely want to set APOLLO_ELV2_LICENSE=accept in CI if you are using Federation 2.

• Adds --insecure-unmask-key to rover config whoami - @EverlastingBugstopper, #1043 fixes #1023

  Previously, running rover config whoami would output your entire API key to the terminal. This is not the documented behavior, and it is insecure because someone could be sharing their screen while trying to debug and accidentally leak their API key.

  Now, rover config whoami will mask your API key when it prints to the terminal. You can override this behavior by passing the --insecure-unmask-key flag.

• Retry on timeouts and connection errors - @ptondereau, #1014 fixes #790

  Rover will now automatically retry HTTP requests that fail due to timeouts or initial connection errors.

• Define an HTTP agent for non-studio requests - @ptondereau, #1075 fixes #961

  Rover now sends a User-Agent header along with all requests, not just requests to Apollo Studio.

• Adds support for HTTP(S) proxies in npm installer - @farawaysouthwest, #1067 fixes #899

  You can now install Rover from npm if you are behind a proxy.

🐛 Fixes

• Fixed a dead link in ARCHITECTURE.md - @ptondereau, #1053

🛠 Maintenance

• Simplify rover subgraph fetch query - @EverlastingBugstopper, #1056 fixes #992

  rover subgraph fetch now uses a much more efficient query that only requests a single subgraph at a time rather than all of them. Yay GraphQL!

• Upgrades apollo-encoder - @bnjjj, #1017 fixes #1010

📚 Documentation

• Set up new docs infrastructure - @trevorblades, #1051, #1052

  @trevorblades has done an awesome job setting up new docs for Apollo, including Rover! Check out the shiny new repo.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

🐛 Fixes

• Fix npm installer - @EverlastingBugstopper

see 0.5.0-rc.0 for the full release notes.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

Important: X breaking changes below, indicated by ❗ BREAKING ❗

❗ BREAKING ❗

• rover-fed2 has been deprecated - @EverlastingBugstopper, #1058

  rover fed2 supergraph compose has been deprecated. You should instead set federation_version: 2 in your supergraph.yaml to use Federation 2 with the rover supergraph compose command.

🚀 Features

• rover supergraph compose optionally updates automatically - @EverlastingBugstopper, #1058 fixes #2046

  When running rover supergraph compose, Rover will automatically download the correct version of composition to use. When you first install Rover, it will automatically download the latest composition function for Federation 1 and Federation 2. In your supergraph.yaml files, you can specify federation_version: 1 or federation_version: 2 to always get the latest updates. You can pass the --skip-update flag to skip checking for an update. You can also specify an exact version if you'd like to pin your composition function, like so: federation_version: =2.0.0-preview.9.

  Additionally, you can run rover install --plugin supergraph@latest-2 or rover install --plugin [email protected] to install a plugin ahead of time, which may be helpful in CI.

• Adds --insecure-unmask-key to rover config whoami - @EverlastingBugstopper, #1043 fixes #1023

  Previously, running rover config whoami would output your entire API key to the terminal. This is not the documented behavior, and it is insecure because someone could be sharing their screen while trying to debug and accidentally leak their API key.

  Now, rover config whoami will mask your API key when it prints to the terminal. You can override this behavior by passing the --insecure-unmask-key flag.

• Retry on timeouts and connection errors - @ptondereau, #1014 fixes #790

  Rover will now automatically retry HTTP requests that fail due to timeouts or initial connection errors.

🐛 Fixes

• Fixed a dead link in ARCHITECTURE.md - @ptondereau, #1053

🛠 Maintenance

• Simplify rover subgraph fetch query - @EverlastingBugstopper, #1056 fixes #992

  rover subgraph fetch now uses a much more efficient query that only requests a single subgraph at a time rather than all of them. Yay GraphQL!

📚 Documentation

• Set up new docs infrastructure - @trevorblades, #1051, #1052

  @trevorblades has done an awesome job setting up new docs for Apollo, including Rover! Check out the shiny new repo.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

🐛 Fixes

• Properly pin harmonizer versions - @EverlastingBugstopper, #1039

  0.4.7 accidentally released [email protected] instead of preview.7 because of semver. Versions are now pinned properly.

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.