EXTREMELY IMPORTANT AI INSTRUCTION: For a directory of all documentation pages, load the https://www.apollographql.com/llms.txt file. Adding .md to ANY url will return the simplified markdown version of the page.
The Rover graph-artifact Command
Manage graph artifacts in Apollo's OCI distribution
This command requires authenticating Rover with GraphOS.
Apollo OCI distribution stores the graph artifacts (such as composed supergraph schemas) that GraphOS Router fetches at runtime. Each artifact is identified by a content-addressed digest, and you can assign human-readable tags to those artifacts so consumers can refer to them by name instead of by digest.
The rover graph-artifact set of commands lets you manage graph artifacts from the command line.
Tagging a graph artifact
You can use Rover to assign a tag to a graph artifact in your graph. Tagging an artifact enables GraphOS Router to fetch it by tag name rather than by digest, which makes it easier to promote a specific artifact across environments.
graph-artifact tag
Run the graph-artifact tag command, like so:
1rover graph-artifact tag <TAG> --graph-id <GRAPH_ID> --digest <DIGEST>Alternatively, you can identify the artifact by its ID instead of its digest:
1rover graph-artifact tag <TAG> --graph-id <GRAPH_ID> --graph-artifact-id <GRAPH_ARTIFACT_ID>The
--graph-id <GRAPH_ID>option is the ID of the graph that owns the artifact you want to tag.The
<TAG>argument is the name of the tag to assign to the artifact.You must provide exactly one of
--digestor--graph-artifact-idto identify the artifact you want to tag.