Rover contract commands
For use with GraphOS contract variants
GraphOS contracts enable you to create variants of a supergraph that filter out schema elements according to inclusion and exclusion rules:
The rover contract command set enables you to interact with your existing contracts and create new ones.
Publishing a contract to GraphOS
contract publish
This command requires authenticating Rover with GraphOS.
You can use Rover to publish a new contract or publish configuration changes to an existing contract.
Run the contract publish command, like so:
rover contract publish my-graph@my-contract-variant \--source-variant my-source-variant \--include-tag foo \--include-tag bar \--exclude-tag baz \--hide-unreachable-types
The argument my-graph@my-contract-variant in the example above is a graph ref that specifies the ID of the graph you're publishing to, along with which contract variant you're creating or modifying.
If this contract variant already exists in the graph registry, its configuration is updated. Otherwise, a new contract variant is created.
Options include:
| Name | Description |
|---|---|
| The name of the source variant to use for supergraph schema filtering. The source variant must belong to the same graph as the contract variant. It must also be a federated variant with subgraphs. If your graph uses Federation 1, you must enable its support for the Required the first time you publish a contract. Optional after your first publish. If provided, it must match the value provided for the first publish (the source variant for a particular contract variant can't change). |
| A tag name to include when filtering. To include multiple tag names, specify
To specify an empty include list, provide Every tag name must:
One of |
| Specifies an empty include list for the published contract. One of |
| A tag name to exclude when filtering. To exclude multiple tag names, specify
To specify an empty exclude list, provide Every tag name must:
One of |
| Specifies an empty exclude list for the published contract. One of |
| If provided, the contract automatically hides types that are unreachable from the contract schema's root fields. One of |
| If provided, the contract does not automatically hide types that are unreachable from the contract schema's root fields. One of |
| Optional. If provided, this command does not trigger a launch in GraphOS after updating the contract configuration. |
Fetching contract details
contract describe
This command requires authenticating Rover with GraphOS.
You can use Rover to fetch the configuration of any contract variant that Rover has access to.
Run the contract describe command, like so:
rover contract describe my-graph@my-contract-variant
The argument my-graph@my-contract-variant in the example above is a graph ref that specifies the ID of the GraphOS graph you're fetching from, along with which contract variant you're fetching.
This command prints a summary of the contract's configuration, including its source variant and include/exclude lists:
Fetching description for configuration of my-graph@my-contract-variant using credentials from the default profile.Configuration Description:Contract variant "my-graph@my-contract-variant" is derived from the source variant "my-graph@my-source-variant".Included tags:- "foo"- "bar"Excluded tags:- "baz"Unreachable types are automatically hidden.View the variant's full configuration at https://studio.apollographql.com/graph/my-graph/settings/variant?variant=my-contract-variant