Make your supergraph more discoverable through your Internal Developer Platform. Enable your engineering teams to onboard easily, explore existing subgraphs, and spin up new ones. In this workshop, we'll go through hands-on activities using Backstage to illustrate general principles where GraphQL and IDPs shine together.

What you'll learn

• How to enhance graph discoverability within your organization using IDPs for better team collaboration and onboarding
• How to create, manage, and deploy new subgraphs by integrating GraphQL with IDPs for scalability and consistency.

Who this workshop is for

• Platform engineers familiar with Backstage or similar IDPs.

Workshop resources

• Workshop slides PDF
• Workshop companion

⚠️ Before the workshop...

If you have any questions or run into any issues with the workshop prep below, scroll to the end of this page to leave a comment or send us an email at summit@apollographql.com. We're here to help!

You will need to do the following:

You will also need:

Download the GraphOS Router

1. Open up a terminal window and create a new directory for the workshop in your local environment.

2. Run the command below to download the latest version of GraphOS Router.

   curl -sSL https://router.apollo.dev/download/nix/latest | sh

   Copy

3. Run the command below to start the router.

   ./router

   Copy

4. You'll get the output similar to below:

   Apollo Router <version> // (c) Apollo Graph, Inc. // Licensed as ELv2 (https://go.apollo.dev/elv2)
   
   ⚠️  The Apollo Router requires a composed supergraph schema at startup. ⚠️
   
   👉 DO ONE:
   
     * Pass a local schema file with the '--supergraph' option:
   
         $ ./router --supergraph <file_path>
   
     * Fetch a registered schema from GraphOS by setting
       these environment variables:
   
         $ APOLLO_KEY="..." APOLLO_GRAPH_REF="..." ./router
   
         For details, see the Apollo docs:
         https://www.apollographql.com/docs/federation/managed-federation/setup
   
   🔬 TESTING THINGS OUT?
   
     1. Download an example supergraph schema with Apollo-hosted subgraphs:
   
       $ curl -L https://supergraph.demo.starstuff.dev/ > starstuff.graphql
   
     2. Run the router in development mode with the supergraph schema:
   
       $ ./router --dev --supergraph starstuff.graphql

   Copy

You're good to go!