Workshop overview

Learn how graph implementations can be scaled across multiple teams and complex development environments. Using Apollo GraphOS Enterprise, we'll sample a big menu of the latest features, including: auth, subscriptions, coprocessors, safelisting operations and more!

What you'll learn

• Authentication and authorization
• Federated subscriptions
• Coprocessors
• Operation limits
• Persisted queries and safelisting
• Schema update proposals
• Caching

Who this workshop is for

API developers who have a basic understanding of GraphQL Federation.

• Workshop slides

What we're building

KBT Threads has been a successful brick and mortar store dating back to 1972 with a focus on outdoor sports and adventure clothing. While KBT Threads has a long successful history, we have been struggling against our more digital-native competitors. We have invested in several digital channels including web, iOS and Android apps, and store pick-up options.

To support these new channels in a performant and scalable way, we have been building GraphQL and a supergraph in our pre-production environments. We have spent time testing and validating this strategy and a decision has been made that this will be our go-forward API strategy.

Leadership is excited to move forward and wants to migrate this graph to the production environment and immediately begin routing traffic to it.

We, the engineering team, have pushed back on moving to production immediately. This graph is functional, but it is not production-ready. We have work to do to ensure that our graph is secure, performant, and scalable for all the use cases here at KBT Threads. It is now up to us to get this graph production-ready!

Getting started

Step 1: Create a Github repo

1. Login to GitHub.

2. Open up the workshop repository. This is the graph we will be hardening for this workshop.

3. Select "Create a new repository", as shown below:

   

4. In the Create new repository setting, make sure these fields are set correctly:

   • Create the new repository in the Summit-Enterprise-Workshop. If you don't see this organization, please ask for help.
   • The workshop is set to Public.

   Watch out! I don't see Summit-Enterprise-Workshop organization on Github

   You may have not accepted the invitation to join the workshop organization. Follow the steps to do so:

   1. Go to your Github Profile > Your organization

   2. You should see an invite to the organization (if you don't see an invite, please contact one of the workshop support members)

   3. Click on "Accept"

      github.com

      

   4. Click on Join Summit Enterprise Workshop

      github.com

      

   5. You should now be a part of the organization

      github.com

      

5. Name your repository with the following name format: <githubid>-graph.

6. Click "Create your repository".

Editing files in GitHub

To keep things simple for this workshop, we recommend that you perform all edits directly in GitHub. To edit a file, navigate to that file and click the pencil icon in the top right corner.

Once you're done editing a file, click the "Commit changes..." button.

Step 2: Login to GraphOS

We're using GraphOS to build, manage and evolve our supergraph. GraphOS Studio is the web UI we'll be using to interact with our graph.

• If you don't have an Apollo account yet, you'll be prompted to create one.

• If you are an existing Apollo customer, you will need to join with an email address not associated with your company's SSO login. Open the link in an incognito window and create a separate account using your personal email.

Step 3: Query your graph

If the previous 2 steps were successful, you should see a graph in the Studio organization named with your GitHub ID.

1. Find your graph and star ⭐️ the current variant so you can find it easily next time.

   

2. Click on your graph.

   

3. Navigate to the Explorer in the main navigation.

4. Run the default ExampleQuery operation:

   Example Query

   query ExampleQuery {
     users {
       id
     }
   }

   Copy

If the query returns data, we are now ready to begin! 🙌 🎉

Up next

In the next section, we will be looking at how operation limits can help limit the type and shape of operations will be allowed on our graph.