3. Registering our schema
2m

📝 Let's register our schema!

The first step of getting our app into production is registering our with Apollo.

Let's go to Apollo Studio in the browser. You'll need an Apollo account set up with an organization.

In previous courses, we've tested our locally running graph using Sandbox. This helped us easily prototype and iterate on our changes. To register a deployed in production, we need to create a deployed graph, which integrates with the . A deployed graph is visible to all members of your organization.

Graphs!
Sandbox is a 
 
 environment where we can explore and test a GraphQL schema. To register a 
 
schema and track our changes over time, we can create a
 
 in Apollo Studio, which is visible to
 
.

Drag items from this box to the blanks above

  • the whole organization

  • production

  • development

  • the whole world

  • deployed graph

  • destructible graph

📈 Creating a graph

Note: Depending on when you created your account and what plan you're on, your Studio account might look a bit different than what we're showing in the video or lesson instructions.


Before continuing with the lesson, expand the section below to find your specific steps on how to create a graph.


Give it a title. Select Monolith as the graph architecture, then click Next.

https://studio.apollographql.com
Screenshot of the modal for creating a new graph with the correct inputs

From here, we have a few ways to register our , but we'll focus on the first option: Apollo Server. This method uses a protocol called reporting, where our GraphQL server automatically registers its latest every time it starts up! To enable this, we need to set up the three environment s shown on the page:

APOLLO_KEY=service:xxxxx
APOLLO_GRAPH_REF=xxxxxx
APOLLO_SCHEMA_REPORTING=true

Note: We used to have separate s for APOLLO_GRAPH_ID and APOLLO_GRAPH_VARIANT, but those have now been combined into a single environment : APOLLO_GRAPH_REF. (Under the hood, the structure of the graph reference is really <APOLLO_GRAPH_ID>@<APOLLO_GRAPH_VARIANT>.)

How does Apollo Server automatically register its schema in production?

We'll use these environment s when we get our GraphQL server into production!

Previous
Next

Share your questions and comments about this lesson

Your feedback helps us improve! If you're stuck or confused, let us know and we'll help you out. All comments are public and must follow the Apollo Code of Conduct. Note that comments that have been resolved or addressed may be removed.

You'll need a GitHub account to post below. Don't have one? Post in our Odyssey forum instead.