Apollo Connectors 소개와 사용법

$ curl -sSL https://rover.apollo.dev/nix/latest | sh

$ rover init
No credentials found. Please go to https://studio.apollographql.com/user-settings/api-keys and create a new Personal API key.

Copy the key and paste it into the prompt below.
>

$ rover init
No credentials found. Please go to https://studio.apollographql.com/user-settings/api-keys and create a new Personal API key.

Copy the key and paste it into the prompt below.

· ********
✓ Successfully saved your API key.

$ rover init

Welcome! This command helps you initialize a federated graph in your current directory.

To learn more about init, run `rover init -h` or visit https://www.apollographql.com/docs/rover/commands/init

? Select option: Create a new graph
? Select an organization: DaleSchool
? Select use case: Start a graph with one or more REST APIs
? Name your graph: My API
Confirm or modify graph ID (start with a letter and use only letters, numbers, and dashes): my-api-zi31vaf

==> You’re about to create a local directory with the following files:

- .idea/.gitignore
- .idea/graphql-settings.xml
- .vscode/extensions.json
- README.md
- connectors_debugger.png
- getting-started.md
- products.graphql
- supergraph.yaml

? Proceed with creation? [Y/n]
y

✓ Successfully created files and generated GraphOS credentials.

=> All set! Your graph `My API` has been created. Please review details below to see what was generated.

Files created:
✓ .idea/.gitignore
✓ .idea/graphql-settings.xml
✓ .vscode/extensions.json
✓ README.md
✓ connectors_debugger.png
✓ getting-started.md
✓ products.graphql
✓ supergraph.yaml

GraphOS credentials for your graph
✓ APOLLO_GRAPH_REF=my-api-zi31vaf@current (Formatted graph-id@variant, references a graph in the Apollo GraphOS platform)
✓ APOLLO_KEY=service:my-api-zi31vaf:VyShE1SH6WbGYch12SZhcg (This is your graph’s API key)

▲ Before you proceed:
- Store your graph API key securely, you won’t be able to access it again!

Next steps
Run the following command to start a local development session:

APOLLO_KEY=service:my-api-zi31vaf:VyShE1SH6WbGYch12SZhcg rover dev --graph-ref my-api-zi31vaf@current --supergraph-config supergraph.yaml

For more information, check out `getting-started.md`.

{
  "products": [
    {
      "id": 1,
      "name": "Lunar Rover Wheels",
      "createdAt": 1636742972000,
      "updatedAt": 1636742972000,
      "description": "Designed for traversing the rugged terrain of the moon, these wheels provide unrivaled traction and durability. Made from a lightweight composite, they ensure your rover is agile in challenging conditions.",
      "slug": "lunar-rover-wheels",
      "tags": [
        { "tagId": "space", "name": "Space" },
        { "tagId": "engineering", "name": "Engineering" },
        { "tagId": "rover", "name": "Rover" }
      ],
      "category": "Engineering Components",
      "availability": "AVAILABLE"
    }
    // (... 생략 ...)
  ],
  "summary": { "total": 30 }
}

extend schema
  # Apollo Federation 스펙을 사용한다고 명시합니다.
  @link(url: "https://specs.apollo.dev/federation/v2.10")

  # @connect와 @source 지시문을 불러옵니다.
  @link(
    url: "https://specs.apollo.dev/connect/v0.1"
    import: ["@connect", "@source"]
  )

  # @source 지시문으로 REST API를 데이터 소스로 정의할 수 있습니다.
  @source(
    name: "ecomm"
    http: { baseURL: "https://ecommerce.demo-api.apollo.dev/" }
  )

type Product {
  id: ID!
  name: String
  description: String
}

type Query {
  products: [Product]
    # @connect 지시문은 GraphQL 필드나 타입에 REST API 엔드포인트를 연결합니다.
    @connect(
      source: "ecomm"
      http: { GET: "/products" }
      selection: """
      $.products {
        id
        name
        description
      }
      """
    )
}

$ APOLLO_KEY=service:my-api-zi31vaf:VyShE1SH6WbGYch12SZhcg \
  rover dev --graph-ref my-api-zi31vaf@current --supergraph-config supergraph.yaml

** Notice: Changes in This Release! **
This version includes significant updates to the `rover dev` command.
We highly recommend reviewing the updated documentation to ensure a smooth experience.
Read more: https://www.apollographql.com/docs/rover/commands/dev

warning: Do not run this command in production! It is intended for local development only.

merging supergraph schema files
supergraph config loaded successfully
starting a session with the 'products' subgraph
==> Watching /Users/daleseo/temp/my-graph-z4j7yc/products.graphql for changes
composing supergraph with Federation 2.10.0
==> Attempting to start router at http://localhost:4000.
WARN: setting resource attributes is not allowed for Apollo telemetry
==> Health check exposed at http://127.0.0.1:8088/health
WARN: Connector debugging is enabled, this may expose sensitive information.
==> Your supergraph is running! head to http://localhost:4000 to query your supergraph