Launches

In GraphOS, a launch represents the complete process of applying a set of updates to a supergraph. Launches are usually triggered by making changes to one of your published subgraph schemas.

Updates that trigger a launch include:

• Adding, removing, or modifying types and fields in a subgraph schema
• Adding or removing entire subgraphs
• Migrating types or fields between subgraphs
• Modifying your
  cloud router's configuration
• Updating your federation version

A launch might consist entirely of changes that don't affect your supergraph's public API (such as migrating fields between subgraphs).

You can

Launch status

Your supergraph's Launches page in GraphOS Studio enables you to observe and monitor the schema delivery process for both in-progress and past launches:

The green PUBLISHED badge indicates which launch corresponds to your supergraph's current published schema.

Selecting a launch provides a breakdown of its individual steps and any errors or warnings that occurred during it:

From this detail view, you can view the timestamp and other details for each step in the launch process. You can also view the launch's associated supergraph schema (or any build errors if composition failed).

What's in a launch?

A GraphOS launch proceeds through the following steps:

Manually trigger launch

You can trigger a launch manually by calling the

For an example workflow using GraphOS Platform API to manually trigger a launch, see the