Create - WunderGraph

Usage

npx wgc federated-graph create <name> -r <routing-url> --label-matcher <labels...>

Description

The npx wgc federated-graph create command allows you to create a new federated graph on the Cosmo platform’s control plane. Federated graphs provide a mechanism to combine multiple subgraphs into a unified schema, enabling efficient, scalable, and distributed GraphQL APIs. With this command, you can create a federated graph and specify the routing URL for your router and the labels used to select the subgraphs to be federated.

Parameters

• <name>: The name of the federated graph you want to create. Replace <name> with the desired name for your federated graph.

Required Options

-r , --routing-url: The routing URL of your router. This URL defines the endpoint where the router will be accessible. The federated graph will be accessible through this router.

--label-matcher <labels...>: The labels used to select the subgraphs to be federated. Labels are passed in the format <key>=<value> <key>=<value>, where each <key>=<value> pair represents a label key and its corresponding value. The federated graph will include the subgraphs that match the specified labels.

--readme: The path to the markdown file which describes the federated graph. The readme can be used to communicate the information of the federated graph to other team members.

Options

• -n, --namespace : The namespace of the federated graph (Default: “default”).
• -r, --routing-url :The routing url of your router. This is the url that the router will be accessible at.
• --admission-webhook-url <url>: The base url of the admission webhook. This is the url that the control plane will use to implement admission control for the federated graph. Example: https://admission.example.com (without the /validate-config path name)
• --admission-webhook-secret: Allows you to sign requests (HMAC) made to your admission webhook url. The header containing this signature is X-Cosmo-Signature-256
• --label-matcher [labels...] : The label matcher is used to select the subgraphs to federate. The labels are passed in the format <key>=<value>, and grouped using commas. Example: --label-matcher team=A,team=B env=prod
• --readme: The markdown file which describes the federated graph.
• --suppress-warnings: This flag suppresses any warnings produced by composition.

Examples

npx wgc federated-graph create production -r http://router.example.com/graphql --label-matcher team=A department=backend

Create a federated graph named “production” with a routing URL of http://router.example.com/graphql and federate subgraphs with labels team=A and department=backend.

Notes

• The npx wgc federated-graph create command interacts with the Cosmo platform’s control plane to create the specified federated graph.
• The routing URL of the router should be accessible by the federated graph to handle incoming queries and route them to the appropriate subgraphs.