Apollo Federation update documentation

hey folks, I’ve been trying to look up info on this without much success. could anyone point me to relevant documentation on upgrading Apollo Federation version?

I’ve noticed I’ll need a feature that is covered from Apollo Federation v2.7 onwards, but a lot of my subgraphs have v2.0 in the schema federation @link e.g:

extend schema
    @link(
      url: "https://specs.apollo.dev/federation/v2.0"
      import: ["@key", "@shareable", "@override"]
    )

in my main apollo os interface I see Federation v2.4 in bold. any help is much appreciated!

Hello :waving_hand:

We recommend following update order:

  1. You need to update router first to ensure that it can support latest federation features*.
  2. You can then compose your supergraph using latest federation version.
  3. Finally you can upgrade your individual subgraphs to use latest features.

Keep in mind that you don’t need to upgrade all subgraphs all at once. You can upgrade subgraphs individually as needed.

Thanks,
Derek

*there are also other reasons keep your router up to date which includes getting latest security fixes and performance improvements.