GraphQL federation은 마이크로서비스에서 어떻게 동작하나요?

Question

IT Interview Practice · Accepted Answer

**Federation**은 독립적으로 배포된 여러 서비스가 각각 하나의 graph의 일부를 소유하게 하고, **gateway**가 이를 클라이언트가 쿼리하는 단일 schema로 합성합니다. 이는 gateway가 원격 schema를 수동으로 병합하던 **schema stitching**의 현대적 대체재입니다 — federation은 병합 규칙을 subgraph 자체로 옮깁니다.

## 아키텍처

```text
                 ┌────────────────────────┐
   Client ─────▶ │  Gateway / Router      │  (composed supergraph)
                 └───────┬────────┬───────┘
                         │        │  plans + fans out sub-queries
              ┌──────────▼──┐  ┌──▼──────────┐  ┌──────────────┐
              │ Users svc    │  │ Reviews svc │  │ Products svc │
              │  type User   │  │  extends    │  │  type Product│
              │  @key(id)    │  │  User/Prod  │  │  @key(id)    │
              └──────────────┘  └─────────────┘  └──────────────┘
```

각 서비스는 **subgraph**입니다. 하나의 타입은 한 서비스가 소유하고 다른 서비스들이 **확장(extend)**합니다. `@key` directive는 서비스 전반에서 엔티티를 식별하는 필드를 지정합니다.

```graphql
# Users subgraph OWNS User
type User @key(fields: "id") {
  id: ID!
  name: String!
}

# Reviews subgraph EXTENDS User with fields it owns
type User @key(fields: "id") {
  id: ID! @external          # declared elsewhere; referenced here by key
  reviews: [Review!]!        # this subgraph contributes this field
}
```

쿼리가 여러 서비스에 걸치면 gateway는 이를 **계획(plan)**합니다: Users에서 `User`를 가져오고, 그다음 `{ id }`와 함께 Reviews subgraph의 **entity resolver**(`__resolveReference`)를 호출하여 `reviews`를 채웁니다.

```js
// Reviews subgraph resolves the User reference the gateway hands it
const resolvers = {
  User: {
    __resolveReference: (ref, ctx) => ctx.reviewLoader.load(ref.id),
  },
};
```

## Federation vs stitching

Stitching은 병합 로직을 gateway에 집중시킵니다(취약하고, gateway가 모두를 알아야 함). Federation은 소유권을 **분산**합니다: 팀은 자신의 subgraph를 독립적으로 진화시키고, 합성은 CI에서 검증됩니다. 그 대가는 더 복잡한 gateway/router와 서비스 간 query planning입니다.

## 왜 중요한가

규모가 커지면 한 팀이 모놀리식 schema를 소유할 수 없습니다. 면접관은 여러분이 **`@key`를 통한 엔티티 소유권, reference resolver, query planning**을 이해하는지 — 그리고 federation이 단순한 기술적 우아함이 아니라 조직적 확장 측면에서 왜 stitching을 능가하는지 — 를 보고 싶어 합니다.

아키텍처

Federation vs stitching

왜 중요한가

관련 질문